rvlib-shipkit 0.11.0 → 0.13.0

package/src/serve/hub-app/hub-st.ts

@@ -0,0 +1,169 @@
+// HubSt — the ONE root store (build/app-state-tree: one central tree,
+// instantiated once at boot, services with backrefs, exposed as
+// window.app). Owns cross-service state: selection, the severity filter
+// (an ADDRESS: /?f=needs · /?f=red; legacy /?needs=1 reads as needs),
+// hash deep-links (#<asset-id> · #cat-<Category>).
+import { makeAutoObservable } from 'mobx'
+import { ColsSvc } from './cols-svc.ts'
+import { HealthSvc } from './health-svc.ts'
+import { MediaSvc } from './media-svc.ts'
+
+export type Sel =
+    | { t: 'asset'; id: string }
+    | { t: 'cat'; cat: string }
+    | { t: 'col'; id: string }
+    | { t: 'item'; col: string; id: string }
+    | { t: 'status' }
+    | null
+
+/** one cmd+j target — run() fires the SAME action clicking would */
+export type Jump = { id: string; label: string; section: string; run: () => void }
+
+/** all · needs (yellow+red) · red — one severity ladder for every section */
+export type Filter = 'all' | 'needs' | 'red'
+const parseFilter = (search: string): Filter => {
+    const sp = new URLSearchParams(search)
+    const f = sp.get('f')
+    if (f === 'needs' || f === 'red') return f
+    return sp.get('needs') === '1' ? 'needs' : 'all' // legacy address keeps working
+}
+
+export class HubSt {
+    name = ''
+    media = new MediaSvc(this)
+    cols = new ColsSvc(this)
+    health = new HealthSvc(this)
+    sel: Sel = null
+    filter: Filter = parseFilter(location.search)
+    /** sidebar search — live substring filter over asset + collection rows */
+    query = ''
+    palOpen = false
+    palQuery = ''
+    palIdx = 0
+    private booted = false
+
+    constructor() {
+        makeAutoObservable<this, 'booted'>(this, { media: false, cols: false, health: false, booted: false })
+    }
+
+    boot(): void {
+        void fetch('/hub.json')
+            .then((r) => r.json() as Promise<{ name: string }>)
+            .then((h) => { this.setName(h.name) })
+            .catch(() => {})
+        this.media.start()
+        this.cols.start()
+        void this.health.load()
+        window.addEventListener('hashchange', () => this.applyHash())
+    }
+    private setName(n: string): void {
+        this.name = n
+        document.title = `${n} · hub`
+    }
+
+    setFilter(v: Filter): void {
+        this.filter = v
+        const u = new URL(location.href)
+        u.searchParams.delete('needs') // legacy param never survives a click
+        v === 'all' ? u.searchParams.delete('f') : u.searchParams.set('f', v)
+        history.replaceState(null, '', u)
+    }
+    setQuery(v: string): void {
+        this.query = v
+    }
+
+    // ── cmd+j palette ─────────────────────────────────────────────────────
+    palToggle(): void {
+        this.palOpen = !this.palOpen
+        this.palQuery = ''
+        this.palIdx = 0
+    }
+    palClose(): void {
+        this.palOpen = false
+    }
+    setPalQuery(v: string): void {
+        this.palQuery = v
+        this.palIdx = 0
+    }
+    setPalIdx(n: number): void {
+        this.palIdx = n
+    }
+    palMove(d: number): void {
+        const n = this.palResults.length
+        if (n > 0) this.palIdx = (this.palIdx + d + n) % n
+    }
+    palRun(): void {
+        const j = this.palResults[this.palIdx]
+        if (j == null) return
+        this.palOpen = false
+        j.run()
+    }
+    /** every jump target: section titles, media assets, collection instances */
+    get jumps(): Jump[] {
+        const out: Jump[] = []
+        for (const cat of new Set(this.media.assets.map((a) => a.cat)))
+            out.push({ id: `cat:${cat}`, label: cat, section: 'media', run: () => this.showCat(cat) })
+        for (const a of this.media.assets)
+            out.push({ id: `asset:${a.id}`, label: a.label, section: a.cat, run: () => this.selectAsset(a.id) })
+        for (const col of this.cols.sidebarCols) {
+            const health = col.id === 'health'
+            out.push({ id: `col:${col.id}`, label: col.title, section: 'section', run: () => (health ? this.showStatus() : this.showCol(col.id)) })
+            for (const i of col.instances)
+                out.push({ id: `item:${i.id}`, label: i.text, section: col.title, run: () => (health ? this.showStatus() : this.cols.select(col.id, i.id)) })
+        }
+        return out
+    }
+    /** ranked: prefix matches first, then substring; capped at 12 */
+    get palResults(): Jump[] {
+        const q = this.palQuery.trim().toLowerCase()
+        if (q === '') return this.jumps.slice(0, 12)
+        const pre: Jump[] = []
+        const sub: Jump[] = []
+        for (const j of this.jumps) {
+            const l = j.label.toLowerCase()
+            if (l.startsWith(q)) pre.push(j)
+            else if (l.includes(q)) sub.push(j)
+        }
+        return [...pre, ...sub].slice(0, 12)
+    }
+
+    // ── selection + hash deep-links ───────────────────────────────────────
+    selectAsset(id: string, writeHash = true): void {
+        this.sel = { t: 'asset', id }
+        if (writeHash) this.setHash(id)
+        void this.media.select(id)
+    }
+    showCat(cat: string, writeHash = true): void {
+        this.sel = { t: 'cat', cat }
+        this.media.openCats.add(cat)
+        if (writeHash) this.setHash(`cat-${cat}`)
+        void this.media.fillCat()
+    }
+    showStatus(): void {
+        this.sel = { t: 'status' }
+        void this.health.load()
+    }
+    /** collection view — one card per instance (health has StatusCard instead) */
+    showCol(id: string): void {
+        this.sel = { t: 'col', id }
+    }
+    private setHash(h: string): void {
+        if (location.hash.slice(1) !== h) location.hash = h
+    }
+    applyHash(): void {
+        const h = decodeURIComponent(location.hash.slice(1))
+        if (h === '') return
+        if (h.startsWith('cat-')) {
+            const c = h.slice(4)
+            if (this.media.assets.some((a) => a.cat === c) && this.media.catMode !== c) this.showCat(c, false)
+            return
+        }
+        if (this.media.assets.some((a) => a.id === h) && this.media.curId !== h) this.selectAsset(h, false)
+    }
+    /** first heartbeat has the asset list — only then can a hash resolve */
+    afterFirstBeat(): void {
+        if (this.booted) return
+        this.booted = true
+        this.applyHash()
+    }
+}

