rvlib-shipkit 0.6.0 → 0.8.0

package/src/serve/serve-hub.ts

@@ -9,7 +9,11 @@ import { join } from 'path'
 import { graphHtml } from 'rvlib-shipkit/src/wiki/graph-page.ts'
 import type { MdGraph } from 'rvlib-shipkit/src/wiki/md-graph.ts'
 import type { StudioRoutes } from '../assets/server/studio-server.ts'
-import { landingPage, statusPage } from './hub-pages.ts'
+import { withRail, type AttentionSection } from './hub-pages.ts'
+// the hub UI is a Bun-native React app (HTML import, no vite, no build) —
+// build/webapp doctrine; legacy pages (graphs, studio SPA) keep the
+// server-injected rail until they migrate
+import hubIndex from './hub-app/index.html'
 
 export type HubGraph = { title: string; load: () => MdGraph }
 export type HubTool = { path: string; label: string; desc: string }
@@ -25,6 +29,9 @@ export type HubDeps = {
     studio: StudioRoutes | null
     /** argv shelling the check run streamed by /status/run (test seam) */
     checkCmd: string[]
+    /** the / dashboard's data — everything red, gathered per request
+     *  (checks · asks · assets · contracts · posts; run-serve builds it) */
+    attention: () => Promise<AttentionSection[]>
 }
 export type Hub = { server: ReturnType<typeof Bun.serve>; tools: HubTool[]; stop: () => void }
 
