rvlib-shipkit 0.11.0 → 0.13.0

package/src/core/package-json-check.ts

@@ -1,88 +0,0 @@
-// built-in `package.json` probe for `shipkit check` — enforces the canonical
-// shape (meta/rv-conventions/package-json.md): private:true, no license,
-// capability-required script names FAIL, banned aliases + missing baseline
-// trio WARN. Doctor surface only — never wired into the ci gate. Pure local
-// fs, no TTL.
-import { existsSync } from 'fs'
-import { join } from 'path'
-import type { CheckCtx } from './check-ctx.ts'
-import type { RepoConfig } from '../repo-config.ts'
-
-type Pkg = { name?: string; private?: boolean; license?: string; scripts?: Record<string, string> }
-
-// alias → { canonical, bodyMatch } — WARN only when the body proves the
-// alias really is the canonical capability (a `serve` that serves a dist/
-// folder must not be told to rename)
-const ALIASES: Record<string, { canonical: string; bodyMatch: RegExp }> = {
-    'serve': { canonical: 'hub', bodyMatch: /(shipkit|cli\.ts) serve\b/ },
-    'identity': { canonical: 'assets:identity', bodyMatch: /assets(:| )identity\b/ },
-    'pretty': { canonical: 'fmt', bodyMatch: /./ },
-    'check-types': { canonical: 'typecheck', bodyMatch: /./ },
-}
-
-const BASELINE = ['test', 'lint', 'fmt'] as const
-
-export async function evaluatePackageJson(t: CheckCtx, root: string, c: RepoConfig): Promise<void> {
-    const spec = `${c.docsBase ?? ''}meta/rv-conventions/package-json.md`
-    let pkg: Pkg
-    try {
-        pkg = (await Bun.file(join(root, 'package.json')).json()) as Pkg
-    } catch (e) {
-        t.fail(`package.json unreadable (${String(e).slice(0, 120)})`, spec)
-        return
-    }
-    const scripts = pkg.scripts ?? {}
-    // rvlib-* as a probe ROOT is theoretical (libs live as sub-packages and
-    // the probe only runs where repo.config.ts loads) — field inversion is
-    // still handled so a future lib-root repo fails correctly, not absurdly
-    const isLib = pkg.name?.startsWith('rvlib-') === true
-
-    // published rvlib-* roots invert the field rules (distribute/npm owns them)
-    if (isLib) {
-        if (pkg.license !== 'MIT') t.fail(`package.json: rvlib-* package must carry license MIT`, spec)
-        if (pkg.private === true) t.fail(`package.json: rvlib-* package must not be private`, spec)
-    } else {
-        if (pkg.private !== true) t.fail(`package.json: "private": true is required`, spec)
-        if (pkg.license != null) t.fail(`package.json: license field is banned on project repos (rvlib-* sub-packages excepted)`, spec)
-    }
-
-    // aliases first — an alias satisfies the requirement but earns a WARN,
-    // never a double report (alias WARN + missing-canonical FAIL). A banned
-    // alias lingering NEXT TO its canonical still WARNs (sweep on sight),
-    // it just doesn't satisfy anything.
-    const aliased = new Set<string>()
-    for (const [name, a] of Object.entries(ALIASES)) {
-        const body = scripts[name]
-        if (body == null || !a.bodyMatch.test(body)) continue
-        if (scripts[a.canonical] == null) aliased.add(a.canonical)
-        t.warn(`package.json: script '${name}' is the house '${a.canonical}' — ${scripts[a.canonical] == null ? 'rename it' : `delete it ('${a.canonical}' exists)`}`, spec)
-    }
-
-    const has = (name: string): boolean => scripts[name] != null || aliased.has(name)
-
-    // capability → required script names (FAIL); repo.config.ts existence is
-    // implied — this probe only runs under `shipkit check`
-    const required: Array<{ name: string; why: string }> = [
-        { name: 'ci', why: 'shipkit repo' },
-        { name: 'check', why: 'shipkit repo' },
-        { name: 'contracts', why: 'shipkit repo' },
-        { name: 'tui', why: 'shipkit repo' },
-        { name: 'hub', why: 'shipkit repo' },
-        { name: 'mv', why: 'shipkit repo' },
-    ]
-    if (existsSync(join(root, '.rv-assets/kit.ts'))) required.push({ name: 'assets', why: '.rv-assets/kit.ts exists' })
-    if (existsSync(join(root, '.rv-identity/brand.ts'))) required.push({ name: 'assets:identity', why: '.rv-identity/brand.ts exists' })
-    if (existsSync(join(root, '.rv-comfy'))) required.push({ name: 'comfy:up', why: '.rv-comfy/ exists' })
-    if (existsSync(join(root, 'deploy.sh'))) required.push({ name: 'up', why: 'deploy.sh exists' })
-    if (existsSync(join(root, c.asks?.dir ?? 'asks'))) required.push({ name: 'asks', why: 'ask queue exists' })
-
-    const missing = required.filter((r) => !has(r.name))
-    for (const m of missing) t.fail(`package.json: missing script '${m.name}' (${m.why})`, spec)
-
-    const missingBaseline = BASELINE.filter((n) => !has(n))
-    if (missingBaseline.length > 0)
-        t.warn(`package.json: missing baseline script(s): ${missingBaseline.join(', ')}`, spec)
-
-    if (!t.failed && !t.warned)
-        t.ok(`package.json shape ok (private, no license, ${required.length} required scripts present)`)
-}

