rvlib-shipkit 1.6.0 → 1.8.0

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

@@ -57,6 +57,8 @@
 .hwidget{flex:0 1 auto;max-width:100%;padding:var(--s0) var(--s2);border:1px solid var(--line);border-radius:3px;font-size:12px;line-height:1.4;overflow:auto}
 .hwidget h3{margin:0;font-size:12px;font-weight:650;white-space:nowrap}
 .hwidget h3 .hdim{font-weight:400}
+.hwidget h3 .hwre{width:16px;height:16px;margin-left:var(--s1)}
+.hwidget h3 .hwre .hico{width:12px;height:12px}
 /* meters in two columns: <table class="wmeters">, label · bar · value, twice a row */
 .wmeters td{padding-right:var(--s1)}
 .wmeters td:nth-child(3n){padding-right:var(--s3)}

package/src/serve/hub-app/home-strip.tsx

@@ -211,6 +211,10 @@ const Monitor = observer(({ m }: { m: MachineSt }) => {
                                 {x.title}
                                 {head == null ? null : <span className="hdim"> · <span dangerouslySetInnerHTML={{ __html: head }} /></span>}
                                 {x.error != null && x.html != null ? <i className="gpwarn" title={x.error} /> : null}
+                                <button className="gpi hwre" aria-label="refresh" disabled={m.refreshing.has(`${x.repo}/${x.id}`)} onClick={() => void m.refreshWidget(x.repo, x.id)}
+                                    title="render it again now, skipping any wait it keeps between samples">
+                                    {m.refreshing.has(`${x.repo}/${x.id}`) ? <span className="spin" /> : <Icon d={ICON.restart} />}
+                                </button>
                             </h3>
                             {x.html != null ? <div dangerouslySetInnerHTML={{ __html: body }} />
                                 : x.error != null ? <div className="hwerr">{x.error}</div>

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

@@ -11,6 +11,7 @@
   <link rel="stylesheet" href="./planned.css" />
   <link rel="stylesheet" href="./when.css" />
   <link rel="stylesheet" href="./activity.css" />
+  <link rel="stylesheet" href="./insights.css" />
   <link rel="stylesheet" href="./readme.css" />
   <link rel="stylesheet" href="./dock.css" />
   <link rel="stylesheet" href="./controls.css" />

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

@@ -37,6 +37,7 @@ import { LIST, SIDEBAR } from './layout-st.ts'
 import { ArchivedView, HomeStrip, NotUp, Overview } from './home-strip.tsx'
 import { PlannedView } from './planned-view.tsx'
 import { ActivityView } from './activity-view.tsx'
+import { InsightsView } from './insights-view.tsx'
 import { Palette } from './palette-view.tsx'
 import { SCREEN_WAIT_MS } from './screen-cache.ts'
 import { isSearchKey, pageKey, sectionKey } from './keys.ts'
@@ -320,6 +321,7 @@ const App = observer(() => {
                             {home.page === 'overview' ? <Overview app={home} /> : null}
                             {home.page === 'planned' ? <PlannedView app={home} /> : null}
                             {home.page === 'activity' ? <ActivityView app={home} /> : null}
+                            {home.page === 'insights' ? <InsightsView app={home} /> : null}
                             {home.page === 'archived' ? <ArchivedView app={home} /> : null}
                             {home.visited.map((r) => <RepoView key={r.key} app={r} />)}
                         </Panel>

package/src/serve/hub-app/icons.tsx

@@ -12,6 +12,7 @@ export const ICON = {
     reflections: 'M4 3.5h12v9H9l-4 3.5v-3.5H4zM7.5 7h5M7.5 9.5h3',
     monitor: 'M3 4h14v9H3zM7 16.5h6M10 13v3.5',
     archived: 'M2.5 4h15v3.5h-15zM4 7.5V16h12V7.5M8 10.5h4',
+    insights: 'M3 16.5h14M5 16.5V11M9 16.5V5M13 16.5V8.5M17 16.5V12',
     home: 'M3 9.5 10 3.5l7 6M5 8v8.5h10V8M8.5 16.5v-4.5h3v4.5',
     planned: 'M5.5 3h9M5.5 17h9M6.5 3c0 4 7 4 7 7s-7 3-7 7M13.5 3c0 4-7 4-7 7s7 3 7 7',
     browser: 'M10 2.5a7.5 7.5 0 1 0 0 15a7.5 7.5 0 1 0 0-15M2.5 10h15M10 2.5c-3 3-3 12 0 15M10 2.5c3 3 3 12 0 15',

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

@@ -11,6 +11,7 @@
   <link rel="stylesheet" href="./planned.css" />
   <link rel="stylesheet" href="./when.css" />
   <link rel="stylesheet" href="./activity.css" />
+  <link rel="stylesheet" href="./insights.css" />
   <link rel="stylesheet" href="./readme.css" />
   <link rel="stylesheet" href="./dock.css" />
   <link rel="stylesheet" href="./controls.css" />

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

@@ -0,0 +1,111 @@
+// the insights page's state: the daemon's boxes for one scope, the tag that
+// filters which boxes show, and one query that filters every box's rows. It
+// reads once when the page shows and on the refresh button, never on a clock:
+// manifests change far slower than anyone reads them. The scope and the tag
+// are remembered per viewer.
+import { makeAutoObservable, observableRef, runInAction } from 'mobx'
+import { rowMatches, SCOPES, tagsOf, type InsightBox, type InsightRow, type InsightsAnswer, type Scope } from '../../home/insights-shape.ts'
+import type { HomeSt } from './home-st.ts'
+import { ownTrouble, reach } from './reach.ts'
+
+/** the rows a box shows before its "show all" */
+export const BOX_ROWS = 25
+const SCOPE_KEY = 'home:insights:scope'
+const TAG_KEY = 'home:insights:tag'
+
+function kept(key: string): string | null {
+    try {
+        return globalThis.localStorage?.getItem(key) ?? null
+    } catch {
+        return null
+    }
+}
+function keep(key: string, v: string): void {
+    try { globalThis.localStorage?.setItem(key, v) } catch { /* private window: the pick lasts the tab */ }
+}
+
+export class InsightsSt {
+    data: InsightsAnswer | null = null
+    error = ''
+    loading = false
+    scope: Scope = (SCOPES as readonly string[]).includes(kept(SCOPE_KEY) ?? '') ? (kept(SCOPE_KEY) as Scope) : 'house'
+    /** the tag whose boxes show, null for every box */
+    tag: string | null = kept(TAG_KEY) || null
+    query = ''
+    /** boxes showing every row, past BOX_ROWS */
+    full = new Set<string>()
+    /** `box/key` of each row whose uses show under it */
+    open = new Set<string>()
+    private gen = 0
+
+    constructor(private st: HomeSt) {
+        makeAutoObservable<this, 'st' | 'gen'>(this, { st: false, gen: false, data: observableRef })
+    }
+
+    get tags(): string[] {
+        return tagsOf(this.data?.boxes ?? [])
+    }
+
+    /** the boxes the tag lets through, each with the rows the query lets through */
+    get boxes(): { box: InsightBox; rows: InsightRow[] }[] {
+        return (this.data?.boxes ?? [])
+            .filter((b) => this.tag == null || !this.tags.includes(this.tag) || b.tags.includes(this.tag))
+            .map((box) => ({ box, rows: box.rows.filter((r) => rowMatches(box, r, this.query)) }))
+    }
+
+    setScope(s: Scope): void {
+        if (s === this.scope) return
+        this.scope = s
+        keep(SCOPE_KEY, s)
+        void this.load()
+    }
+
+    setTag(t: string | null): void {
+        this.tag = t
+        keep(TAG_KEY, t ?? '')
+    }
+
+    setQuery(q: string): void {
+        this.query = q
+    }
+
+    toggleFull(box: string): void {
+        if (this.full.has(box)) this.full.delete(box)
+        else this.full.add(box)
+    }
+
+    toggleRow(box: string, key: string): void {
+        const k = `${box}/${key}`
+        if (this.open.has(k)) this.open.delete(k)
+        else this.open.add(k)
+    }
+
+    openRepo(name: string): void {
+        this.st.select(name)
+    }
+
+    /** the refresh button: the daemon reads every manifest again */
+    refresh(): void {
+        if (!this.loading) void this.load(true)
+    }
+
+    async load(fresh = false): Promise<void> {
+        const id = ++this.gen
+        this.loading = true
+        try {
+            const r = await reach(`/api/home/insights.json?scope=${this.scope}${fresh ? '&fresh=1' : ''}`, { signal: AbortSignal.timeout(60_000) })
+            if (!r.ok) throw new Error(`${r.status} ${await r.text()}`)
+            const j = (await r.json()) as InsightsAnswer
+            runInAction(() => { if (id === this.gen) { this.data = j; this.error = '' } })
+        } catch (e) {
+            runInAction(() => { if (id === this.gen) this.error = ownTrouble(e, this.st.machine) })
+        } finally {
+            runInAction(() => { if (id === this.gen) this.loading = false })
+        }
+    }
+
+    /** reads when the page shows */
+    start(): void {
+        void this.load()
+    }
+}

package/src/serve/hub-app/insights-view.tsx

@@ -0,0 +1,112 @@
+// `/insights`: boxes about every repo of a scope, each carrying tags. On top:
+// the scope (house repos or all of ~/dev), the tag row that filters the boxes,
+// one query that filters every box's rows, and the refresh. A box lists its
+// rows by how many repos use each key; a click on a row shows every use, the
+// house repos as links to their page.
+import { observer } from 'mobx-react-lite'
+import { placeWords, type InsightBox, type InsightRow, type Scope } from '../../home/insights-shape.ts'
+import type { HomeSt } from './home-st.ts'
+import { plainClick, repoPage } from './home-st.ts'
+import { BOX_ROWS } from './insights-st.ts'
+
+const SCOPE_WORDS: Record<Scope, { label: string; title: string }> = {
+    house: { label: 'house', title: 'the repos on the project list' },
+    dev: { label: '~/dev', title: 'every folder of ~/dev with a package.json or a .git, wired or not' },
+}
+
+/** the values a row shows inline before "+n" */
+const VALUES_SHOWN = 3
+
+const Row = observer(({ app, box, r }: { app: HomeSt; box: InsightBox; r: InsightRow }) => {
+    const st = app.insights
+    const open = st.open.has(`${box.id}/${r.key}`)
+    const house = new Set(app.projects.list.map((p) => p.name))
+    return (
+        <>
+            <tr className={`inrow${open ? ' open' : ''}`} onClick={() => st.toggleRow(box.id, r.key)} title={`${r.uses.length} use${r.uses.length === 1 ? '' : 's'}: click to list them`}>
+                <td className="inkey">{r.key}</td>
+                <td className="incount">{r.repos}</td>
+                <td className="invals">
+                    {r.values.slice(0, VALUES_SHOWN).map((v) => <code key={v}>{v}</code>)}
+                    {r.values.length > VALUES_SHOWN ? <span className="acdim"> +{r.values.length - VALUES_SHOWN}</span> : null}
+                </td>
+            </tr>
+            {!open ? null : r.uses.map((u, i) => (
+                <tr key={i} className="inuse">
+                    <td className="inplace">
+                        {house.has(u.repo) ? (
+                            <a href={repoPage(u.repo)} onClick={(e) => {
+                                if (!plainClick(e)) return
+                                e.preventDefault()
+                                st.openRepo(u.repo)
+                            }}>{placeWords(u)}</a>
+                        ) : placeWords(u)}
+                    </td>
+                    <td colSpan={2} className="invals"><code>{u.value}</code>{u.dev ? <span className="acdim"> dev</span> : null}</td>
+                </tr>
+            ))}
+        </>
+    )
+})
+
+const Box = observer(({ app, box, rows }: { app: HomeSt; box: InsightBox; rows: InsightRow[] }) => {
+    const st = app.insights
+    const full = st.full.has(box.id)
+    const shown = full ? rows : rows.slice(0, BOX_ROWS)
+    return (
+        <section className="inbox">
+            <h3>
+                <span>{box.title}</span>
+                {box.tags.map((t) => <button key={t} className={`intag${st.tag === t ? ' on' : ''}`} onClick={() => st.setTag(st.tag === t ? null : t)}>{t}</button>)}
+                <span className="sp" />
+                <span className="acdim">{rows.length === box.rows.length ? rows.length : `${rows.length} of ${box.rows.length}`}</span>
+            </h3>
+            <p className="acdim">{box.hint}</p>
+            {rows.length === 0 ? <p className="acdim">no {box.noun} matches</p> : (
+                <table className="intable">
+                    <colgroup><col /><col className="c-count" /><col /></colgroup>
+                    <thead><tr><th>{box.noun}</th><th>repos</th><th>values</th></tr></thead>
+                    <tbody>{shown.map((r) => <Row key={r.key} app={app} box={box} r={r} />)}</tbody>
+                </table>
+            )}
+            {rows.length > BOX_ROWS ? <button className="ghost hsm inmore" onClick={() => st.toggleFull(box.id)}>{full ? `show the first ${BOX_ROWS}` : `show all ${rows.length}`}</button> : null}
+        </section>
+    )
+})
+
+export const InsightsView = observer(({ app }: { app: HomeSt }) => {
+    const st = app.insights
+    const d = st.data
+    return (
+        <div className="hall activity insights">
+            <div className="actop">
+                <div className="acwin" role="radiogroup" aria-label="which repos">
+                    {(Object.keys(SCOPE_WORDS) as Scope[]).map((s) => (
+                        <button key={s} role="radio" aria-checked={st.scope === s} className={st.scope === s ? 'on' : ''} title={SCOPE_WORDS[s].title} onClick={() => st.setScope(s)}>{SCOPE_WORDS[s].label}</button>
+                    ))}
+                </div>
+                <div className="acwin" role="radiogroup" aria-label="which boxes">
+                    <button role="radio" aria-checked={st.tag == null} className={st.tag == null ? 'on' : ''} onClick={() => st.setTag(null)}>all</button>
+                    {st.tags.map((t) => <button key={t} role="radio" aria-checked={st.tag === t} className={st.tag === t ? 'on' : ''} onClick={() => st.setTag(t)}>{t}</button>)}
+                </div>
+                <input className="inquery" type="search" placeholder="filter: a package, a script…" aria-label="filter every box" value={st.query} onChange={(e) => st.setQuery(e.currentTarget.value)} />
+                <button type="button" className="acpill" disabled={st.loading} onClick={() => st.refresh()} title="read every package.json again now · an answer is kept 5 minutes">
+                    <span className={`acring${st.loading ? ' on' : ''}`}>↻</span>
+                </button>
+                {d == null ? <span className="acdim">reading every package.json…</span> : (
+                    <>
+                        <span className="acpill">{d.repos} repos</span>
+                        <span className="acpill">{d.files} package.json</span>
+                        <span className="acpill">read in {d.ms}ms</span>
+                    </>
+                )}
+            </div>
+            {st.error !== '' ? <div className="hnote">{st.error}</div> : null}
+            {d != null && d.errors.length > 0 ? <div className="hnote" title={d.errors.join('\n')}>{d.errors.length} package.json would not parse</div> : null}
+            <div className={`ingrid${d != null && d.scope !== st.scope ? ' stale' : ''}`}>
+                {st.boxes.map(({ box, rows }) => <Box key={box.id} app={app} box={box} rows={rows} />)}
+            </div>
+            <p className="hdim">in the console: shipkit insights</p>
+        </div>
+    )
+})

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

@@ -0,0 +1,24 @@
+/* the insights page (insights-view.tsx): the activity page's top bar, then a
+   grid of boxes. A row opens in place to list its uses. */
+.ingrid{display:grid;grid-template-columns:repeat(auto-fill,minmax(min(100%,460px),1fr));gap:var(--s3);align-items:start}
+.ingrid.stale{opacity:.5}
+.inbox{border:1px solid var(--line);border-radius:4px;padding:var(--s2) var(--s3);min-width:0}
+.inbox h3{display:flex;align-items:center;gap:var(--s2);margin:0;font-size:13px;font-weight:650}
+.inbox > p{margin:var(--s0) 0 var(--s2);font-size:12px}
+.intag{border:1px solid var(--line);border-radius:999px;padding:0 var(--s2);background:none;color:var(--dim);font-size:11px;font-weight:400;line-height:18px;cursor:pointer}
+.intag:hover,.intag.on{color:var(--accent);border-color:var(--accent)}
+.inquery{height:22px;min-width:200px;box-sizing:border-box;background:var(--bg);color:var(--ink);border:1px solid var(--line);border-radius:4px;padding:0 var(--s2);font:inherit;font-size:12px}
+.inquery:focus{outline:none;border-color:var(--accent)}
+.intable{width:100%;table-layout:fixed;border-collapse:collapse}
+.intable col.c-count{width:56px}
+.intable th{text-align:left;font-weight:400;color:var(--dim);font-size:11.5px;padding:var(--s0) var(--s1);border-bottom:1px solid var(--line)}
+.intable td{padding:0 var(--s1);white-space:nowrap;overflow:hidden;text-overflow:ellipsis;vertical-align:top}
+.inrow{cursor:pointer}
+.inrow:hover td,.inrow.open td{background:var(--panel2)}
+.inkey{font-weight:600}
+.incount{font-variant-numeric:tabular-nums;text-align:right;padding-right:var(--s3) !important}
+.invals code{margin-right:var(--s1);font-size:11.5px;color:var(--dim)}
+.inuse td{font-size:12px}
+.inuse .inplace{padding-left:var(--s3)}
+.inuse .inplace a{color:var(--accent);text-decoration:none}
+.inmore{margin-top:var(--s1)}

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

@@ -27,7 +27,7 @@ export function pageKey(e: KeyLike): PageKey | null {
 }
 
 /** the shortcut each place of the home carries on its button */
-export const PLACE_KEY = { overview: '⌘K', planned: "⌘'", activity: '⌘L' } as const
+export const PLACE_KEY: Record<'overview' | 'planned' | 'activity', string> & Partial<Record<string, string>> = { overview: '⌘K', planned: "⌘'", activity: '⌘L' }
 /** the picker's shortcut, on the first button, before home */
 export const PICKER_KEY = '⌘J'
 /** the repo above and below, hinted at the project list's foot */

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

@@ -7,6 +7,7 @@
 // of this (HomeSt.machine is null).
 import { makeAutoObservable, observableRef, runInAction } from 'mobx'
 import type { HomeAnswer, WidgetsAnswer } from '../../home/home-routes.ts'
+import type { WidgetView } from '../../home/widgets.ts'
 import type { WorkerView } from '../../home/hubs.ts'
 import type { OpenHow, ResourceView } from '../../home/resources.ts'
 import type { PmAnswer, Role } from '../../home/pm.ts'
@@ -51,6 +52,8 @@ export class MachineSt {
     pm: PmAnswer | null = null
     /** every house repo's widgets, as the daemon last rendered them */
     widgets: WidgetsAnswer | null = null
+    /** `repo/id` of each widget a refresh is rendering */
+    refreshing = new Set<string>()
     /** why pm did not answer the last poll, or '' while it does */
     pmDown = ''
     /** the last action that failed */
@@ -261,6 +264,26 @@ export class MachineSt {
         }
     }
 
+    /** one widget rendered now by the daemon, with force (its cache or
+     *  backoff skipped), its new view swapped in */
+    async refreshWidget(repo: string, id: string): Promise<void> {
+        const k = `${repo}/${id}`
+        if (this.refreshing.has(k)) return
+        this.refreshing.add(k)
+        try {
+            const r = await reach('/api/home/widgets/refresh', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ repo, id }) })
+            if (!r.ok) throw new Error(await r.text())
+            const v = (await r.json()) as WidgetView
+            runInAction(() => {
+                if (this.widgets != null) this.widgets = { ...this.widgets, widgets: this.widgets.widgets.map((w) => (w.repo === repo && w.id === id ? v : w)) }
+            })
+        } catch (e) {
+            runInAction(() => { this.error = ownTrouble(e, this) })
+        } finally {
+            runInAction(() => { this.refreshing.delete(k) })
+        }
+    }
+
     hub(name: string, act: 'ensure' | 'restart'): Promise<boolean> {
         return this.post('/api/home/hub', { name, act })
     }

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

@@ -1,5 +1,5 @@
 // the one picker of the page (cmd+j, keys.ts), a node of the root: the
-// home's places (home, activity, planned, in the list's order) first, then the shown repo's own jump
+// home's places (home, activity, planned, insights, archived) first, then the shown repo's own jump
 // targets, then every other house repo as a place to go. Another repo's
 // resources are never listed: a jump to a repo selects it in place, and its
 // own targets are one more cmd+j away.
@@ -27,6 +27,7 @@ export class PaletteSt {
             { id: 'place:home', label: 'home', section: 'place', face: { place: 'home' }, run: () => st.navigate('/') },
             { id: 'place:activity', label: 'activity', section: 'place', face: { place: 'activity' }, run: () => st.navigate('/activity') },
             { id: 'place:planned', label: 'planned', section: 'place', face: { place: 'planned' }, run: () => st.navigate('/planned') },
+            { id: 'place:insights', label: 'insights', section: 'place', face: { place: 'insights' }, run: () => st.navigate('/insights') },
             { id: 'place:archived', label: 'archived', section: 'place', face: { place: 'archived' }, run: () => st.navigate('/archived') },
         ]
     }

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

@@ -37,6 +37,7 @@ const PLACES: { id: Place | 'picker'; label: string; title: string }[] = [
     { id: 'overview', label: 'overview', title: 'the overview: shipkit, every global process and every repo on this machine' },
     { id: 'activity', label: 'activity', title: 'what every repo committed lately, what it holds uncommitted, its branch and whether it is pushed' },
     { id: 'planned', label: 'planned', title: 'every check the machine runs on its own: now, next, late, and why' },
+    { id: 'insights', label: 'insights', title: 'boxes about every repo: the packages they use and by how many, version drift, script names' },
 ]
 
 /** the icon's size on a row, in px, as attributes and in the sheet */
@@ -165,10 +166,10 @@ export const ProjectList = observer(({ app }: { app: ListHost }) => {
                         const on = id === 'picker' ? s.pickerOpen() : s.place === id
                         const key = id === 'picker' ? PICKER_KEY : PLACE_KEY[id]
                         return (
-                            <button key={id} className={`pjpl${on ? ' cur' : ''}`} aria-label={pl.label} title={`${pl.title} (${key})`} onClick={run}>
+                            <button key={id} className={`pjpl${on ? ' cur' : ''}`} aria-label={pl.label} title={key == null ? pl.title : `${pl.title} (${key})`} onClick={run}>
                                 <Icon d={ICON[id === 'picker' ? 'search' : id === 'overview' ? 'home' : id]} />
                                 <span className="pjname">{pl.label}</span>
-                                <kbd className="pjkey">{key}</kbd>
+                                {key == null ? null : <kbd className="pjkey">{key}</kbd>}
                             </button>
                         )
                     })}

package/src/serve/hub-app/projects-svc.ts

@@ -178,7 +178,7 @@ export function cardModel(p: Project, now: number): CardModel {
 }
 
 /** a page of the home that is no repo's */
-export type Place = 'overview' | 'planned' | 'activity'
+export type Place = 'overview' | 'planned' | 'activity' | 'insights'
 
 export class ProjectsSvc {
     /** the last list this browser saw until the first poll answers, so the

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

@@ -30,7 +30,7 @@ export type Sel = HashSel | null
 
 /** one picker target (cmd+j): run() fires the SAME action clicking would */
 /** what a picker entry wears: a repo's own icon, or a place's button icon */
-export type JumpFace = { repo: string } | { place: 'home' | 'planned' | 'activity' | 'archived' }
+export type JumpFace = { repo: string } | { place: 'home' | 'planned' | 'activity' | 'insights' | 'archived' }
 /** `key`: the shortcut that does the same, printed at the entry's end */
 export type Jump = { id: string; label: string; section: string; run: () => void; face?: JumpFace; key?: string }
 

package/src/serve/hub-runtime.ts

@@ -41,6 +41,7 @@ import { autoGatePool, takeSlot } from '../core/slots.ts'
 import { liveJobs, startJob } from '../core/jobs.ts'
 import { followJob } from '../core/job-follow.ts'
 import { RUN_JOB } from '../home/home-words.ts'
+import { RunLanes, runKey, treeStamp, writesTree } from './run-lanes.ts'
 import { OtherRepos } from './other-repos.ts'
 import { HouseRuns } from './house-runs.ts'
 import { recordStamp } from './project-gutter.ts'
@@ -185,9 +186,11 @@ export async function resolveHubDeps(root: string, boot: RepoConfig, io: ServeIo
     const port = o?.port ?? c.serve?.port ?? defaultHubPort(c.name)
     // every run this process has going, whoever started it
     let active = 0
-    // ONE run at a time, whoever asked: two gates over one tree would measure
-    // the same checks twice and race each other's repair pass
-    let chain: Promise<unknown> = Promise.resolve()
+    // every run, whoever asked: an identical one attaches, a repair pass goes
+    // alone, the rest overlap under the machine slot pool (run-lanes.ts)
+    const lanes = new RunLanes(() => treeStamp(root))
+    // the gate jobs this runtime started: one beside another is the lanes' call
+    const mine = new Set<string>()
     // the latest verdict of every check, printed as one problem frame after
     // each run for the vscode problems pane (problems/problem-line.ts)
     const board = new ProblemBoard()
@@ -215,13 +218,22 @@ export async function resolveHubDeps(root: string, boot: RepoConfig, io: ServeIo
             }
         }
         // a job still running here, started before this image or by a terminal's --detach
-        while (liveJobs(root).length > 0) await Bun.sleep(jobs.pollMs ?? 250)
+        const foreign = (): boolean => liveJobs(root).some((j) => !mine.has(j.id))
+        if (foreign()) tap.line('note: a gate job this hub did not start is running here, so this one starts when it ends')
+        while (foreign()) await Bun.sleep(jobs.pollMs ?? 250)
         const j = startJob(root, { cli: jobs.cli, kind, args: [], job: { opts, oneLib: true, turn: background, ...(env == null ? {} : { env }) } })
+        mine.add(j.id)
         tap.job?.(j.id)
-        return (await followJob(root, j.id, tap, { pollMs: jobs.pollMs })) ?? 1
+        try {
+            return (await followJob(root, j.id, tap, { pollMs: jobs.pollMs })) ?? 1
+        } finally {
+            mine.delete(j.id)
+        }
     }
     const runChecks: HubDeps['runChecks'] = (tap, o) => {
-        const run = chain.then(async () => {
+        // only a whole gate the hub was asked for runs the repair pass (hubGateOpts)
+        const writes = o?.auto !== true && o?.gate === true && (o.only == null || o.only.length === 0)
+        return lanes.submit({ key: null, writes, print: tap.line }, async () => {
             active++
             // a run the hub starts on its own takes the machine's background
             // turn, once it is this hub's turn, never while it queues
@@ -243,27 +255,25 @@ export async function resolveHubDeps(root: string, boot: RepoConfig, io: ServeIo
                 for (const l of board.frame()) io.print(l)
             }
         })
-        chain = run.catch(() => {})
-        return run
     }
     // a `shipkit ci` or `shipkit check` from a terminal, run HERE (home/via-hub.ts):
-    // in the same one-at-a-time chain as the hub's own runs, feeding the same
-    // problems frame, recorded as the cli's
+    // in the same lanes as the hub's own runs, feeding the same problems
+    // frame, recorded as the cli's
     const runCli: HubDeps['runCli'] = (kind, opts, print) => {
-        // never on a --json run: its output is the json and nothing else
-        if ((active > 0 || (jobs != null && liveJobs(root).length > 0)) && opts.json !== true) print('note: this hub has a run in flight, so this one starts when it ends')
-        const run = chain.then(async () => {
+        // a --json run prints the json and nothing else, so it never shares
+        const key = opts.json === true ? null : runKey(kind, opts)
+        // `check --fix` runs in process (home/via-hub.ts), so a check here never repairs
+        const writes = kind === 'ci' && writesTree(opts)
+        return lanes.submit({ key, writes, print, quiet: opts.json === true }, async (tee) => {
             active++
             try {
                 await refresh()
-                return await exec(kind, { ...opts, invokedBy: 'cli' }, { line: print, check: onBoard, job: (id) => print(`${RUN_JOB}${id}`) }, false)
+                return await exec(kind, { ...opts, invokedBy: 'cli' }, { line: tee, check: onBoard, job: (id) => tee(`${RUN_JOB}${id}`) }, false)
             } finally {
                 active--
                 for (const l of board.frame()) io.print(l)
             }
         })
-        chain = run.catch(() => {})
-        return run
     }
     const runIn = async (tap: CheckTap, o: Parameters<HubDeps['runChecks']>[1], background: boolean): Promise<number> => {
         const only = o?.only != null && o.only.length > 0 ? o.only : undefined
@@ -287,11 +297,11 @@ export async function resolveHubDeps(root: string, boot: RepoConfig, io: ServeIo
         if (adopted.length > 0) {
             io.print(`ok: following ${adopted.length} gate job(s) still running: ${adopted.map((j) => j.id).join(', ')}`)
             active++
-            const run = Promise.all(adopted.map((j) => followJob(root, j.id, { line: () => {}, check: onBoard }, { pollMs: jobs.pollMs }))).finally(() => {
-                active--
-                for (const l of board.frame()) io.print(l)
-            })
-            chain = run.catch(() => {})
+            void lanes.submit({ key: null, writes: true, print: () => {} }, () =>
+                Promise.all(adopted.map((j) => followJob(root, j.id, { line: () => {}, check: onBoard }, { pollMs: jobs.pollMs }))).then(() => 0).finally(() => {
+                    active--
+                    for (const l of board.frame()) io.print(l)
+                })).catch(() => {})
         }
     }
     // resolved once: it shells out to git, and the page asks on every poll