@@ -40,24 +47,33 @@ export function hubTools(d: Pick<HubDeps, 'wikiGraph' | 'agentGraph' | 'studio'>
 
 export function serveHub(d: HubDeps): Hub {
     const tools = hubTools(d)
-    const html = (s: string): Response => new Response(s, { headers: { 'content-type': 'text/html; charset=utf-8' } })
+    // every HTML page carries the rail — one keystroke between surfaces;
+    // the red dot self-fetches client-side (no collector on passive navs)
+    const shell = (s: string, active: string): Response =>
+        new Response(withRail(s, { tools, active }), { headers: { 'content-type': 'text/html; charset=utf-8' } })
     const server: ReturnType<typeof Bun.serve> = Bun.serve({
         hostname: '127.0.0.1',
         port: d.port,
+        // / (attention dashboard) and /status are the React app — one HTML
+        // bundle, view picked by pathname client-side
+        routes: { '/': hubIndex, '/status': hubIndex },
         async fetch(req): Promise<Response> {
             const path = new URL(req.url).pathname
-            if (path === '/') return html(landingPage({ name: d.name, port: server.port ?? d.port, tools }))
             // identity probe: lets a second launch tell "same repo, another
             // window" from "a DIFFERENT repo hashed onto my port"
             if (path === '/hub.json') return Response.json({ hub: 'shipkit', name: d.name, tools })
-            if (path === '/graph/wiki') return html(graphHtml(d.wikiGraph.load(), { title: d.wikiGraph.title }))
-            if (path === '/graph/wiki/graph.json') return Response.json(d.wikiGraph.load())
-            if (d.agentGraph != null && path === '/graph/agent') return html(graphHtml(d.agentGraph.load(), { title: d.agentGraph.title }))
-            if (d.agentGraph != null && path === '/graph/agent/graph.json') return Response.json(d.agentGraph.load())
-            if (path === '/status') {
+            if (path === '/api/attention.json') {
+                const sections = await d.attention().catch((e: Error) => [{ title: 'attention collector broke', tone: 'red' as const, lines: [{ text: e.message }] }])
+                return Response.json({ sections })
+            }
+            if (path === '/api/status.json') {
                 const p = join(d.root, 'STATUS.md')
-                return html(statusPage({ name: d.name, statusMd: existsSync(p) ? await Bun.file(p).text() : null }))
+                return Response.json({ statusMd: existsSync(p) ? await Bun.file(p).text() : null })
             }
+            if (path === '/graph/wiki') return shell(graphHtml(d.wikiGraph.load(), { title: d.wikiGraph.title }), path)
+            if (path === '/graph/wiki/graph.json') return Response.json(d.wikiGraph.load())
+            if (d.agentGraph != null && path === '/graph/agent') return shell(graphHtml(d.agentGraph.load(), { title: d.agentGraph.title }), path)
+            if (d.agentGraph != null && path === '/graph/agent/graph.json') return Response.json(d.agentGraph.load())
             if (path === '/status/run' && req.method === 'POST') {
                 // stream wire lines as the check emits them; sh merges stderr
                 // so FAIL lines reach the page, not just the terminal
@@ -68,6 +84,11 @@ export function serveHub(d: HubDeps): Hub {
                 // the studio page fetches RELATIVE urls — it must live under
                 // the slash-terminated prefix for them to resolve
                 if (path === '/assets') return new Response(null, { status: 307, headers: { location: '/assets/' } })
+                if (path === '/assets/' && req.method === 'GET') {
+                    // the SPA document gets the rail too; API routes untouched
+                    const res = await d.studio.handle(req, '/')
+                    return shell(await res.text(), '/assets/')
+                }
                 if (path.startsWith('/assets/')) return d.studio.handle(req, path.slice('/assets'.length))
             }
             return new Response('not found', { status: 404 })

package/src/shipkit.ts

@@ -6,7 +6,8 @@ export type { RepoConfig, ServeConfig, FloorResolution, FloorSource } from './re
 export { serveHub, hubTools } from './serve/serve-hub.ts'
 export type { Hub, HubDeps, HubGraph, HubTool } from './serve/serve-hub.ts'
 export { runServe, resolveHubDeps, defaultHubPort } from './serve/run-serve.ts'
-export { landingPage, statusPage } from './serve/hub-pages.ts'
+export { withRail, attentionRedCount } from './serve/hub-pages.ts'
+export type { AttentionSection, AttentionLine } from './serve/hub-pages.ts'
 export { discoverChecks } from './core/discover-checks.ts'
 export type { DiscoveredCheck } from './core/discover-checks.ts'
 export { runTasks, selectTasks } from './core/task-runner.ts'
@@ -33,8 +34,8 @@ export type { Ask, CreateOpts } from './asks/asks-queue.ts'
 // assets surface (folded in from the standalone atelier lib; that npm
 // package is frozen). A repo's .rv-assets/kit.ts imports defineKit and
 // declares its kinds; `shipkit assets …` derives the rest.
-export { defineKit, defineKind, comfy, canvas, manual, mediaOf, MEDIA_EXTS, geometryPanel, gridPanel, customPanel, validateKit, missingPanelScripts, loadKit, findAsset, allAssets, categoriesOf } from './assets/kit-config.ts'
-export type { KitConfig, ResolvedKit, Kind, KindMeta, Media, AssetSpec, GeneratorSpec, ComfyGen, CanvasGen, ManualGen, PanelSpec, GeometryPanelSpec, GridPanelSpec, CustomPanelSpec, FoundAsset, ShipContext, ShipFn } from './assets/kit-config.ts'
+export { defineKit, defineKind, comfy, canvas, manual, gemini, mediaOf, MEDIA_EXTS, geometryPanel, gridPanel, customPanel, validateKit, missingPanelScripts, loadKit, findAsset, allAssets, categoriesOf } from './assets/kit-config.ts'
+export type { KitConfig, ResolvedKit, Kind, KindMeta, Media, AssetSpec, GeneratorSpec, ComfyGen, CanvasGen, ManualGen, GeminiGen, PanelSpec, GeometryPanelSpec, GridPanelSpec, CustomPanelSpec, FoundAsset, ShipContext, ShipFn } from './assets/kit-config.ts'
 export { identityKinds, renderIdentity, renderIdentityFromMark, NO_PICK_FIX, FAVICON_SIZE, OG_W, OG_H, LOGO_SIZE } from './assets/kits/identity-kit.ts'
 export type { Brand } from './assets/kits/identity-kit.ts'
 export { serveStudio, studioRoutes } from './assets/server/studio-server.ts'
@@ -57,3 +58,5 @@ export { lintMd } from './wiki/lint-md.ts'
 export { serveMdGraph } from './wiki/serve-graph.ts'
 export { graphHtml } from './wiki/graph-page.ts'
 export type { MdGraph, MdNode, MdEdge } from './wiki/md-graph.ts'
+export { movePage } from './mv/mv-md.ts'
+export type { MvIo, MvOpts } from './mv/mv-md.ts'

package/src/tui/run-tui.ts

@@ -13,7 +13,7 @@ import { TuiStore } from './tui-store.ts'
 
 export async function runTui(root: string): Promise<number> {
     const c = await loadRepoConfig(root)
-    // playbook (build/mobx): enforceActions warns on stray mutations — the
+    // playbook (build/mobx-mechanics): enforceActions warns on stray mutations — the
     // only signal. Read-warning flags stay off: useInput handler reads are
     // legitimately untracked and would false-positive.
     configure({ enforceActions: 'always' })

package/src/tui/tui-store.ts

@@ -1,4 +1,4 @@
-// TUI state — MobX per the house playbook (build/state + build/mobx):
+// TUI state — MobX per the house playbook (build/app-state-tree + build/mobx-mechanics):
 // `makeAutoObservable` WITH exceptions (the 2026-07-21 doctrine — no
 // decorators), runInAction around every post-await mutation. Panels are
 // plain data providers (no mobx): they signal mutations through update(),