package/src/serve/hub-pages.ts

@@ -1,38 +0,0 @@
-// Shared hub-page plumbing. The hub UI itself is the Bun-native React app
-// in hub-app/ (HTML import, served by serve-hub.ts — build/webapp
-// doctrine). This module keeps what the LEGACY pages (graph pages, studio
-// SPA) still need until they migrate: the server-injected rail, and the
-// attention section types the collector + React app share.
-import type { HubTool } from './serve-hub.ts'
-
-const esc = (s: string): string => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/"/g, '&quot;')
-
-// ── the rail: thin fixed tab bar, injected into legacy hub-served pages ───
-const RAIL_ICONS: Record<string, string> = { '/': '⚡', '/graph/wiki': '🕸', '/graph/agent': '🤖', '/assets/': '🖼', '/status': '📊' }
-
-const RAIL_CSS = `
-.skrail{position:fixed;left:0;top:0;bottom:0;width:46px;z-index:9999;display:flex;flex-direction:column;
- align-items:center;padding-top:10px;gap:4px;background:#17140f;border-right:1px solid #332b22}
-.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:#262019;filter:none;opacity:1}
-.skrail a.on{background:#262019;border-left-color:#e88c28;filter:none;opacity:1}
-.skrail a i{position:absolute;top:4px;right:4px;width:8px;height:8px;border-radius:50%;background:#e05252}
-body{padding-left:46px}`
-
-/** Inject the rail into a legacy hub-served HTML document (post-<body>,
- *  fixed position — the page needs no layout knowledge). The React app
- *  renders its own identical rail from /hub.json. */
-export function withRail(html: string, o: { tools: HubTool[]; active: string }): string {
-    const items = [{ path: '/', label: 'attention', desc: 'everything red' }, ...o.tools.filter((t) => t.path !== '/')]
-        .map((t) => {
-            const on = o.active === t.path || (t.path !== '/' && o.active.startsWith(t.path))
-            const dot = t.path === '/' ? '<i id=skdot style="display:none"></i>' : ''
-            return `<a class="${on ? 'on' : ''}" href="${esc(t.path)}" title="${esc(t.label)} — ${esc(t.desc)}">${RAIL_ICONS[t.path] ?? '·'}${dot}</a>`
-        })
-        .join('')
-    // the red dot fetches client-side: a passive page nav must never run the
-    // needs projection server-side (cost + heal side-effects)
-    const dotScript = `<script>fetch('/api/needs.json').then(r=>r.json()).then(j=>{const n=(j.needs||[]).filter(x=>x.severity==='red').length;if(n>0)document.getElementById('skdot').style.display=''}).catch(()=>{})</script>`
-    return html.replace(/<body([^>]*)>/, `<body$1><style>${RAIL_CSS}</style><nav class=skrail>${items}</nav>${dotScript}`)
-}