rvlib-shipkit 1.1.0 → 1.2.0

package/src/serve/health-schedule.ts

@@ -1,102 +0,0 @@
-// THE HEALTH PASS TIMER. While the hub serves, the whole health pass runs once
-// a day, and once at startup when the last whole pass on record is older than
-// that. One timer for the repo, no per check schedule: a check's own `ttl` is
-// its cadence, and this pass is only the heartbeat that replays an answer
-// still fresh and re-measures one that expired.
-//
-// The run is the hub's own in process runner, the same path as the button, so
-// its rows land in the same run record. "When was the last pass" is read off
-// that record, which is what makes a `shipkit check` in a terminal count too.
-
-/** how often the health pass runs while the hub serves */
-export const HEALTH_EVERY_MS = 24 * 60 * 60 * 1000
-
-/** how often the timer looks. The pass itself is daily, this only bounds how
- *  late after its due time it starts */
-export const SCHEDULE_LOOK_MS = 5 * 60 * 1000
-
-export type ScheduleState = {
-    everyMs: number
-    /** when the last whole health pass on record started, null = none */
-    lastPassAt: number | null
-    /** when the next one starts: now when it is overdue */
-    nextAt: number
-    /** the timer's own pass is running right now */
-    running: boolean
-}
-
-export type ScheduleDeps = {
-    now: () => number
-    /** the last whole health pass on record, whoever ran it */
-    lastPassAt: () => number | null
-    /** another run in this process is going: the timer never stacks on it */
-    busy: () => boolean
-    /** the pass itself */
-    run: () => Promise<void>
-    everyMs?: number
-}
-
-export type TickResult = 'ran' | 'fresh' | 'busy'
-
-export class HealthSchedule {
-    readonly everyMs: number
-    running = false
-    /** when this timer last STARTED a pass. A pass that dies before it writes
-     *  a record would otherwise be due again at the very next look */
-    private attemptedAt: number | null = null
-    private timer: ReturnType<typeof setInterval> | null = null
-
-    constructor(private readonly d: ScheduleDeps) {
-        this.everyMs = d.everyMs ?? HEALTH_EVERY_MS
-    }
-
-    /** the newest of the record and this timer's own last attempt */
-    private lastAt(): number | null {
-        const rec = this.d.lastPassAt()
-        if (rec == null) return this.attemptedAt
-        return this.attemptedAt == null ? rec : Math.max(rec, this.attemptedAt)
-    }
-
-    due(): boolean {
-        const last = this.lastAt()
-        return last == null || this.d.now() - last >= this.everyMs
-    }
-
-    state(): ScheduleState {
-        const now = this.d.now()
-        const last = this.lastAt()
-        return {
-            everyMs: this.everyMs,
-            lastPassAt: this.d.lastPassAt(),
-            nextAt: last == null ? now : Math.max(now, last + this.everyMs),
-            running: this.running,
-        }
-    }
-
-    /** one look: run the pass when it is due and nothing else is running */
-    async tick(): Promise<TickResult> {
-        if (this.running || this.d.busy()) return 'busy'
-        if (!this.due()) return 'fresh'
-        this.running = true
-        this.attemptedAt = this.d.now()
-        try {
-            await this.d.run()
-        } finally {
-            this.running = false
-        }
-        return 'ran'
-    }
-
-    /** look now, then every SCHEDULE_LOOK_MS. A second start is a no-op */
-    start(onError: (e: Error) => void, lookMs = SCHEDULE_LOOK_MS): void {
-        if (this.timer != null) return
-        const look = (): void => void this.tick().catch((e: Error) => onError(e))
-        look()
-        this.timer = setInterval(look, lookMs)
-    }
-
-    stop(): void {
-        if (this.timer != null) clearInterval(this.timer)
-        this.timer = null
-    }
-}

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

