rvlib-shipkit 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,76 @@
 # Changelog
 
+## 0.3.1 — 2026-07-22
+
+- fix: `react-dom` was missing from dependencies AND the CLI entry loaded
+  the react/ink chain eagerly — every command crashed in a fresh consumer
+  repo without react-dom (found by the rabbits-vs-sheeps swap in the field,
+  confirmed against the 0.3.0 tarball). tui now lazy-loads its body; deps
+  carry react-dom. Proven by a fresh-repo install test (init → ci green in
+  a react-less repo).
+- fix: `init` warns loudly when rvlib-shipkit is not installed in the repo
+  (the minted scripts call its bin — previously exit 127 with no hint).
+
+## 0.3.0 — 2026-07-22
+
+New:
+
+- identity from a PICKED comfy mark (W2-1): `renderIdentityFromMark` is THE
+  identity writer (mark png → logo 1024² master → favicon 512² → og card
+  compositing bg + mark left + name/tagline right, fonts shrink-to-fit);
+  canvas marks and picked comfy rolls both feed it — one render path.
+  `identityKinds(brand)` now carries a BUILT-IN ship hook (`Kind.ship.fn`,
+  new — a lib-side ShipFn; `ship.fn` + `ship.via` on one kind is a kit
+  error), so picking a logo roll in the studio re-renders the whole set
+  automatically. `shipkit assets identity` with a comfy mark renders from
+  the current pick and FAILs loud with the next step when nothing is picked
+  ("roll + pick in the studio: bun run assets → #identity-logo") — never a
+  placeholder. `Brand.markPrompt` = the full roll prompt for the mark.
+  Exports: `renderIdentityFromMark`, `NO_PICK_FIX`, `ShipContext`, `ShipFn`.
+
+- `shipkit serve` — ONE hub server per repo, ONE port: a no-build landing
+  page whose links are the whole toolbox. Routes: `/graph/wiki` (md link
+  graph — repo.config `serve.wikiGraph` plugs a custom provider, generic
+  scan otherwise) · `/graph/agent` (when `agent/` exists; `serve.agentIndex`
+  picks the entrypoint) · `/assets/` (the studio, mounted IN-PROCESS on the
+  same port) · `/status` (STATUS.md rendered + a "run check" button that
+  shells `shipkit check` and streams the wire lines). The same URLs print
+  to stdout as clickable `ok:` lines — the intended wiring is ONE vscode
+  folder-open task. Port: `serve.port`, else hashed from the repo name into
+  4800-4979; a taken port is probed via `/hub.json` — the same repo in
+  another window exits 0, a DIFFERENT repo fails loud with a fix pointer.
+- studio routes are mountable: `studioRoutes(deps)` returns the route table
+  (`handle(req, pathname)`); `serveStudio` (standalone `shipkit assets
+  serve`, own port) and the hub's `/assets/` mount share it — one route
+  table, two front doors. The studio page now resolves its urls RELATIVE to
+  the page (works at `/` and under `/assets/`); custom panel module urls
+  are `./panel/…` accordingly.
+- repo.config gains `serve?: { port?, wikiGraph?, agentIndex? }`
+  (`ServeConfig`).
+- studio per-asset info surface (W2-2): the detail view shows where every
+  roll comes from and where a pick goes — backend, resolved workflow id +
+  its `.rv-comfy/` path (or WHY it's unresolved), ship target (built-in /
+  hook / record), meta write-through file, kit source. `/api/asset` gains
+  an additive `info` block. Deterministic canvas kinds (draw takes no seed
+  → identical rolls) are labelled next to Generate and capped to one roll
+  instead of pretending to be a slot machine.
+- `shipkit assets check` prints workflow provenance (W2-3): one `ok:` line
+  per bound pair with its repo-relative `.{json,ts}` path — there is no
+  global workflow store, git owns each repo's pairs; the sharing doctrine
+  lives in build/comfyui.md.
+- a second `shipkit serve` launch on an already-owned port now prints the
+  full clickable tool URLs (from the owner's `/hub.json`), not just the hub
+  root — a re-run terminal is as clickable as a first run.
+
+Fixed:
+
+- `/status` page: STATUS.md content is `<`-escaped inside the inline
+  script — a literal `</script>` in a check line can no longer break the
+  page.
+
+Breaking: none (0.2.0 consumers upgrade clean; `Kind.ship.fn` and `serve`
+config are additive).
+
 ## 0.2.0 — 2026-07-22
 
 The one-runner release: shipkit becomes the all-in-one companion

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "rvlib-shipkit",
-    "version": "0.2.0",
+    "version": "0.3.1",
     "description": "All-in-one repo companion: ci gate (task DAG), auto-discovered health checks, release-contract fulfillness, asks queue, md-wiki tools, asset atelier, live tui",
     "license": "MIT",
     "type": "module",
@@ -29,6 +29,7 @@
         "mobx": "^6.16.1",
         "mobx-react-lite": "^4.1.1",
         "react": "^19.2.7",
+        "react-dom": "^19.2.7",
         "rvlib-ts-tools": "^0.2.0",
         "sharp": "^0.35.3"
     }