package/src/serve/hub-app/hub-types.ts

@@ -0,0 +1,72 @@
+// Wire types the hub app reads — mirrors of the server shapes
+// (studio-server.ts, collection-types.ts). Kept structural on purpose: the
+// page renders what the API sends, the file is the truth.
+
+export type SideAsset = {
+    id: string
+    cat: string
+    label: string
+    prompt: string
+    rolls: number
+    picked: boolean
+    icon: boolean
+    media: 'image' | 'audio'
+    manual: boolean
+    derived: boolean
+    stale: boolean
+}
+
+export type RollRow = { name: string; picked: boolean; alt: boolean; hasMeta: boolean }
+
+export type AssetInfo = {
+    backend: string
+    deterministic: boolean
+    workflow: { id: string | null; path: string | null; note?: string } | null
+    ship: { mode: string; path?: string; note?: string }
+    metaFile: string | null
+    kindId: string
+    kitSource: string
+}
+
+export type CustomPanelRef = { id: string; kind: string; url: string }
+
+export type AssetDetail = {
+    asset: { id: string; label?: string; prompt: string; cat: string; geometry: boolean; custom: CustomPanelRef[] } & Record<string, unknown>
+    info: AssetInfo
+    rolls: RollRow[]
+}
+
+export type Leg = { x: number; y: number; w: number; h: number }
+export type Rect = { x: number; y: number; w: number; h: number; size: number; flip?: boolean; legs?: Leg[]; legColor?: string; art?: unknown }
+
+export type CatRow = { id: string; label: string; name: string; rect: Rect | null; prop: boolean; icon: boolean }
+
+export type QueueState = {
+    generating: boolean
+    current: string | null
+    done: number
+    total: number
+    queued: number
+    progress: { value: number; max: number } | null
+    pending: string[]
+    errors: string[]
+    assets: SideAsset[]
+}
+
+export type Candidate = { id: string; label: string; hint?: string }
+export type Artifact = { copy?: string; url?: string; steps?: string[] }
+export type ColInstance = {
+    id: string
+    text: string
+    severity?: 'red' | 'yellow'
+    href?: string
+    artifact?: Artifact
+    candidates?: Candidate[]
+    file?: string
+    img?: string
+    remarks?: string[]
+    /** the truth file's markdown BODY (frontmatter stripped) — clamped card
+     *  in the grid, full in the item view */
+    md?: string
+}
+export type Col = { id: string; title: string; media: string; instances: ColInstance[] }

package/src/serve/hub-app/hub.css