@@ -1,65 +0,0 @@
-/* the project gutter. It is FIXED to the left edge, so it takes no cell of
-   the .app grid, and the page makes room for it by padding, whatever the
-   grid holds. Colours are hub.css tokens only, spacing is its scale:
-   tests/hub-css-invariants.test.ts reads this sheet too. */
-.app:has(> .pgut){--gut:44px;padding-left:var(--gut)}
-.pgut{position:fixed;left:0;top:0;bottom:0;width:var(--gut,44px);z-index:5;display:flex;flex-direction:column;align-items:center;
- gap:var(--s1);padding:var(--s2) 0;background:var(--bg);border-right:1px solid var(--line);overflow-y:auto;scrollbar-width:none}
-.pgt{position:relative;flex:none;width:32px;height:32px;display:flex;align-items:center;justify-content:center;padding:0;
- background:transparent;border:0;border-radius:6px;cursor:pointer}
-.pgt:hover{background:var(--panel2)}
-.pgt.cur{background:var(--sel)}
-.pgt img{width:24px;height:24px;border-radius:5px;object-fit:cover;pointer-events:none}
-/* the initial on a hue hashed from the name (projects-svc hueOf) */
-.pgi{width:24px;height:24px;border-radius:5px;display:flex;align-items:center;justify-content:center;
- font-size:12px;font-weight:600;user-select:none;color:var(--c);background:color-mix(in srgb,var(--c) 22%,var(--panel2))}
-.pgi.h1{--c:var(--k1)}
-.pgi.h2{--c:var(--k2)}
-.pgi.h3{--c:var(--k3)}
-.pgi.h4{--c:var(--k4)}
-.pgi.h5{--c:var(--k5)}
-.pgi.h6{--c:var(--k6)}
-/* the face says three things and no more (projects-svc faceOf) */
-/* closed in VS Code: the icon dims, the badge does not */
-.pgt.dim img,.pgt.dim .pgi{opacity:.45}
-/* the one badge: open asks, top right */
-.pga{position:absolute;top:0;right:0;min-width:14px;height:14px;padding:0 var(--s0);border-radius:7px;
- font-size:9px;font-weight:700;line-height:14px;text-align:center;color:var(--bg);background:var(--warn)}
-/* Claude sessions running: a thin edge on the left that breathes */
-.pgs{position:absolute;left:0;top:6px;bottom:6px;width:2px;border-radius:1px;background:var(--accent);pointer-events:none;animation:pgpulse 2.4s ease-in-out infinite}
-@keyframes pgpulse{0%,100%{opacity:1}50%{opacity:.25}}
-@media (prefers-reduced-motion:reduce){.pgs{animation:none}}
-/* the hover card: right of the rail, one at a time, never interactive.
-   Header, then what needs a human, then the label and value rows of the
-   check page (.wfact .wk .wv from hub.css) */
-.pgcard{position:fixed;left:calc(var(--gut,44px) + var(--s2));z-index:20;width:300px;padding:var(--s3);pointer-events:none;
- background:var(--panel);border:1px solid var(--line);border-radius:4px;box-shadow:0 6px 20px var(--shadow);font-size:12px;line-height:1.45;color:var(--ink)}
-.pgch{display:flex;align-items:center;gap:var(--s2);min-width:0}
-.pgcface{flex:none;display:flex}
-.pgcface img,.pgcface .pgi{width:20px;height:20px;border-radius:4px;font-size:11px}
-.pgcname{flex:1;min-width:0;font-size:13px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
-.pgcthis{font-weight:400;font-size:11px;color:var(--dim)}
-.pgcver{flex:none;color:var(--dim);font-size:11px;font-variant-numeric:tabular-nums}
-.pgcline{margin-top:var(--s1);color:var(--dim);font-size:11px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
-.pgcdesc{margin-top:var(--s1);color:var(--dim);font-size:11px;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;overflow:hidden}
-/* NEEDS YOU: a warn toned bullet, set apart from the facts */
-.pgcneeds{margin-top:var(--s2);padding:var(--s1) var(--s2);border-left:2px solid var(--warn);background:var(--panel2);border-radius:0 3px 3px 0}
-.pgcneed{display:flex;gap:var(--s1);min-width:0;color:var(--warn)}
-.pgcneed.red{color:var(--red);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
-.pgcask{flex:1;min-width:0;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
-.pgcmore{flex:none}
-.pgcfacts{margin-top:var(--s2)}
-.pgcfacts .wk{flex-basis:64px;white-space:nowrap}
-.pgcfacts .wv{text-align:right;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;word-break:normal}
-.pgcfacts .wv.warn{color:var(--warn)}
-.pgerr{font-size:12px;font-weight:700;color:var(--red);cursor:help}
-/* the one time sort by last activity, above the icons */
-.pgsort{flex:none;width:32px;height:20px;padding:0;background:transparent;border:1px solid var(--line);border-radius:3px;
- color:var(--dim);font-size:12px;line-height:18px;cursor:pointer}
-.pgsort:hover{color:var(--ink);border-color:var(--accent)}
-/* a drag: the tile being moved fades, and the gap it would land in is a line
-   drawn on a tile edge, centred in the gap between two tiles */
-.pgt.dragging{opacity:.4}
-.pgt.dropb::before,.pgt.dropa::after{content:'';position:absolute;left:2px;right:2px;height:2px;border-radius:1px;background:var(--accent);pointer-events:none}
-.pgt.dropb::before{top:-3px}
-.pgt.dropa::after{bottom:-3px}

package/src/serve/hub-app/project-gutter.tsx

@@ -1,128 +0,0 @@
-// the project gutter: one icon per repo that shares this hub's house wiki,
-// down the far left of the page. The face stays quiet (faceOf): at most one
-// badge, the open asks; the icon dims while VS Code does not have the folder
-// open; a thin edge pulses while Claude sessions run in it; the selected
-// background marks this hub's own repo. Everything else is the hover card,
-// shown at once to the right of the icon. A click opens the folder in VS
-// Code, a drag reorders the rail, and the button on top sorts it once by
-// last activity. Fixed position, so it takes no cell of the page grid
-// (project-gutter.css).
-import { observer } from 'mobx-react-lite'
-import { useEffect, useLayoutEffect, useRef } from 'react'
-import type { HubSt } from './hub-st.ts'
-import { cardModel, faceOf, hueOf, type Project } from './projects-svc.ts'
-
-export const Tile = observer(({ app, p, i }: { app: HubSt; p: Project; i: number }) => {
-    const s = app.projects
-    const gap = s.shownGap
-    const face = faceOf(p)
-    // the drop line rides on a tile edge, so showing it moves nothing
-    const edge = gap === i ? ' dropb' : gap === i + 1 && i === s.list.length - 1 ? ' dropa' : ''
-    const cls = `pgt${p.current ? ' cur' : ''}${face.dim ? ' dim' : ''}${s.drag === p.name ? ' dragging' : ''}${edge}`
-    return (
-    <button className={cls} aria-label={p.name}
-        draggable onClick={() => void s.open(p.name)}
-        onMouseEnter={(e) => {
-            const r = e.currentTarget.getBoundingClientRect()
-            s.hoverIn(p.name, r.top + r.height / 2)
-        }}
-        onMouseLeave={() => s.hoverOut(p.name)}
-        onDragStart={(e) => {
-            e.dataTransfer.effectAllowed = 'move'
-            e.dataTransfer.setData('text/plain', p.name)
-            s.dragStart(p.name)
-        }}
-        onDragOver={(e) => {
-            if (s.drag == null) return
-            e.preventDefault()
-            const r = e.currentTarget.getBoundingClientRect()
-            s.dragOver(i, e.clientY - r.top, r.height)
-        }}
-        onDrop={(e) => {
-            e.preventDefault()
-            s.drop()
-        }}
-        onDragEnd={() => s.dragEnd()}>
-        <Face p={p} />
-        {face.badge != null ? <b className="pga">{face.badge}</b> : null}
-        {face.busy ? <i className="pgs" /> : null}
-    </button>
-    )
-})
-
-const Face = ({ p }: { p: Project }) => (p.icon != null
-    ? <img src={p.icon} alt="" draggable={false} />
-    : <span className={`pgi h${hueOf(p.name)}`}>{(p.name.match(/[a-zA-Z]/)?.[0] ?? p.name.charAt(0)).toUpperCase()}</span>)
-
-/** the card for one repo: header, what needs a human, then the fact rows,
- *  in the label and value shape the check page's WHAT widget uses */
-export const Card = ({ p, now }: { p: Project; now: number }) => {
-    const m = cardModel(p, now)
-    return (
-        <>
-            <div className="pgch">
-                <span className="pgcface"><Face p={p} /></span>
-                <b className="pgcname">{m.head.name}{m.head.current ? <span className="pgcthis"> this hub</span> : null}</b>
-                {m.head.version == null ? null : <span className="pgcver">v{m.head.version.replace(/^v/, '')}</span>}
-            </div>
-            {m.head.branch == null ? null : <div className="pgcline">{m.head.branch}</div>}
-            {m.head.description == null ? null : <div className="pgcdesc">{m.head.description}</div>}
-            {m.needs == null ? null : (
-                <div className="pgcneeds">
-                    {m.needs.asks == null ? null : (
-                        <div className="pgcneed">
-                            <span className="pgcask">{m.needs.asks.count} ask{m.needs.asks.count === 1 ? '' : 's'}: {m.needs.asks.titles.join(' · ')}</span>
-                            {m.needs.asks.more > 0 ? <span className="pgcmore">+{m.needs.asks.more}</span> : null}
-                        </div>
-                    )}
-                    {m.needs.gate == null ? null : <div className="pgcneed red">{m.needs.gate}</div>}
-                </div>
-            )}
-            {m.facts.length === 0 ? null : (
-                <div className="pgcfacts">
-                    {m.facts.map((f) => (
-                        <div key={f.k} className="wfact">
-                            <span className="wk">{f.k}</span>
-                            <span className={`wv${f.tone == null ? '' : ` ${f.tone}`}`}>{f.v}</span>
-                        </div>
-                    ))}
-                </div>
-            )}
-        </>
-    )
-}
-
-/** the one hover card: right of the rail, centred on the icon's row, then
- *  clamped into the viewport once its own height is known */
-export const HoverCard = observer(({ app }: { app: HubSt }) => {
-    const s = app.projects
-    const p = s.hovered
-    const y = s.hover?.y ?? 0
-    const ref = useRef<HTMLDivElement>(null)
-    useLayoutEffect(() => {
-        const el = ref.current
-        if (el == null) return
-        const h = el.offsetHeight
-        el.style.top = `${Math.max(8, Math.min(y - h / 2, window.innerHeight - h - 8))}px`
-    })
-    if (p == null) return null
-    return (
-        <div ref={ref} className="pgcard" role="tooltip">
-            <Card p={p} now={Date.now()} />
-        </div>
-    )
-})
-
-export const ProjectGutter = observer(({ app }: { app: HubSt }) => {
-    useEffect(() => app.projects.start(), [app])
-    const s = app.projects
-    if (s.list.length === 0 && s.error === '') return null
-    return (
-        <nav className="pgut" aria-label="projects">
-            <button className="pgsort" title="sort by last activity, once: the result is the new manual order" onClick={() => s.sortByActivity()}>⇅</button>
-            {s.list.map((p, i) => <Tile key={p.name} app={app} p={p} i={i} />)}
-            {s.error !== '' ? <span className="pgerr" title={s.error}>!</span> : null}
-            <HoverCard app={app} />
-        </nav>
-    )
-})