feat: add shared rehearsal contract baseline

ARCHITECTURE.md

@@ -93,6 +93,7 @@ Last updated: 2026-03-11
 - GitHub-facing setup is staged: no-git -> local-git -> GitHub-connected -> protected-branches with required checks.
 - Shared contracts live in `packages/shared-types` so the UI can evolve without importing Python internals.
 - Shared contracts should ultimately model section, role, cue, confidence, and export artifacts explicitly enough that desktop UI and analysis outputs do not invent their own parallel schemas.
+- The current shared-types baseline includes a rehearsal-domain fixture that exercises section, role, cue, confidence, provenance, and export-summary fields in the desktop shell before the full analysis pipeline lands.
 - Product and UX decisions should prefer rehearsal-first simplicity while still maintaining high analytical accuracy.
 - Security decisions should prefer allowlisted narrow capabilities over generic convenience APIs.
 

apps/desktop/package.json

@@ -8,7 +8,7 @@
     "build": "vite build",
     "lint": "eslint \"src/**/*.{ts,tsx}\" vite.config.ts",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run --coverage"
+    "test": "node -e \"require('node:fs').mkdirSync('coverage/.tmp', { recursive: true })\" && vitest run --coverage"
   },
   "dependencies": {
     "@bandscope/shared-types": "0.1.0",

apps/desktop/src/App.test.tsx

@@ -2,11 +2,19 @@ import { render, screen } from "@testing-library/react";
 import { App } from "./App";
 
 describe("App", () => {
-  it("shows the harness status and supported formats", () => {
+  it("shows the shared rehearsal overview", () => {
     render(<App />);
 
     expect(screen.getByRole("heading", { name: /BandScope Bootstrap/i })).toBeInTheDocument();
     expect(screen.getByText(/wav, mp3, flac, m4a/i)).toBeInTheDocument();
+    expect(screen.getByRole("heading", { name: /Late Night Set/i })).toBeInTheDocument();
+    expect(screen.getByRole("heading", { name: /Verse 1/i })).toBeInTheDocument();
+    expect(screen.getByText(/Bass Guitar/i)).toBeInTheDocument();
+    expect(screen.getByText(/Keyboard 1 Right Hand/i)).toBeInTheDocument();
+    expect(screen.getByText(/Lead Vocal/i)).toBeInTheDocument();
+    expect(screen.getByText(/Section confidence: Needs ear check \(Auto-detected\)/i)).toBeInTheDocument();
+    expect(screen.getAllByText(/harmony source: Auto-detected/i)).toHaveLength(3);
+    expect(screen.getByText(/manual override: C#m11 \(User-confirmed\)/i)).toBeInTheDocument();
     expect(screen.getByText(/Home baseline is wired/i)).toBeInTheDocument();
   });
 });

apps/desktop/src/App.tsx

@@ -1,4 +1,8 @@
-import { SUPPORTED_AUDIO_FORMATS } from "@bandscope/shared-types";
+import { useMemo } from "react";
+import {
+  createDemoRehearsalSong,
+  SUPPORTED_AUDIO_FORMATS
+} from "@bandscope/shared-types";
 import { ChordsFeature } from "./features/chords";
 import { HomeFeature } from "./features/home";
 import { PlayerFeature } from "./features/player";
@@ -8,6 +12,16 @@ import { createTranslator, detectPreferredLocale } from "./i18n";
 
 export function App() {
   const t = createTranslator(detectPreferredLocale());
+  const rehearsalSong = useMemo(() => createDemoRehearsalSong(), []);
+  const confidenceLabels = {
+    low: t("confidenceLevelLow"),
+    medium: t("confidenceLevelMedium"),
+    high: t("confidenceLevelHigh")
+  } as const;
+  const provenanceLabels = {
+    model: t("provenanceSourceModel"),
+    user: t("provenanceSourceUser")
+  } as const;
 
   return (
     <main>
@@ -16,6 +30,36 @@ export function App() {
       <p>
         {t("supportedFormats")}: {SUPPORTED_AUDIO_FORMATS.join(", ")}
       </p>
+      <section>
+        <h2>{rehearsalSong.title}</h2>
+        <p>{rehearsalSong.exportSummary.headline}</p>
+      </section>
+      {rehearsalSong.sections.map((section) => (
+        <section key={section.id}>
+          <h3>{section.label}</h3>
+          <p>{section.groove}</p>
+          <p>
+            {t("sectionConfidence")}: {confidenceLabels[section.confidence.level]} ({provenanceLabels[section.confidence.source]})
+          </p>
+          <ul>
+            {section.roles.map((role) => (
+              <li key={role.id}>
+                <strong>{role.name}</strong>
+                <span> - {role.harmony.chord}</span>
+                <span> - {role.cue.value}</span>
+                <span> - {t("roleConfidence")}: {confidenceLabels[role.confidence.level]}</span>
+                <span> - {t("harmonySource")}: {provenanceLabels[role.harmony.source]}</span>
+                {role.manualOverrides.map((override, index) => (
+                  <span key={`${override.field}-${override.source}-${override.value.chord}-${index}`}>
+                    {" "}
+                    - {t("manualOverride")}: {override.value.chord} ({provenanceLabels[override.source]})
+                  </span>
+                ))}
+              </li>
+            ))}
+          </ul>
+        </section>
+      ))}
       <HomeFeature title={t("homeCard")} />
       <PlayerFeature title={t("playerCard")} />
       <ChordsFeature title={t("chordsCard")} />

apps/desktop/src/locales/en/common.json

@@ -6,5 +6,14 @@
   "chordsCard": "Chord analysis baseline is wired.",
   "rangesCard": "Range analysis baseline is wired.",
   "settingsCard": "Settings baseline is wired.",
-  "supportedFormats": "Supported input formats"
+  "supportedFormats": "Supported input formats",
+  "sectionConfidence": "Section confidence",
+  "roleConfidence": "confidence",
+  "harmonySource": "harmony source",
+  "manualOverride": "manual override",
+  "confidenceLevelLow": "Low confidence",
+  "confidenceLevelMedium": "Needs ear check",
+  "confidenceLevelHigh": "Ready to trust",
+  "provenanceSourceModel": "Auto-detected",
+  "provenanceSourceUser": "User-confirmed"
 }

apps/desktop/src/locales/ko/common.json

@@ -6,5 +6,14 @@
   "chordsCard": "코드 분석 기준선이 연결되었습니다.",
   "rangesCard": "음역 분석 기준선이 연결되었습니다.",
   "settingsCard": "설정 기준선이 연결되었습니다.",
-  "supportedFormats": "지원 입력 형식"
+  "supportedFormats": "지원 입력 형식",
+  "sectionConfidence": "구간 신뢰도",
+  "roleConfidence": "신뢰도",
+  "harmonySource": "화성 출처",
+  "manualOverride": "수동 수정",
+  "confidenceLevelLow": "확신이 낮음",
+  "confidenceLevelMedium": "귀로 한 번 더 확인",
+  "confidenceLevelHigh": "믿고 가져가도 됨",
+  "provenanceSourceModel": "자동 추정",
+  "provenanceSourceUser": "사용자 확인"
 }