@@ -1,65 +1,292 @@
-/* house palette — matches the studio/graph family. Plain CSS on purpose:
-   a published lib must not impose bunfig plugins (tailwind) on consumers. */
+/* house palette — matches the graph family. Plain CSS on purpose: a
+   published lib must not impose bunfig plugins (tailwind) on consumers. */
 :root{--bg:#141210;--panel:#1e1a15;--panel2:#262019;--line:#332b22;--ink:#f3ebe0;--dim:#a89a88;
- --accent:#e88c28;--gold:#ffcf5c;--teal:#58c0b0;--red:#e05252}
-*{box-sizing:border-box}
-body{margin:0;background:var(--bg);color:var(--ink);font:15px/1.6 system-ui,sans-serif;min-height:100vh}
-.app{display:flex;min-height:100vh}
-.wrap{max-width:900px;margin:0 auto;padding:34px 26px;flex:1}
-h1{font-size:20px;margin:0}
-h1 small{color:var(--dim);font-weight:400;font-size:13px;margin-left:10px}
-.crumb{font-size:12px;letter-spacing:.14em;text-transform:uppercase;color:var(--accent);margin-bottom:6px}
-
-.skrail{position:sticky;top:0;align-self:flex-start;height:100vh;width:46px;display:flex;flex-direction:column;
- align-items:center;padding-top:10px;gap:4px;background:#17140f;border-right:1px solid var(--line);flex:none}
-.skrail a{display:flex;align-items:center;justify-content:center;width:36px;height:36px;border-radius:9px;
- font-size:17px;text-decoration:none;border-left:2px solid transparent;filter:grayscale(35%);opacity:.75;position:relative}
-.skrail a:hover{background:var(--panel2);filter:none;opacity:1}
-.skrail a.on{background:var(--panel2);border-left-color:var(--accent);filter:none;opacity:1}
-.skrail a i{position:absolute;top:4px;right:4px;width:8px;height:8px;border-radius:50%;background:var(--red)}
-
-.clear{margin-top:30px;font-size:17px;color:var(--teal)}
-section{background:var(--panel);border:1px solid var(--line);border-left:3px solid var(--gold);border-radius:12px;
- padding:14px 18px;margin-top:16px}
-section.red{border-left-color:var(--red)}
-h2{font-size:14px;margin:0 0 8px;display:flex;align-items:center;gap:8px}
-h2 a{color:var(--ink);text-decoration:none}h2 a:hover{color:var(--gold)}
-h2 em{font-style:normal;font-size:12px;color:var(--dim);background:var(--panel2);border-radius:8px;padding:1px 8px}
-.line{font:12.5px/1.7 ui-monospace,Menlo,monospace;color:var(--dim);white-space:pre-wrap}
-.line a{color:var(--dim);text-decoration:underline dotted}.line a:hover{color:var(--gold)}
-section.red .line{color:#e8a0a0}
-.sub{margin-top:10px;font-size:12px;color:var(--dim)}
-.sub a{color:var(--dim)}
-
-.bar{display:flex;align-items:center;gap:12px;margin:18px 0 12px}
-button{background:var(--accent);color:#1a1206;border:0;border-radius:9px;padding:8px 14px;font-weight:650;cursor:pointer}
+ --accent:#e88c28;--gold:#ffcf5c;--teal:#58c0b0;--red:#e05252;--blue:#6ca0e8;--chk1:#221d17;--chk2:#1a1611}
+*{box-sizing:border-box}html,body,#root{height:100%}
+body{margin:0;background:var(--bg);color:var(--ink);font:14px/1.5 system-ui,sans-serif;overflow:hidden}
+.app{display:grid;grid-template-columns:46px 290px 1fr;height:100vh}
+
+/* ── icon rail: jump-to-section, never a navigation ── */
+.skrail{width:46px;height:100vh;display:flex;flex-direction:column;align-items:center;padding-top:10px;gap:4px;
+ background:#17140f;border-right:1px solid var(--line)}
+.skrail .ric{display:flex;align-items:center;justify-content:center;width:36px;height:36px;border-radius:9px;
+ font-size:17px;cursor:pointer;filter:grayscale(35%);opacity:.75;position:relative;user-select:none}
+.skrail .ric:hover{background:var(--panel2);filter:none;opacity:1}
+.skrail .ric i{position:absolute;top:4px;right:4px;width:8px;height:8px;border-radius:50%;background:var(--red)}
+
+/* ── sidebar ── */
+aside{border-right:1px solid var(--line);background:var(--panel);overflow-y:auto;height:100vh}
+.shead{position:sticky;top:0;background:var(--panel);padding:12px 14px;border-bottom:1px solid var(--line);
+ font-size:12px;letter-spacing:.14em;text-transform:uppercase;color:var(--dim);z-index:2;display:flex;justify-content:space-between;align-items:center}
+/* segmented severity filter — all · needs · red */
+.seg{display:inline-flex;border:1px solid var(--line);border-radius:7px;overflow:hidden;flex:none}
+.seg button{background:var(--bg);color:var(--dim);border:0;border-radius:0;padding:2px 8px;font-size:10px;font-weight:600;
+ letter-spacing:.06em;text-transform:uppercase;cursor:pointer}
+.seg button+button{border-left:1px solid var(--line)}
+.seg button:hover{color:var(--ink)}
+.seg button.on{background:var(--accent);color:#1a1206}
+.ssearch{padding:8px 12px}
+.ssearch input{width:100%;background:var(--bg);border:1px solid var(--line);border-radius:8px;color:var(--ink);
+ padding:6px 10px;font-size:12.5px;outline:none}
+.ssearch input:focus{border-color:var(--accent)}
+/* section header — hairline top border, tight letterspacing; media cats
+   and collection sections share this treatment EXACTLY */
+.gname{padding:9px 14px 4px;font-size:11px;letter-spacing:.09em;text-transform:uppercase;color:var(--accent);
+ border-top:1px solid var(--line);display:flex;justify-content:space-between;align-items:center;scroll-margin-top:46px}
+.gname .cn{cursor:pointer}.gname .cn:hover{color:var(--gold)}
+.gname .cnt{font-size:11px;color:var(--dim);letter-spacing:0;text-align:right;min-width:18px}
+.warnline{color:var(--red);text-transform:none;letter-spacing:0}
+.fold{cursor:pointer;color:var(--dim);font-size:15px;display:inline-block;width:22px;text-align:center;
+ padding:2px 3px;margin:-2px 0;border-radius:6px;user-select:none}
+.fold:hover{color:var(--ink);background:var(--panel2)}
+.catgen button{background:var(--panel2);color:var(--dim);border:1px solid var(--line);border-radius:6px;
+ padding:1px 6px;font-size:11px;font-weight:700;margin-left:3px;cursor:pointer}
+.catgen button:hover{color:var(--ink);border-color:var(--accent)}
+/* items sit one step in from their header, on a subtle left guide line;
+   the full row hovers, the selected row keeps the accent bar */
+.arow{position:relative;display:flex;align-items:center;gap:8px;padding:3px 12px 3px 24px;cursor:pointer;
+ border-left:3px solid transparent}
+.arow::before{content:'';position:absolute;left:15px;top:0;bottom:0;width:1px;background:var(--line)}
+.arow:hover{background:var(--panel2)}
+.arow.sel{background:rgba(232,140,40,.18);border-left-color:var(--accent)}
+.arow.sel::before{background:transparent}
+.arow .lb{flex:1;min-width:0}.arow .lb b{display:block;font-size:13px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;font-weight:600}
+.arow .lb span{font-size:11px;color:var(--dim);display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.dot{width:8px;height:8px;border-radius:50%;flex:none;background:var(--line)}
+.dot.done{background:var(--gold)}.dot.some{background:var(--accent)}
+.dot.miss{background:#e5484d}.dot.stale{background:#f5a524}
+.cdot{width:8px;height:8px;border-radius:50%;flex:none;background:var(--line)}
+.cdot.red{background:var(--red)}.cdot.yellow{background:var(--gold)}
+
+/* ── main column ── */
+main{display:flex;flex-direction:column;height:100vh;overflow:hidden}
+/* topbar: the prompt is its OWN full-width row (small mono, auto-grows to
+   its content, scrolls only past ~14 lines), then ONE slim toolbar row */
+.bar{display:flex;flex-direction:column;gap:8px;padding:10px 16px;border-bottom:1px solid var(--line);background:var(--panel)}
+textarea{width:100%;min-height:64px;background:var(--bg);color:var(--ink);border:1px solid var(--line);
+ border-radius:9px;padding:9px 11px;font:12px/1.5 ui-monospace,Menlo,monospace;resize:vertical}
+.bar .prompt{min-height:36px;max-height:252px;overflow-y:auto;resize:none;font:11px/1.5 ui-monospace,Menlo,monospace;padding:7px 10px}
+.toolbar{display:flex;gap:8px;align-items:center;min-height:30px}
+.toolbar button{padding:5px 11px;font-size:12px}
+.toolbar .sp{flex:1}
+.toolbar .xn{display:flex;gap:3px;align-items:center;font-size:12px;color:var(--dim)}
+.toolbar .xn select{padding:4px 5px;font-size:12px}
+button{background:var(--accent);color:#1a1206;border:0;border-radius:9px;padding:8px 13px;font-weight:650;cursor:pointer}
+button.ghost{background:var(--panel2);color:var(--ink);border:1px solid var(--line)}
 button:disabled{opacity:.45;cursor:default}
+select,input[type=number]{background:var(--bg);color:var(--ink);border:1px solid var(--line);border-radius:8px;padding:7px}
+.status{font-size:12px;color:var(--dim);text-align:right;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:46vw;flex:none}
+.spin{width:12px;height:12px;border:2px solid var(--line);border-top-color:var(--gold);border-radius:50%;animation:rot 1s linear infinite;flex:none}
+@keyframes rot{to{transform:rotate(360deg)}}
+.progbar{display:block;width:120px;height:4px;background:var(--panel2);border-radius:2px;overflow:hidden;flex:none}
+.progbar i{display:block;height:100%;width:0;background:var(--gold);transition:width .3s}
+.detnote{font-size:11px;color:var(--teal);line-height:1.25}
+.jrow{display:flex;gap:8px;margin-top:6px;align-items:center}
+.jmsg{font-size:12px;color:var(--dim)}
+kbd{background:var(--panel2);border:1px solid var(--line);border-radius:4px;padding:0 5px;font-size:11px}
+.help{font-size:11px;color:var(--dim);padding:4px 16px;border-top:1px solid var(--line)}
+.errs{background:#3a1717;border-bottom:1px solid #5a2222;color:#f0c0c0;font:12px/1.5 ui-monospace,Menlo,monospace;
+ padding:6px 16px;white-space:pre-wrap}
+
+/* ── per-asset info chips ── */
+.info{flex-wrap:wrap;gap:6px;align-items:center;padding:6px 16px;border-bottom:1px solid var(--line);background:var(--panel2)}
+.info .chip{display:inline-flex;align-items:center;gap:5px;background:var(--bg);border:1px solid var(--line);border-radius:6px;
+ padding:2px 8px;font-size:11px;color:var(--ink);max-width:360px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.info .chip b{color:var(--accent);font-weight:650;letter-spacing:.05em;text-transform:uppercase;font-size:10px}
+.info .chip.warn{border-color:var(--red);color:#f0c0c0}.info .chip.warn b{color:var(--red)}
+.info .chip code{font:11px ui-monospace,Menlo,monospace;color:var(--dim)}
+
+/* ── stage ── */
+.stage{position:relative;flex:1;min-height:0;display:flex;align-items:center;justify-content:center;padding:18px;overflow:hidden;
+ background:conic-gradient(var(--chk1) 90deg,var(--chk2) 0 180deg,var(--chk1) 0 270deg,var(--chk2) 0) 0/34px 34px}
+.stage img.roll{max-width:100%;max-height:100%;object-fit:contain;filter:drop-shadow(0 6px 20px #0008);z-index:5;position:relative}
+.stage .ph,.stagewrap .ph{color:var(--dim)}
+.stagewrap{flex:1;min-height:0;overflow-y:auto;display:flex;align-items:flex-start;justify-content:center;padding:18px}
+.stageaud{display:flex;flex-direction:column;align-items:center;gap:14px;font-size:48px;padding:40px}
+.stageaud audio{width:min(480px,80vw)}
+
+/* ── geometry overlay ── */
+#ov{position:absolute;border:2px solid var(--gold);border-radius:50%;background:rgba(255,207,92,.14);cursor:move;z-index:10}
+#ov .hdl{position:absolute;right:-7px;top:-7px;width:14px;height:14px;background:var(--gold);border-radius:3px;cursor:nesw-resize}
+#ov .arrow{position:absolute;left:0;right:0;top:50%;border-top:1px dashed var(--gold);opacity:.8}
+#ov .sz{position:absolute;left:50%;top:50%;transform:translate(-50%,-120%);font-size:11px;color:var(--gold);
+ background:#000a;padding:0 5px;border-radius:4px;white-space:nowrap}
+.plumb{position:absolute;width:0;border-left:1px dashed rgba(255,207,92,.5);top:-2000px;bottom:-2000px;z-index:9}
+.leg{position:absolute;z-index:10;border:1px solid;border-radius:3px}
+.leg.far{border-color:var(--blue);z-index:3}
+.leg.near{border-color:var(--red);z-index:7}
+.leg .hip{position:absolute;top:-3px;left:50%;transform:translateX(-50%);width:6px;height:6px;border-radius:50%;background:currentColor}
+.leg .foot{position:absolute;bottom:-4px;left:50%;transform:translateX(-50%);width:12px;height:7px;border-radius:50%;background:var(--gold)}
+.leg .lh{position:absolute;right:-6px;top:-6px;width:11px;height:11px;background:currentColor;border-radius:3px;cursor:nesw-resize}
+.leg .tag{position:absolute;left:50%;top:50%;transform:translate(-50%,-50%);font-size:9px;opacity:.85;white-space:nowrap}
+.pill{position:absolute;border-radius:999px;z-index:3;opacity:.9}
+.pill.near{z-index:7}
+#rectbar{position:absolute;left:14px;bottom:14px;z-index:11;gap:8px;align-items:center;
+ background:#000b;border:1px solid var(--line);border-radius:10px;padding:7px 10px;font-size:12px}
+#rectbar input[type=number]{width:64px;padding:4px}
+#rectbar .ro{color:var(--dim);font:11px ui-monospace,Menlo,monospace}
+#rectbar label{display:flex;gap:6px;align-items:center}
+
+/* ── category grid + lineup ── */
+#catgrid{flex:1;min-height:0;overflow-y:auto;padding:14px}
+.cards{display:grid;grid-template-columns:repeat(auto-fill,minmax(180px,1fr));gap:12px}
+.card{background:var(--panel);border:1px solid var(--line);border-radius:10px;padding:8px;cursor:pointer}
+.card:hover{border-color:var(--accent)}
+.card .th{position:relative;aspect-ratio:1;border-radius:8px;overflow:hidden;
+ background:conic-gradient(var(--chk1) 90deg,var(--chk2) 0 180deg,var(--chk1) 0 270deg,var(--chk2) 0) 0/14px 14px}
+.card .th img{width:100%;height:100%;object-fit:contain}
+.card .th .ovmini{position:absolute;border:1.5px solid var(--gold);border-radius:50%;background:rgba(255,207,92,.12)}
+.card .th .spin{position:absolute;top:8px;right:8px}
+.card .nm{font-size:12px;margin:6px 0 4px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;cursor:pointer}
+.card .nm:hover{color:var(--gold)}
+.card .row{display:flex;gap:6px;align-items:center;font-size:11px;color:var(--dim)}
+.card .row input{width:58px;padding:3px}
+.card .aud{aspect-ratio:1;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:8px;font-size:28px}
+.card .aud audio{width:92%;height:24px}
+#allbar{display:flex;gap:8px;align-items:center;margin:0 0 12px;font-size:12px;color:var(--dim)}
+#allbar label{display:flex;gap:6px;align-items:center}
+#mixsec{margin-top:16px}
+#mixbox{position:relative;height:420px;overflow-x:auto;overflow-y:hidden;background:var(--panel);
+ border:1px solid var(--line);border-radius:10px}
+#mixinner{position:relative;height:100%}
+#mixground{position:absolute;left:0;right:0;bottom:0;height:44px;background:#1d2b1a;border-top:1px solid #2c4527}
+.mixsprite{position:absolute;image-rendering:auto;pointer-events:none}
+.mixlabel{position:absolute;font-size:10px;color:var(--dim);text-align:center;transform:translateX(-50%)}
+.ruler{position:absolute;left:0;right:0;bottom:44px;top:0;pointer-events:none;
+ background:
+  repeating-linear-gradient(to top,rgba(255,255,255,.28) 0 1px,transparent 1px 240px),
+  repeating-linear-gradient(to top,rgba(255,255,255,.16) 0 1px,transparent 1px 120px),
+  repeating-linear-gradient(to top,rgba(255,255,255,.07) 0 1px,transparent 1px 24px)}
+.rlabel{position:absolute;left:4px;font-size:9px;color:var(--dim)}
+.rlabel.b{font-weight:700;color:var(--ink)}
+
+/* ── roll strip ── */
+.strip{height:150px;flex:none;border-top:1px solid var(--line);background:var(--panel);display:flex;gap:10px;padding:12px;overflow-x:auto}
+.vig{position:relative;height:100%;aspect-ratio:1;flex:none;border:2px solid var(--line);border-radius:10px;overflow:hidden;cursor:pointer;
+ background:conic-gradient(var(--chk1) 90deg,var(--chk2) 0 180deg,var(--chk1) 0 270deg,var(--chk2) 0) 0/12px 12px}
+.vig img{width:100%;height:100%;object-fit:contain}
+.vig.active{border-color:var(--ink)}
+.vig.picked{border-color:var(--gold);box-shadow:0 0 0 2px var(--gold) inset}
+.vig.alt{border-color:var(--teal)}
+.vig .st{position:absolute;top:4px;right:6px;font-size:16px;filter:drop-shadow(0 1px 2px #000)}
+.vig .btns{position:absolute;bottom:4px;left:4px;right:4px;display:flex;gap:4px;justify-content:center;opacity:0;transition:opacity .15s}
+.vig:hover .btns{opacity:1}
+.vig .btns button{padding:2px 7px;font-size:11px;border-radius:6px}
+.vig .btns .b-alt{background:var(--teal);color:#06342c}
+.vig .btns .b-del{background:var(--red);color:#fff}
+.vig.aud{display:flex;flex-direction:column;align-items:center;justify-content:center;gap:6px;font-size:20px}
+.vig.aud audio{width:100%;height:24px}
+.vig.gen{display:flex;flex-direction:column;align-items:center;justify-content:center;gap:8px;color:var(--dim);font-size:11px}
+.strip .ph{color:var(--dim);align-self:center;padding:0 12px}
+
+/* ── drawer ── */
+.drawer{flex:none;border-top:1px solid var(--line);background:var(--panel)}
+.tabs{display:flex;gap:2px;padding:6px 12px 0}
+.tabs button{background:var(--panel2);color:var(--dim);border:1px solid var(--line);border-bottom:0;border-radius:8px 8px 0 0;
+ padding:5px 12px;font-size:12px;font-weight:400}
+.tabs button.on{color:var(--ink);background:var(--bg)}
+.tabs .sp{flex:1}
+.tabs .ghost{border:1px solid var(--line);border-radius:8px;font-size:12px;padding:5px 12px}
+#drawerbody{padding:10px 12px}
+#jsonta{min-height:140px}
+
+/* ── asset remark row ── */
+.assetrem{flex:none;border-top:1px solid var(--line);background:var(--panel);padding:8px 12px}
+.assetrem .row{display:flex;gap:10px;align-items:center}
+.assetrem input{flex:1;background:var(--bg);border:1px solid var(--line);border-radius:8px;color:var(--ink);padding:7px 10px;font-size:12.5px}
+.assetrem .rem{color:var(--teal);border-left:2px solid var(--teal);padding-left:10px;font-size:12.5px;margin:0 0 8px;white-space:pre-wrap}
+
+/* ── collection item card + status card ── */
+.colcard{max-width:760px;width:100%;background:var(--panel);border:1px solid var(--line);border-radius:12px;padding:18px 22px;text-align:left}
+.colcard h3{margin:0 0 10px;font-size:15px;display:flex;gap:10px;align-items:baseline}
+.colcard .truth{margin-left:auto;font:11px ui-monospace,Menlo,monospace;color:var(--dim)}
+.colcard .rem{color:var(--teal);border-left:2px solid var(--teal);padding-left:10px;font-size:12.5px;margin:8px 0;white-space:pre-wrap}
+.colcard .row{display:flex;gap:10px;align-items:center;margin-top:10px;flex-wrap:wrap}
+.colcard input{flex:1;min-width:220px;background:var(--bg);border:1px solid var(--line);border-radius:8px;color:var(--ink);padding:7px 10px;font-size:12.5px}
+.colcard code{display:block;background:var(--bg);border:1px solid var(--line);border-radius:8px;padding:8px 10px;font:12px ui-monospace,Menlo,monospace;white-space:pre-wrap;max-height:200px;overflow-y:auto;margin-top:8px}
+.colcard .cand{background:var(--bg);border:1px solid var(--line);border-radius:9px;padding:9px 12px;margin-top:8px}
+.colcard .candhint{color:var(--dim);font-size:12.5px;white-space:pre-wrap}
+.colcard .err,.assetrem .err{color:var(--red);margin-top:8px;font-size:12.5px}
+.colcard a{color:var(--accent)}
+
+.back{cursor:pointer;color:var(--dim);font-size:12px}
+.back:hover{color:var(--ink)}
+.colcard .back{margin-bottom:8px}
+
+/* ── collection view (one card per instance) ── */
+.colgrid{flex:1;min-height:0;overflow-y:auto;padding:14px 16px}
+.cghead{font-size:12px;letter-spacing:.14em;text-transform:uppercase;color:var(--accent);
+ display:flex;gap:10px;align-items:baseline;margin:0 0 12px}
+.cghead .cnt{font-size:11px;color:var(--dim);letter-spacing:0;text-transform:none}
+.cgcards{display:grid;grid-template-columns:repeat(auto-fill,minmax(240px,1fr));gap:12px}
+.cgcard{background:var(--panel);border:1px solid var(--line);border-radius:10px;padding:10px 12px;cursor:pointer;min-width:0}
+.cgcard:hover{border-color:var(--accent)}
+.cgcard .cgtop{display:flex;gap:8px;align-items:center;min-width:0}
+.cgcard .cgtop b{font-size:13px;font-weight:600;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.cgcard .truth{display:block;font:11px ui-monospace,Menlo,monospace;color:var(--dim);margin-top:4px;
+ white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.cgcard .cgrem{color:var(--teal);border-left:2px solid var(--teal);padding-left:8px;font-size:12px;margin-top:6px;
+ white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+
+/* ── graph item view (the graph itself fills the stage) ── */
+.graphview{flex:1;min-height:0;display:flex;flex-direction:column;gap:10px;padding:12px 16px 16px}
+.gvhead{display:flex;gap:10px;align-items:center;font-size:13px;min-width:0}
+.gvhead .gvtext{white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.graphview iframe{flex:1;min-height:0;width:100%;border:1px solid var(--line);border-radius:12px;background:var(--bg)}
+
+/* ── md output (truth-file card bodies — marked + sanitize allowlist) ── */
+.md{font-size:12px;line-height:1.5;color:var(--ink)}
+.md table{border-collapse:collapse;margin:6px 0;font-size:11.5px;max-width:100%}
+.md th,.md td{border:1px solid var(--line);padding:3px 8px;text-align:left;vertical-align:top}
+.md th{color:var(--accent);font-weight:650;font-size:10.5px;letter-spacing:.05em;text-transform:uppercase;background:var(--panel2)}
+.md blockquote{margin:6px 0;padding:2px 10px;border-left:2px solid var(--line);color:var(--dim)}
+.md hr{border:0;border-top:1px solid var(--line);margin:8px 0}
+.md h1,.md h2,.md h3{font-size:12.5px;margin:8px 0 4px;color:var(--accent);letter-spacing:.02em}
+.md h1{font-size:13.5px}
+.md p{margin:4px 0}
+.md ul{margin:4px 0;padding-left:18px}
+.md li{margin:2px 0}
+.md code{display:inline;background:var(--bg);border:1px solid var(--line);border-radius:4px;padding:0 4px;
+ font:11px ui-monospace,Menlo,monospace;color:var(--ink);white-space:pre-wrap;max-height:none;margin:0}
+.md pre{background:var(--bg);border:1px solid var(--line);border-radius:8px;padding:8px 10px;margin:6px 0;
+ overflow-x:auto;font:11px/1.5 ui-monospace,Menlo,monospace;white-space:pre}
+.md pre code{background:none;border:0;padding:0}
+.md a{color:var(--accent)}
+.md.clamp{max-height:180px;overflow:hidden;margin-top:6px;
+ -webkit-mask-image:linear-gradient(#000 65%,transparent);mask-image:linear-gradient(#000 65%,transparent)}
+
+/* ── secret (cred) cards ── */
+.credname{font:600 13px ui-monospace,Menlo,monospace}
+.creddesc{font-size:12px;color:var(--dim);margin-top:4px}
+.credrow{display:flex;gap:8px;align-items:center;margin-top:8px}
+.stchip{font-size:10px;border-radius:5px;padding:1px 7px;letter-spacing:.08em;text-transform:uppercase;
+ border:1px solid;flex:none;font-weight:600}
+.stchip.ok{color:var(--teal);border-color:var(--teal)}
+.stchip.miss{color:var(--red);border-color:var(--red)}
+a.mint{color:var(--accent);font-size:12px;text-decoration:none}
+a.mint:hover{text-decoration:underline}
+.colcard h3 .stchip,.colcard h3 a.mint{margin-left:8px}
+
+/* ── cmd+j palette ── */
+.palov{position:fixed;inset:0;background:#0009;z-index:100;display:flex;justify-content:center;align-items:flex-start;
+ padding-top:14vh}
+.pal{width:min(560px,90vw);background:var(--panel);border:1px solid var(--line);border-radius:12px;
+ box-shadow:0 12px 40px #000a;overflow:hidden}
+.pal input{width:100%;background:var(--bg);border:0;border-bottom:1px solid var(--line);color:var(--ink);
+ padding:12px 14px;font-size:14px;outline:none}
+.prows{max-height:50vh;overflow-y:auto;padding:6px}
+.prow{display:flex;align-items:center;gap:10px;padding:7px 10px;border-radius:8px;cursor:pointer;font-size:13px}
+.prow.on{background:var(--panel2)}
+.prow.none{color:var(--dim);cursor:default}
+.prow .plabel{flex:1;min-width:0;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.prow .pchip{font-size:10px;color:var(--dim);background:var(--bg);border:1px solid var(--line);border-radius:5px;
+ padding:1px 6px;text-transform:uppercase;letter-spacing:.08em;flex:none}
+
+.wrap{max-width:900px;width:100%}
+.wrap h1{font-size:20px;margin:0}
+.wrap h1 small{color:var(--dim);font-weight:400;font-size:13px;margin-left:10px}
+.hbar{display:flex;align-items:center;gap:12px;margin:18px 0 12px}
 .note{font-size:12px;color:var(--dim)}
 pre{background:var(--panel);border:1px solid var(--line);border-radius:12px;padding:16px;overflow-x:auto;
  font:12.5px/1.55 ui-monospace,Menlo,monospace;white-space:pre-wrap}
 .ok{color:var(--teal)}.warn{color:var(--gold)}.fail{color:var(--red)}.dim{color:var(--dim)}
-.err{margin-top:26px;color:var(--red)}
-
-/* needs feed tiles — red blocks, yellow = taste pending */
-.tile{background:var(--panel);border:1px solid var(--line);border-left:3px solid var(--dim);border-radius:12px;
- padding:12px 16px;margin-top:10px}
-.tile.red{border-left-color:var(--red)}
-.tile.yellow{border-left-color:var(--gold)}
-.tline{display:flex;align-items:baseline;gap:10px;font-size:14px}
-.tline a{color:var(--ink);text-decoration:underline dotted}.tline a:hover{color:var(--gold)}
-.chip{flex:none;font-size:11px;letter-spacing:.08em;text-transform:uppercase;color:var(--dim);
- background:var(--panel2);border-radius:8px;padding:1px 8px}
-.tile.red .chip{color:#e8a0a0}
-.tact{display:flex;align-items:center;gap:10px;margin-top:8px;font-size:12.5px;flex-wrap:wrap}
-.tact code{color:var(--dim);font:12px ui-monospace,Menlo,monospace;overflow:hidden;text-overflow:ellipsis;max-width:560px;white-space:nowrap}
-.tact button{padding:4px 10px;font-size:12px}
-.tact input{background:var(--panel2);border:1px solid var(--line);border-radius:8px;color:var(--ink);padding:6px 10px;font-size:12.5px;min-width:240px}
-.tact a{color:var(--accent)}
-.tact details{width:100%}
-.tact summary{cursor:pointer;color:var(--dim)}
-.hint{color:var(--dim);font-size:12.5px;white-space:pre-wrap;border-left:2px solid var(--line);padding-left:10px;margin:6px 0 4px}
-.picks{flex-direction:column;align-items:stretch}
-.cand{background:var(--panel2);border:1px solid var(--line);border-radius:9px;padding:8px 12px}
-.candhead{display:flex;align-items:center;gap:10px;margin-bottom:4px}
-.tileerr{margin-top:8px;font-size:12.5px;color:var(--red)}
-label{font-size:12.5px;color:var(--dim);display:flex;gap:6px;align-items:center;cursor:pointer}

package/src/serve/hub-app/index.html

@@ -3,7 +3,7 @@
 <head>
   <meta charset="UTF-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>shipkit hub</title>
+  <title>hub</title>
   <link rel="stylesheet" href="./hub.css" />
 </head>
 <body>

package/src/serve/hub-app/md.ts

@@ -0,0 +1,24 @@
+// md — the SAFE markdown renderer for truth-file bodies on cards.
+// marked (GFM: tables, strikethrough, autolinks) → sanitize-html allowlist.
+// dangerouslySetInnerHTML consumes ONLY this output: every tag outside the
+// allowlist is stripped, hrefs are http/https only, and every surviving
+// anchor opens a new tab with rel=noreferrer.
+import { marked } from 'marked'
+import sanitizeHtml from 'sanitize-html'
+
+marked.use({ gfm: true, breaks: false, async: false })
+
+export const renderMd = (src: string): string =>
+    sanitizeHtml(marked.parse(src) as string, {
+        allowedTags: [
+            'h1', 'h2', 'h3', 'h4', 'p', 'ul', 'ol', 'li',
+            'table', 'thead', 'tbody', 'tr', 'th', 'td',
+            'code', 'pre', 'strong', 'em', 'b', 'i', 'a', 'br', 'blockquote', 'hr',
+        ],
+        allowedAttributes: { a: ['href', 'target', 'rel'] },
+        allowedSchemes: ['http', 'https'],
+        allowProtocolRelative: false,
+        transformTags: {
+            a: (tagName, attribs) => ({ tagName, attribs: { ...attribs, target: '_blank', rel: 'noreferrer' } }),
+        },
+    })