package/src/assets/kit-config.ts

@@ -5,6 +5,8 @@
 // Kit edits need a studio restart; prompt tweaks don't (overlay).
 import { existsSync } from 'fs'
 import { join } from 'path'
+import type { alphaHeight, toPng } from './image-ops.ts'
+import type { GroundRect } from './panels/geometry-rects.ts'
 
 export type AssetSpec = {
     id: string
@@ -61,6 +63,19 @@ export type KindMeta = {
     validate?: (data: unknown) => string[] | void
 }
 
+/** What a ship hook receives when a roll is picked (studio /api/pick). */
+export type ShipContext = {
+    assetId: string
+    file: string
+    asset: AssetSpec
+    kind: Kind
+    meta: unknown
+    rect: GroundRect | null
+    projectRoot: string
+    img: { toPng: typeof toPng; alphaHeight: typeof alphaHeight }
+}
+export type ShipFn = (ctx: ShipContext) => Promise<string | void>
+
 export type Kind = {
     id: string
     category: string
@@ -68,7 +83,9 @@ export type Kind = {
     generate: GeneratorSpec
     /** icon kinds get no geometry, thumbnails only */
     mode?: 'sprite' | 'icon'
-    ship?: { dir?: string; via?: string }
+    /** via = repo hook module path (default .rv-assets/ship.ts) · fn = a
+     *  built-in lib hook (e.g. identityKinds re-rendering the set) — never both */
+    ship?: { dir?: string; via?: string; fn?: ShipFn }
     meta?: KindMeta
 }
 
@@ -92,6 +109,7 @@ export function validateKit(k: KitConfig): string[] {
         if (kindIds.has(kind.id)) errs.push(`duplicate kind id '${kind.id}'`)
         kindIds.add(kind.id)
         if (kind.generate?.backend === 'comfy' && k.comfy == null) errs.push(`kind '${kind.id}' uses the comfy backend but the kit has no comfy config`)
+        if (kind.ship?.fn != null && kind.ship?.via != null) errs.push(`kind '${kind.id}': ship.fn and ship.via are two hooks for one pick — keep one`)
         if (!Array.isArray(kind.assets) || kind.assets.length === 0) errs.push(`kind '${kind.id}' has no assets — a silent no-op kind is a config mistake`)
         for (const a of kind.assets ?? []) {
             if (!a.id || typeof a.prompt !== 'string') errs.push(`kind '${kind.id}': asset needs id + prompt (got ${JSON.stringify(a).slice(0, 80)})`)

package/src/assets/kits/identity-kit.ts

@@ -1,12 +1,16 @@
-// kits/identity — favicon / logo / OG as asset kinds. Two paths:
-// - canvas mark: deterministic, instant — `renderIdentity` writes the whole
-//   set headlessly (the CLI `identity` command).
-// - comfy mark: the kinds go through the normal roll-and-pick studio loop
-//   (a placeholder-grade logo auto-accepted is a non-goal).
+// kits/identity — favicon / logo / OG as asset kinds. One render path
+// (renderIdentityFromMark: mark png → logo master 1024², favicon 512², og
+// card), two ways to get the mark:
+// - canvas mark: deterministic, instant — `shipkit assets identity` draws it
+//   headlessly and renders the set.
+// - comfy mark: roll-and-pick in the studio; the kind carries a BUILT-IN ship
+//   hook, so picking a logo roll re-renders the whole identity set from the
+//   picked png. Headless `identity` uses the current pick — no pick yet is a
+//   loud FAIL, never a placeholder.
 // Outputs are COMMITTED: public/favicon.png (512² master), public/og.png
 // (1200×630), public/logo.png. Brand data is per-repo and never defaults
 // across repos.
-import { createCanvas, type SKRSContext2D } from '@napi-rs/canvas'
+import { createCanvas, loadImage, type Image, type SKRSContext2D } from '@napi-rs/canvas'
 import { mkdirSync } from 'fs'
 import { dirname, join } from 'path'
 import sharp from 'sharp'
@@ -19,7 +23,11 @@ export type Brand = {
     palette: { bg: string; accent: string; ink: string }
     /** the mark: a canvas draw (deterministic) or a comfy generator (roll-and-pick) */
     mark: CanvasGen | ComfyGen
-    /** og layout hook — default: bg fill, mark left, name+tagline right */
+    /** comfy marks: the FULL generation prompt for identity-logo rolls
+     *  (style included — the studio shows/edits exactly this) */
+    markPrompt?: string
+    /** og layout hook — replaces the WHOLE default card (bg + mark left +
+     *  name/tagline right); the hook owns compositing the mark if it wants one */
     drawOg?: (ctx: SKRSContext2D, brand: Brand, size: { w: number; h: number }) => void
 }
 
@@ -28,36 +36,54 @@ export const OG_W = 1200
 export const OG_H = 630
 export const LOGO_SIZE = 1024
 
+/** the one next step when a comfy mark has no picked roll yet */
+export const NO_PICK_FIX = 'roll + pick in the studio: bun run assets → #identity-logo'
+
 export function identityKinds(brand: Brand): Kind[] {
     return [
         defineKind({
             id: 'identity-logo', category: 'Identity', mode: 'icon',
-            assets: [{ id: 'identity-logo', prompt: `logo mark for ${brand.name}`, label: 'logo' }],
+            assets: [{ id: 'identity-logo', prompt: brand.markPrompt ?? `logo mark for ${brand.name}`, label: 'logo' }],
             generate: brand.mark,
+            // built-in ship: picking a logo roll re-renders the WHOLE identity set
+            ship: { fn: async (ctx) => (await renderIdentityFromMark(brand, ctx.projectRoot, await sharp(ctx.file).png().toBuffer())).join(' + ') },
         }),
     ]
 }
 
-const defaultOg = (ctx: SKRSContext2D, brand: Brand, size: { w: number; h: number }): void => {
+// shrink px until text fits maxW (og cards must never clip the tagline)
+const fitFont = (ctx: SKRSContext2D, text: string, px: number, maxW: number, bold = false): void => {
+    for (; px > 12; px -= 2) {
+        ctx.font = `${bold ? 'bold ' : ''}${px}px sans-serif`
+        if (ctx.measureText(text).width <= maxW) return
+    }
+}
+
+const defaultOg = (ctx: SKRSContext2D, brand: Brand, size: { w: number; h: number }, mark: Image): void => {
     ctx.fillStyle = brand.palette.bg
     ctx.fillRect(0, 0, size.w, size.h)
     ctx.fillStyle = brand.palette.accent
     ctx.fillRect(0, size.h - 14, size.w, 14)
+    const pad = 72
+    const markSize = size.h - pad * 2
+    ctx.drawImage(mark, pad, pad, markSize, markSize)
+    const textX = pad + markSize + 64
+    const maxW = size.w - textX - 48
     ctx.fillStyle = brand.palette.ink
-    ctx.font = `bold ${Math.round(size.h / 6)}px sans-serif`
+    fitFont(ctx, brand.name, Math.round(size.h / 6), maxW, true)
     ctx.textBaseline = 'middle'
-    ctx.fillText(brand.name, 64, size.h / 2 - (brand.tagline != null ? size.h / 12 : 0))
+    ctx.fillText(brand.name, textX, size.h / 2 - (brand.tagline != null ? size.h / 12 : 0))
     if (brand.tagline != null) {
-        ctx.font = `${Math.round(size.h / 14)}px sans-serif`
         ctx.fillStyle = brand.palette.accent
-        ctx.fillText(brand.tagline, 66, size.h / 2 + size.h / 9)
+        fitFont(ctx, brand.tagline, Math.round(size.h / 14), maxW)
+        ctx.fillText(brand.tagline, textX + 2, size.h / 2 + size.h / 9)
     }
 }
 
-/** Headless render of the full identity set — canvas marks only (a comfy
- *  mark goes through the studio; this errors loud instead of guessing). */
-export async function renderIdentity(brand: Brand, root: string): Promise<string[]> {
-    if (brand.mark.backend !== 'canvas') throw new Error(`brand '${brand.name}' uses a comfy mark — roll + pick it in the studio; 'identity' renders canvas marks only`)
+/** THE identity writer — any mark png (canvas draw or picked comfy roll) →
+ *  public/logo.png (1024² master) + public/favicon.png (512² resize) +
+ *  public/og.png (default card: bg + mark left + name/tagline right). */
+export async function renderIdentityFromMark(brand: Brand, root: string, markPng: Buffer): Promise<string[]> {
     const out: string[] = []
     const write = async (rel: string, buf: Buffer): Promise<void> => {
         const path = join(root, rel)
@@ -65,16 +91,29 @@ export async function renderIdentity(brand: Brand, root: string): Promise<string
         await Bun.write(path, buf)
         out.push(rel)
     }
-    // logo master — the mark draws into a square canvas
-    const logo = createCanvas(LOGO_SIZE, LOGO_SIZE)
-    await brand.mark.draw(logo.getContext('2d'), { id: 'identity-logo', prompt: '' })
-    const logoPng = logo.toBuffer('image/png')
+    const logoPng = await sharp(markPng)
+        .resize(LOGO_SIZE, LOGO_SIZE, { fit: 'contain', background: { r: 0, g: 0, b: 0, alpha: 0 } })
+        .png().toBuffer()
     await write('public/logo.png', logoPng)
     // favicon = logo master resized to 512² (browsers derive the rest)
     await write('public/favicon.png', await sharp(logoPng).resize(FAVICON_SIZE, FAVICON_SIZE).png().toBuffer())
-    // og card
     const og = createCanvas(OG_W, OG_H)
-    ;(brand.drawOg ?? defaultOg)(og.getContext('2d'), brand, { w: OG_W, h: OG_H })
+    const ctx = og.getContext('2d')
+    if (brand.drawOg != null) brand.drawOg(ctx, brand, { w: OG_W, h: OG_H })
+    else defaultOg(ctx, brand, { w: OG_W, h: OG_H }, await loadImage(logoPng))
     await write('public/og.png', og.toBuffer('image/png'))
     return out
 }
+
+/** Headless render of the full identity set. Canvas marks draw themselves;
+ *  comfy marks need `markFile` = the PICKED roll (the caller resolves the
+ *  pick — run-assets does) and FAIL loud without one. */
+export async function renderIdentity(brand: Brand, root: string, opts?: { markFile?: string }): Promise<string[]> {
+    if (brand.mark.backend === 'canvas') {
+        const logo = createCanvas(LOGO_SIZE, LOGO_SIZE)
+        await brand.mark.draw(logo.getContext('2d'), { id: 'identity-logo', prompt: '' })
+        return renderIdentityFromMark(brand, root, logo.toBuffer('image/png'))
+    }
+    if (opts?.markFile == null) throw new Error(`brand '${brand.name}' uses a comfy mark and no roll is picked — ${NO_PICK_FIX}`)
+    return renderIdentityFromMark(brand, root, await sharp(opts.markFile).png().toBuffer())
+}

package/src/assets/run-assets.ts

@@ -2,13 +2,13 @@
 // parsing; these plain functions own the logic, print through injected
 // sinks, and return exit codes — 0 ok · 1 fail).
 import { existsSync } from 'fs'
-import { join } from 'path'
+import { join, relative } from 'path'
 import { randomSeed } from './gen/comfy-gen.ts'
 import { comfyResolver, generateRoll, type ComfyResolver } from './gen/generate-roll.ts'
 import { loadWorkflows } from './gen/workflow-loader.ts'
 import { allAssets, findAsset, loadKit, type ResolvedKit } from './kit-config.ts'
-import { renderIdentity, type Brand } from './kits/identity-kit.ts'
-import { assetDir, listRolls, readPromptOverlay } from './roll-workspace.ts'
+import { NO_PICK_FIX, renderIdentity, type Brand } from './kits/identity-kit.ts'
+import { assetDir, listRolls, readPick, readPromptOverlay } from './roll-workspace.ts'
 import { page } from './server/studio-page.ts'
 import { serveStudio } from './server/studio-server.ts'
 
@@ -91,7 +91,19 @@ export const runAssetsIdentity = (root: string, io: AssetsIo): Promise<number> =
         if (!existsSync(brandPath)) die('no .rv-identity/brand.ts — create one exporting a Brand (name, palette, mark)')
         const mod = (await import(brandPath)) as { default?: Brand }
         if (mod.default == null) die('.rv-identity/brand.ts must default-export the Brand')
-        const written = await renderIdentity(mod.default!, root)
+        const brand = mod.default!
+        let markFile: string | undefined
+        if (brand.mark.backend === 'comfy') {
+            // comfy marks render from the PICKED identity-logo roll — the kit
+            // owns the workspace where picks live
+            const kit = await loadKit(root).catch((e: Error) => die(`comfy mark needs the kit's roll workspace — ${e.message}`))
+            const dir = assetDir(join(root, kit.workspace), 'identity-logo')
+            const pick = await readPick(dir)
+            if (pick.pick == null) die(`brand '${brand.name}' uses a comfy mark and none is picked — ${NO_PICK_FIX}`)
+            markFile = join(dir, pick.pick!)
+            if (!existsSync(markFile)) die(`picked roll ${pick.pick} vanished from ${dir} — re-pick in the studio`)
+        }
+        const written = await renderIdentity(brand, root, { markFile })
         for (const w of written) io.print(`ok: ${w}`)
         return 0
     })
@@ -105,7 +117,15 @@ export const runAssetsCheck = (root: string, io: AssetsIo): Promise<number> =>
         if (kit.comfy != null) {
             try {
                 const wfs = await loadWorkflows(join(root, kit.comfy.workflows))
-                io.print(`ok: ${wfs.size} workflow pair(s) bound (${[...wfs.keys()].join(', ')})`)
+                io.print(`ok: ${wfs.size} workflow pair(s) bound`)
+                // provenance: where each pair lives + that both halves validated
+                // (loadWorkflows throws on any invalid pair, so reaching here = valid).
+                // There is no global workflow store — git owns each repo's pairs; the
+                // house library (wiki/build/comfyui/references) is the copy-from source.
+                for (const wf of wfs.values()) {
+                    const rel = relative(root, wf.jsonPath).replace(/\.json$/, '')
+                    io.print(`ok: workflow '${wf.id}' → ${rel}.{json,ts} (pair valid)`)
+                }
             } catch (e) {
                 io.print(`FAIL: ${(e as Error).message}`)
                 bad++

package/src/assets/server/studio-page.ts

@@ -42,6 +42,14 @@ button.ghost{background:var(--panel2);color:var(--ink);border:1px solid var(--li
 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);min-height:16px}
+.detnote{font-size:11px;color:var(--teal);line-height:1.25;max-width:150px}
+/* ── per-asset info surface (W2-2) ── */
+.info{display:none;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)}
 .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;display:none}
 .stage{position:relative;flex:1;min-height:0;display:flex;align-items:center;justify-content:center;padding:18px;overflow:hidden;
@@ -130,6 +138,7 @@ kbd{background:var(--panel2);border:1px solid var(--line);border-radius:4px;padd
   <div class=ctl>
    <select id=n><option>1</option><option selected>3</option><option>6</option><option>9</option><option>12</option></select>
    <button id=go disabled>Generate</button>
+   <div id=detnote class=detnote style="display:none">deterministic — rolls identical</div>
    <button id=qclear class=ghost title="drop queued jobs">clear queue</button>
   </div>
   <div class=promptwrap>
@@ -139,6 +148,7 @@ kbd{background:var(--panel2);border:1px solid var(--line);border-radius:4px;padd
   </div>
   <div class=ctl><div class=status id=status></div></div>
  </div>
+ <div class=info id=info></div>
  <div class=stage id=stage><div class=ph>Pick an asset on the left, then Generate.</div>
   <div class=plumb id=plumbL></div><div class=plumb id=plumbR></div>
   <div id=ov><div class=hdl></div><div class=arrow></div><div class=sz id=ovsz></div></div>
@@ -180,10 +190,11 @@ let lastSideSig=null,lastRollSig=null,catMode=null,lastCatSig=null,catRows=[]
 let rect=null,rectRatio=0.6,hasGeom=false,saveTimer=null
 const TEX=1024,MIX_UNIT=24,MIX_GROUND=44
 const V=()=>Date.now()>>13 // ~8s cache buckets: thumbs refresh without unique-URL spam
-const j=async(u,o)=>{const r=await fetch(u,o);return r.json()}
+const R=u=>u.replace(/^\\//,'') // resolve against the page URL: '/' standalone AND '/assets/' under the shipkit hub
+const j=async(u,o)=>{const r=await fetch(R(u),o);return r.json()}
 const post=(u,b)=>j(u,{method:'POST',body:JSON.stringify(b)})
-const imgUrl=(id,n)=>'/img?id='+encodeURIComponent(id)+'&name='+encodeURIComponent(n)+'&t='+V()
-const thumbUrl=id=>'/api/thumb?id='+encodeURIComponent(id)+'&t='+V()
+const imgUrl=(id,n)=>R('/img?id='+encodeURIComponent(id)+'&name='+encodeURIComponent(n)+'&t='+V())
+const thumbUrl=id=>R('/api/thumb?id='+encodeURIComponent(id)+'&t='+V())
 const esc=s=>String(s).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/"/g,'&quot;')
 const jsq=s=>String(s).replace(/\\\\/g,'\\\\\\\\').replace(/'/g,"\\\\'")
 // ── hash deep-links: #<asset-id> or #cat-<Category> ──
@@ -212,6 +223,24 @@ function renderSide(list){
    '</b><span>'+a.rolls+' rolls</span></div><div class="dot '+(a.picked?'done':(a.rolls?'some':''))+'"></div></div>').join('')
  }).join('')
 }
+// ── per-asset info surface (W2-2): backend, workflow provenance, ship target,
+//    meta file, kit source — so 'bun assets' is never a blank stare ──
+function renderInfo(info){
+ const box=$('#info')
+ if(!info){box.style.display='none';box.innerHTML='';return}
+ const chip=(k,v,cls)=>'<span class="chip'+(cls?' '+cls:'')+'"><b>'+esc(k)+'</b> '+v+'</span>'
+ const chips=[chip('backend',esc(info.backend))]
+ if(info.workflow){const w=info.workflow
+  if(w.id)chips.push(chip('workflow',esc(w.id)+(w.path?' <code>'+esc(w.path)+'</code>':'')))
+  else chips.push(chip('workflow',esc(w.note||'unresolved'),'warn'))}
+ const sh=info.ship
+ const shv=sh.mode==='hook'?'<code>'+esc(sh.path)+'</code>':
+  sh.mode==='built-in'?'built-in hook — '+esc(sh.note||''):esc(sh.note||'pick.json only')
+ chips.push(chip('ship',shv))
+ if(info.metaFile)chips.push(chip('meta','<code>'+esc(info.metaFile)+'</code>'))
+ chips.push(chip('kit','<code>'+esc(info.kitSource)+'</code> · '+esc(info.kindId)))
+ box.innerHTML=chips.join('');box.style.display='flex'
+}
 // ── asset view ──
 async function selectAsset(id,writeHash=true){
  exitCat()
@@ -230,6 +259,10 @@ async function selectAsset(id,writeHash=true){
  renderCustomTabs()
  $('#prompt').value=r.asset?r.asset.prompt:a.prompt
  $('#go').disabled=false;$('#saveprompt').disabled=false;$('#promptmsg').textContent=''
+ // deterministic canvas kinds: a slot machine with one outcome — cap rolls at 1
+ const det=!!(r.info&&r.info.deterministic),n=$('#n')
+ n.disabled=det;if(det)n.value='1';$('#detnote').style.display=det?'':'none'
+ renderInfo(r.info)
  await renderRolls(true);loadTab()
 }
 function setStage(src){
@@ -420,7 +453,7 @@ window.addEventListener('resize',positionOverlay)
 async function showCat(c,writeHash=true){
  catMode=c;cur=null;lastSideSig=null;lastCatSig=null
  if(writeHash)setHash('cat-'+c)
- $('#topbar').style.display='none';$('#stage').style.display='none';$('#strip').style.display='none'
+ $('#topbar').style.display='none';$('#stage').style.display='none';$('#strip').style.display='none';$('#info').style.display='none'
  $('#catgrid').style.display='block';$('#allcat').textContent=c
  openCats.add(c);renderSide(assets)
  await fillCat(true)