spexcode 0.2.8 → 0.4.0

package/spec-forge/src/__fixtures__/github-forge.json

@@ -1,10 +1,10 @@
 {
-  "_note": "Fixture mirroring githubDriver output (the vendor-neutral ForgeIssue[]/ForgePR[] a `gh issue/pr list` collapses to) for a sample repo. Drives the needs-yatsu-eval resolver test with no network.",
+  "_note": "Fixture mirroring githubDriver output (the vendor-neutral ForgeIssue[]/ForgePR[] a `gh issue/pr list` collapses to) for a sample repo. Drives the needs-eval resolver test with no network.",
   "issues": [
     {
       "number": 1,
       "title": "login redirect is broken on /logout",
-      "body": "Steps to repro: click logout, land on a 404.\n\nSpec: sessions\nneeds-yatsu-eval\n",
+      "body": "Steps to repro: click logout, land on a 404.\n\nSpec: sessions\nneeds-eval\n",
       "url": "https://github.com/acme/repo/issues/1",
       "state": "open",
       "labels": []
@@ -15,7 +15,7 @@
       "body": "The open-issue badge over-counts.\n\nSpec: dashboard-issues",
       "url": "https://github.com/acme/repo/issues/2",
       "state": "open",
-      "labels": ["bug", "needs-yatsu-eval"]
+      "labels": ["bug", "needs-eval"]
     },
     {
       "number": 3,
@@ -27,8 +27,8 @@
     },
     {
       "number": 4,
-      "title": "old freshness drift already verified",
-      "body": "Spec: freshness\nNeeds-Yatsu-Eval\n",
+      "title": "old forge-cache drift already verified",
+      "body": "Spec: forge-cache\nNeeds-Eval\n",
       "url": "https://github.com/acme/repo/issues/4",
       "state": "closed",
       "labels": []
@@ -36,18 +36,18 @@
     {
       "number": 5,
       "title": "flagged but names no node",
-      "body": "This one is flagged but carries no Spec: marker and no closing PR.\n\nneeds-yatsu-eval\n",
+      "body": "This one is flagged but carries no Spec: marker and no closing PR.\n\nneeds-eval\n",
       "url": "https://github.com/acme/repo/issues/5",
       "state": "open",
-      "labels": ["needs-yatsu-eval"]
+      "labels": ["needs-eval"]
     },
     {
       "number": 6,
       "title": "fixed via an open PR, no marker on the issue",
-      "body": "A worked bug; the node comes transitively from the closing PR.\n\nneeds-yatsu-eval: ignore-the-trailing-text",
+      "body": "A worked bug; the node comes transitively from the closing PR.\n\nneeds-eval: ignore-the-trailing-text",
       "url": "https://github.com/acme/repo/issues/6",
       "state": "open",
-      "labels": ["needs-yatsu-eval"]
+      "labels": ["needs-eval"]
     }
   ],
   "prs": [

package/spec-forge/src/cli.ts

@@ -2,7 +2,7 @@ import { loadSpecs } from '../../spec-cli/src/specs.js'
 import type { ForgeDriver, ForgeIssue, ForgePR } from './port.js'
 import { FORGE_DRIVERS, forgeDriverFor, resolveForgeHost } from './drivers.js'
 import { resolveLinks, type NodeLinks } from './links.js'
-import { resolveEvalPending, type NodeEvalPending } from './needs-yatsu-eval.js'
+import { resolveEvalPending, type NodeEvalPending } from './needs-eval.js'
 
 // tiny flag reader over this command's own arg slice (everything after `forge`), so cli.ts stays routing-only.
 function flag(args: string[], name: string): string | undefined {
@@ -14,10 +14,12 @@ const has = (args: string[], name: string) => args.includes(`--${name}`)
 async function readForge(
   args: string[],
 ): Promise<{ driver: ForgeDriver; nodeIds: string[]; issues: ForgeIssue[]; prs: ForgePR[] } | null> {
-  const host = flag(args, 'host') ?? resolveForgeHost()
+  // the forge is a VALUE, never a command ([[cli-surface]]): `--store <host>` names it, mirroring the
+  // store axis every other issue verb uses.
+  const host = flag(args, 'store') ?? resolveForgeHost()
   const driver = forgeDriverFor(host)
   if (!driver) {
-    console.error(`forge: unknown host '${host}' (known: ${FORGE_DRIVERS.map((d) => d.host).join(', ')})`)
+    console.error(`spex issue links: unknown --store '${host}' (known: ${FORGE_DRIVERS.map((d) => d.host).join(', ')})`)
     return null
   }
   const nodeIds = (await loadSpecs()).map((s) => s.id)
@@ -49,7 +51,7 @@ async function links(args: string[]): Promise<number> {
 
   const only = flag(args, 'node')
   if (only) {
-    if (!nodeIds.includes(only)) { console.error(`forge: no such node '${only}'`); return 1 }
+    if (!nodeIds.includes(only)) { console.error(`spex issue links: no such node '${only}'`); return 1 }
     resolved = resolved.filter((n) => n.node === only)
   }
 
@@ -58,7 +60,7 @@ async function links(args: string[]): Promise<number> {
   const nPRs = resolved.reduce((a, n) => a + n.prs.length, 0)
   console.log(
     `spec-forge · ${driver.host} · ${resolved.length} linked node(s) · ${nIssues} issue(s), ${nPRs} pr(s)` +
-      ` · scanned ${issues.length} issue(s), ${prs.length} pr(s)`,
+      ` · traced ${issues.length} issue(s), ${prs.length} pr(s)`,
   )
   if (resolved.length) console.log(render(resolved))
   return 0
@@ -81,7 +83,7 @@ async function evalPending(args: string[]): Promise<number> {
 
   const only = flag(args, 'node')
   if (only) {
-    if (!nodeIds.includes(only)) { console.error(`forge: no such node '${only}'`); return 1 }
+    if (!nodeIds.includes(only)) { console.error(`spex issue links: no such node '${only}'`); return 1 }
     resolved = resolved.filter((n) => n.node === only)
   }
 
@@ -89,16 +91,15 @@ async function evalPending(args: string[]): Promise<number> {
   const nPending = resolved.reduce((a, n) => a + n.pending.length, 0)
   console.log(
     `spec-forge · ${driver.host} · ${resolved.length} node(s) with eval pending · ${nPending} issue(s)` +
-      ` · scanned ${issues.length} issue(s), ${prs.length} pr(s)`,
+      ` · traced ${issues.length} issue(s), ${prs.length} pr(s)`,
   )
   if (resolved.length) console.log(renderPending(resolved))
   return 0
 }
 
-export async function runForge(args: string[]): Promise<number> {
-  const sub = args[0]
-  if (sub === 'links') return links(args.slice(1))
-  if (sub === 'eval-pending') return evalPending(args.slice(1))
-  console.error('spex forge: links [--host github] [--node <id>] [--json] | eval-pending [--host github] [--node <id>] [--json]')
-  return 2
+// `spex issue links [--pending]` ([[cli-surface]]): the read-only forge→spec trace, folded into the issue
+// drawer (the forge drawer is dissolved — a forge is a value, `--store`). Bare = every linked node's open
+// issues/PRs; --pending narrows to the threads still awaiting an eval reading (the old eval-pending view).
+export async function runIssueLinks(args: string[]): Promise<number> {
+  return has(args, 'pending') ? evalPending(args) : links(args)
 }

package/spec-forge/src/{needs-yatsu-eval.ts → needs-eval.ts}

@@ -1,13 +1,13 @@
 import type { ForgeIssue, ForgePR } from './port.js'
 import { resolveLinks, type LinkedIssue } from './links.js'
 
-export const NEEDS_YATSU_EVAL = 'needs-yatsu-eval'
+export const NEEDS_EVAL = 'needs-eval'
 
-// a bare-marker body line: the name alone, case-insensitive, any indent, optional trailing colon — content after it (`needs-yatsu-eval: foo`) is NOT a match
-const BODY_MARKER = new RegExp(`^\\s*${NEEDS_YATSU_EVAL}\\s*:?\\s*$`, 'im')
+// a bare-marker body line: the name alone, case-insensitive, any indent, optional trailing colon — content after it (`needs-eval: foo`) is NOT a match
+const BODY_MARKER = new RegExp(`^\\s*${NEEDS_EVAL}\\s*:?\\s*$`, 'im')
 
-export function isNeedsYatsuEval(issue: ForgeIssue): boolean {
-  if (issue.labels.some((l) => l.trim().toLowerCase() === NEEDS_YATSU_EVAL)) return true
+export function isNeedsEval(issue: ForgeIssue): boolean {
+  if (issue.labels.some((l) => l.trim().toLowerCase() === NEEDS_EVAL)) return true
   return BODY_MARKER.test(issue.body || '')
 }
 
@@ -19,7 +19,7 @@ export function resolveEvalPending(
   prs: ForgePR[],
   nodeIds: string[],
 ): NodeEvalPending[] {
-  const flagged = new Set(issues.filter(isNeedsYatsuEval).map((i) => i.number))
+  const flagged = new Set(issues.filter(isNeedsEval).map((i) => i.number))
   if (!flagged.size) return []
   const out: NodeEvalPending[] = []
   for (const { node, issues: linked } of resolveLinks(issues, prs, nodeIds)) {

package/spec-cli/src/boardStream.ts

@@ -1,179 +0,0 @@
-import { streamSSE } from 'hono/streaming'
-import type { Context } from 'hono'
-import { watch, mkdirSync, type FSWatcher } from 'node:fs'
-import { join } from 'node:path'
-import { sessionsRoot, gitCommonDir } from './layout.js'
-import { sessionSignature } from './sessions.js'
-import { getBoard, invalidateBoard } from './boardCache.js'
-import { unitize, tagOf, diffUnits, type Units } from './boardDelta.js'
-
-// @@@ board-stream — the board's freshness is PUSHED, not polled. A dashboard subscribes here ONCE; in
-// plain mode it gets a bare `board-changed` and refetches /api/board (the legacy protocol, kept verbatim
-// for old clients); in DELTA mode (`?mode=delta`) the server itself rebuilds on change and streams the
-// hash-chained patch ([[board-delta]]): a `board-full {to, board}` on connect, then `board-delta
-// {from, to, set, del}` per change — a few KB against the ~600KB snapshot, with a full-snapshot send
-// whenever the patch wouldn't win (bigger than the board, or the unit decomposition's id-uniqueness
-// precondition failed), so a delta subscriber is NEVER worse off than a full refetch.
-//
-// Event sources, ALL funneled into one debounced pipeline: (1) fs.watch on the per-user session store —
-// every lifecycle transition lands as a sessions/<id>/session.json write; (2) fs.watch on the shared git
-// dir's refs (+ packed-refs/HEAD) — a commit or merge moves a ref, so tree reshapes push instead of
-// waiting out a poll; (3) a subscriber-gated ~2s poll of the CHEAP tmux session signature ([[sessions]])
-// for liveness/activity, which never touch a file; (4) a delta-gated ~15s cold tick that rebuilds and
-// diffs server-side, catching what no watcher sees (uncommitted worktree spec edits, forge issues) — ONE
-// rebuild per tick total, replacing every open dashboard's own 15s full refetch. Plain mode without delta
-// subscribers keeps its zero-build behavior: sources just fan out `board-changed`.
-
-type Notify = () => void
-type Frame = { event: string; data: string }
-type DeltaSend = (frame: Frame) => void
-const plainSubs = new Set<Notify>()
-const deltaSubs = new Set<DeltaSend>()
-let debounce: ReturnType<typeof setTimeout> | null = null
-
-// ---- the rebuild→diff→broadcast pipeline (runs only while delta subscribers exist) ----
-// last successfully-broadcast snapshot: the delta chain's anchor. `lastFullFrame` is what a fresh
-// subscriber gets instantly; `lastUnits`+`lastTag` are what the next diff chains from. A snapshot that
-// failed the unitize precondition anchors nothing (lastUnits=null) so every following send is a full.
-let lastUnits: Units | null = null
-let lastTag = ''
-let lastFullFrame: Frame | null = null
-let building = false
-let dirty = false
-
-async function rebuildAndBroadcast(): Promise<void> {
-  if (building) { dirty = true; return }
-  building = true
-  try {
-    do {
-      dirty = false
-      let board: unknown
-      // share the route's single-flight build ([[board-cache]]); fireChanged() already invalidated the
-      // cache, so this gets a fresh build (or joins one a concurrent poll already started).
-      try { board = await getBoard() } catch { for (const n of [...plainSubs]) { try { n() } catch { /* swept on abort */ } }; continue }
-      const boardJson = JSON.stringify(board)
-      const { units, ok } = unitize(board as Record<string, unknown>)
-      const tag = tagOf(units)
-      if (tag === lastTag) continue
-      const fullFrame: Frame = { event: 'board-full', data: `{"to":"${tag}","board":${boardJson}}` }
-      let frame = fullFrame
-      if (lastUnits && ok) {
-        const { set, del } = diffUnits(lastUnits, units)
-        const deltaData = JSON.stringify({ from: lastTag, to: tag, set, del })
-        // guaranteed win: ship the patch only when it actually beats the snapshot
-        if (deltaData.length < fullFrame.data.length) frame = { event: 'board-delta', data: deltaData }
-      }
-      lastUnits = ok ? units : null
-      lastTag = tag
-      lastFullFrame = fullFrame
-      for (const send of [...deltaSubs]) { try { send(frame) } catch { /* swept on abort */ } }
-      for (const n of [...plainSubs]) { try { n() } catch { /* swept on abort */ } }
-    } while (dirty)
-  } finally { building = false }
-}
-
-// a merge/launch/close touches several record files at once; collapse the burst into ONE signal. With
-// delta subscribers the debounced fire rebuilds and broadcasts (plain subs then ride the same tag-moved
-// gate — no spurious refetches); without them it stays the zero-build legacy notify.
-function fireChanged(): void {
-  // invalidate the route's board cache ([[board-cache]]) on EVERY change signal, before the debounce guard
-  // — a plain-mode client that polls /api/board (no delta rebuild here) must still see fresh data on its
-  // next poll, and a delta rebuild below re-reads the same now-stale cache.
-  invalidateBoard()
-  if (debounce) return
-  debounce = setTimeout(() => {
-    debounce = null
-    if (deltaSubs.size) void rebuildAndBroadcast()
-    else for (const notify of [...plainSubs]) { try { notify() } catch { /* swept on abort */ } }
-  }, 150)
-}
-
-// ---- event source 0: an EXPLICIT server-side nudge ----
-// for a server-side mutation that must show instantly regardless of watcher health: /rename writes the
-// session's global record (`session.json` — [[session-rename]]), which lives INSIDE the watched store, so
-// source 1 normally sees the write too. The explicit route call stays because that fs watch is best-effort
-// (it can fail to attach), and the nudge makes the sub-second rename guarantee deterministic. Same
-// debounced funnel as every other source.
-export const notifyBoardChanged = (): void => fireChanged()
-
-// ---- event source 1: the session store (lifecycle status writes) ----
-let watcher: FSWatcher | null = null
-function ensureWatcher(): void {
-  if (watcher) return
-  const root = sessionsRoot()
-  try { mkdirSync(root, { recursive: true }) } catch { /* best-effort; the watch below still tries */ }
-  try { watcher = watch(root, { recursive: true }, () => fireChanged()) } catch { watcher = null }
-}
-
-// ---- event source 2: git refs (a commit/merge reshapes the tree the moment the ref moves) ----
-// refs/ recursively for loose refs (heads, worktree branches), plus the common dir itself non-recursively
-// for packed-refs rewrites and HEAD flips. Best-effort like every source: no watch → the cold tick covers.
-let refsWatchers: FSWatcher[] | null = null
-function ensureRefsWatcher(): void {
-  if (refsWatchers) return
-  refsWatchers = []
-  try {
-    const common = gitCommonDir()
-    try { refsWatchers.push(watch(join(common, 'refs'), { recursive: true }, () => fireChanged())) } catch { /* loose refs unwatched */ }
-    try { refsWatchers.push(watch(common, (_e, f) => { if (f === 'packed-refs' || f === 'HEAD') fireChanged() })) } catch { /* packed refs unwatched */ }
-  } catch { /* not a repo? the cold tick still covers */ }
-}
-
-// ---- event source 3: the tmux-derived signature (liveness + activity — never a file write) ----
-let poller: ReturnType<typeof setInterval> | null = null
-let lastSig = ''
-function ensureLivePoll(): void {
-  if (poller) return
-  poller = setInterval(() => {
-    void sessionSignature().then((sig) => { if (sig !== lastSig) { lastSig = sig; fireChanged() } }).catch(() => {})
-  }, 2000)
-}
-
-// ---- event source 4: the cold tick — the server-side replacement for every client's slow fallback poll.
-// Rebuild+diff on a relaxed timer so what NO watcher sees (an uncommitted worktree spec edit, a forge
-// issue refresh) still lands; an unchanged tag broadcasts nothing. Delta-gated: plain-only clients keep
-// their own client-side fallback, so without delta subscribers this must not burn builds.
-let coldTick: ReturnType<typeof setInterval> | null = null
-function ensureColdTick(): void {
-  if (coldTick) return
-  coldTick = setInterval(() => { if (deltaSubs.size) void rebuildAndBroadcast() }, 15000)
-}
-
-function stopSourcesIfIdle(): void {
-  if (plainSubs.size + deltaSubs.size > 0) return
-  if (poller) { clearInterval(poller); poller = null; lastSig = '' }
-  if (coldTick) { clearInterval(coldTick); coldTick = null }
-}
-
-// GET /api/board/stream — one SSE per dashboard tab, server→client only, with a periodic `ping` so an
-// idle proxy never times the connection out. On a backend hot-reload the stream drops and EventSource
-// auto-reconnects to the fresh child; a delta subscriber's reconnect lands a fresh `board-full`, so the
-// chain re-anchors with no client-side repair logic.
-export function boardStream(c: Context) {
-  const delta = c.req.query('mode') === 'delta'
-  ensureWatcher()
-  ensureRefsWatcher()
-  return streamSSE(c, async (stream) => {
-    let aborted = false
-    const send: DeltaSend = (frame) => { void stream.writeSSE(frame).catch(() => {}) }
-    const notify: Notify = () => { void stream.writeSSE({ event: 'board-changed', data: 'x' }).catch(() => {}) }
-    if (delta) { deltaSubs.add(send); ensureColdTick() } else { plainSubs.add(notify) }
-    ensureLivePoll()
-    const unsub = (): void => { deltaSubs.delete(send); plainSubs.delete(notify); stopSourcesIfIdle() }
-    stream.onAbort(() => { aborted = true; unsub() })
-    try {
-      await stream.writeSSE({ event: 'ready', data: 'x' })
-      if (delta) {
-        // seed the chain: the cached anchor snapshot immediately (same tag the next delta chains from),
-        // then a fire so a connect during a quiet stretch converges to truly-current within one build.
-        if (lastFullFrame) { await stream.writeSSE(lastFullFrame).catch(() => {}) ; fireChanged() }
-        else void rebuildAndBroadcast()
-      }
-      while (!aborted) {
-        await stream.sleep(25000)
-        if (aborted) break
-        await stream.writeSSE({ event: 'ping', data: 'x' })
-      }
-    } finally { unsub() }
-  })
-}

package/spec-cli/templates/presets/careful/.config/clarify-before-code/spec.md

@@ -1,11 +0,0 @@
----
-title: clarify-before-code
-surface: system
-status: active
-hue: 30
-desc: A config plugin (careful preset) — before coding, the worker surfaces ambiguities as explicit assumptions in its proposal, and blocks for a live question only on a load-bearing one.
-code:
----
-Before you write code, enumerate the ambiguities, contradictions, and technical risks in your task. Most of them are cheap: resolve a cheap one by **stating your assumption explicitly** in the work you propose. SpexCode's manager-merge review is already the hard gate — a misread surfaces there, in the proposal, not in a live interrogation of the human. So clarification shifts **left into the artifact**: the diff and the spec body say what you assumed, and the reviewer catches a wrong assumption at merge.
-
-Block for a live question (the `needs-input` channel) **only on a load-bearing ambiguity** — one where guessing wrong would waste the whole node. A small or clear task proceeds without asking. This is deliberately the opposite of "every agent asks the user": the default is to proceed on a stated assumption, and the human is interrupted only when proceeding blind would burn the work.

package/spec-cli/templates/spec/project/.config/core/spec.md

@@ -1,17 +0,0 @@
----
-title: core
-surface: system
-status: active
-hue: 200
-desc: A config plugin — the minimal spec-discipline contract folded into every launched agent.
-code:
----
-Commit your spec node and the code it justifies BEFORE you declare done or propose merge — the commit comes first, never as an afterthought to a declaration.
-
-A spec body is a living current-state document: it states the node's PRESENT intent and is rewritten in place. Never accrete a "## vN" changelog heading, and never add current-state or verdict sections — version history is git's job, not the body's.
-
-An independently-scoped feature gets its OWN spec node: if you build something separately scoped while working, create a sibling node for it rather than bundling it into your assigned node's commit (cosmetic polish riding along is the smell).
-
-Keep the loss signal honest for what you changed — yatsu is the signal the optimizer reads, so a gap is a blind spot. Changed a node that carries a `yatsu.md`? Re-measure it: run its scenario, compare to the expected, and file the result with `spex yatsu eval <node>`. Made an obvious frontend change to a node with NO `yatsu.md`? Give it one — a scenario (description + expected) — so its loss can be measured. A frontend scenario is measured through the **actual running product** — drive a real browser, read the real DOM and capture a screenshot (or video), never reason about the code — and that real observation is filed as the reading, not left as an ad-hoc check you ran but never recorded. `spex yatsu scan --changed` shows the gaps in exactly the nodes you touched.
-
-Don't reverse-engineer the file formats: `spex guide spec` and `spex guide yatsu` print the full spec.md and yatsu.md schema on demand. This prompt is the clue; that manual carries the detail. The CLI explains itself the same way: `spex help` is the command map (grouped by the loop each verb serves), `spex help <command>` one command's usage — when unsure of a verb, ask the tool, don't guess.

package/spec-cli/templates/spec/project/.config/spec.md

@@ -1,15 +0,0 @@
----
-title: .config
-status: active
-hue: 110
-desc: The instance home — this repo's DIY dev-flow plugins live here as skill-shaped config nodes.
----
-`.config/` is the **instance** of the config system: the concrete dev-flow plugins this repo ships for
-working in it. Each plugin is a skill-shaped node — its folder *is* the unit (a `spec.md` plus any
-co-located scripts) — living as a flat child of `.config/` and carrying a `surface: command|system` field
-that names where it plugs in.
-
-The launcher's system gather and the new-session dropdown read from here. Only **active** plugins
-gather: a `pending` node is declared intent, not yet an active plugin. The seed ships `core`
-(`surface: system` — the spec-discipline contract folded into every agent) plus command presets like
-`tidy`; add your own by creating a sibling node with a `surface` field.

package/spec-cli/templates/spec/project/.config/supervisor/spec.md

@@ -1,8 +0,0 @@
----
-title: supervisor
-surface: command
-status: active
-hue: 280
-desc: Launch a supervisor agent that manages other agents from the main checkout to drive a goal to completion.
----
-You are a SpexCode supervisor — a **manager**, not a feature worker. Your work base is the main checkout (the repository root), NOT your own worktree: do all git via `git -C <root>`, everything else via the `spex` CLI, and never write feature code. **FIRST, read `<root>/CLAUDE.md` — specifically its "Supervising — the manager loop" section** — that is your complete playbook (dispatch → monitor → review → merge → close, and how to parallelize). Then drive the goal: decompose it into worker-sized tasks and dispatch one worker per independent task (`spex new "<task>"` — give each ONLY its task; a task about one specific node mentions it as `[[<id>]]`, which only sets the branch name and board attribution; the session's real node links come from what it edits), monitor with `spex watch`, review proposals with `spex review <id>`, merge good ones with `git -C <root> merge --no-ff <branch>`, then close. Never let a worker self-merge; keep `spex lint` at 0 errors. To WAIT on a worker, POLL one-shot (`spex review <id>` or `spex ls` — both return immediately); never block on `spex watch`, which STREAMS forever and will freeze your turn. One footgun that bites a fresh supervisor: before `spex session close <id>`, confirm the merge landed (`git -C <root> log -1` shows HEAD at the new merge commit) — closing an unmerged branch discards the work. Report progress as you go and when the goal is complete. Your goal follows:

package/spec-dashboard/dist/assets/EvalsPage-BrvAGyc4.js

@@ -1,2 +0,0 @@
-import{u as pe,r as a,s as We,e as Ye,j as n,f as Ge}from"./index-BhIslAau.js";import{V as Ze,W as Je,X as Qe,Y as et,Z as tt,g as fe,n as nt,_ as Q,$ as st,a0 as Ae,a1 as at,a2 as lt,u as ot,z as he,a3 as it,o as rt,a4 as ct}from"./SessionWindow-LcCzBMU7.js";import{F as me}from"./FoldToggle-BuQ0lokE.js";const Ie=(l,c)=>{let d=null;for(const v of l)if(v.at<=c)d=v;else break;return d},ut=l=>{if(!l||!Array.isArray(l.events))return null;const c=l.v===1?"time":typeof l.axis=="string"?l.axis:"time",d=l.v===1?v=>v.tMs:v=>v.at;return{axis:c,events:l.events.map(v=>({at:d(v),step:v.step,...v.node?{node:v.node}:{}}))}},dt=(l,c,d)=>l==="time"?Q(c):l==="frame"?`#${c}`:l==="line"?`L${c}`:l==="index"?d?`${c}/${d}`:`${c}`:String(c);function Pe({events:l,axis:c,extent:d,activeStepIdx:v,onSeek:$}){return n.jsx("div",{className:"an-ruler",children:l.map((i,f)=>n.jsxs("button",{className:`an-step ${v===f?"on":""}`,onClick:()=>$(i.at),"data-tip":i.node?`→ ${i.node}`:void 0,children:[dt(c,i.at,d)," ",i.step]},f))})}const ve=l=>{var c,d;return((c=l.verdict)==null?void 0:c.status)==="pass"?"✓":((d=l.verdict)==null?void 0:d.status)==="fail"?"✗":"·"},Fe=l=>{var c,d;return((c=l.verdict)==null?void 0:c.status)==="pass"?"pass":((d=l.verdict)==null?void 0:d.status)==="fail"?"fail":"legacy"};function ft({entry:l,specs:c=[],sessions:d=[],onWrite:v,onOpenSession:$}){var Re,Le,Te,De,Ce;const i=pe(),f=a.useRef(null),x=a.useRef(null),j=a.useRef(null),k=a.useRef(null),g=a.useRef(0),[u,M]=a.useState([]),[w,y]=a.useState("time"),[r,b]=a.useState(null),[S,T]=a.useState(""),[D,X]=a.useState(!1),[ee,z]=a.useState(null),C=a.useRef(null),h=a.useRef(null),I=a.useRef(null),te=a.useRef(0),[Be,xe]=a.useState(0),[ne,ge]=a.useState(-1),[ye,be]=a.useState(null),[H,se]=a.useState(!1),[we,ae]=a.useState(!1),[le,oe]=a.useState(null),[_,ie]=a.useState(null),[E,je]=a.useState(null),[A,q]=a.useState(0),p=E&&E[A]||l;a.useEffect(()=>{b(null),T(""),M([]),z(null),q(0),je(null);let e=!0;return fetch(We(l.node,"evals")).then(t=>t.ok?t.json():null).then(t=>{e&&Array.isArray(t==null?void 0:t.readings)&&je(t.readings.filter(s=>s.scenario===l.scenario))}).catch(()=>{}),()=>{e=!1}},[l.node,l.scenario,l.ts,l.blob]),a.useEffect(()=>{b(null),z(null)},[A]);const O=Ze(p),P=O.find(e=>e.kind==="video"&&e.state==="present"),re=O.filter(e=>e.kind==="image"),Ve=O.filter(e=>e.kind!=="video"&&e.kind!=="image"),K=!!P,B=l.thread??null,ce=a.useMemo(()=>B?[{by:B.by,at:B.created,body:B.body},...B.replies||[]]:[],[B]),Xe=E&&((Re=E[0])==null?void 0:Re.by)||l.by||null,R=a.useMemo(()=>ce.map((e,t)=>{const s=Je(Qe(e.body),u);return s&&s.seekable?{i:t,tMs:s.tMs,step:s.step,label:s.label}:null}).filter(Boolean).sort((e,t)=>e.tMs-t.tMs),[ce,u]),ke=a.useRef(u);ke.current=u;const Me=a.useRef(R);Me.current=R;const W=a.useCallback(()=>{const e=te.current,t=ke.current;let s=-1;for(let m=0;m<t.length&&t[m].at<=e;m++)s=m;ge(m=>m===s?m:s);let o=null;for(const m of Me.current)if(m.tMs<=e)o=m.i;else break;be(m=>m===o?m:o)},[]);a.useEffect(()=>{W()},[R,u,W]),a.useEffect(()=>{te.current=0,C.current&&(C.current.style.width="0%"),h.current&&(h.current.style.left="0%"),I.current&&(I.current.textContent=""),ge(-1),be(null),xe(0),se(!1),ae(!1),oe(null),ie(null)},[l.blob,l.scenario,l.node]),a.useEffect(()=>{if(M([]),y("time"),!p.timelineBlob)return;let e=!0;return fetch(`/api/yatsu/blob/${p.timelineBlob}`).then(t=>t.ok?t.json():null).then(t=>{const s=e&&ut(t);s&&(M(s.events),y(s.axis))}).catch(()=>{}),()=>{e=!1}},[p.timelineBlob]),a.useEffect(()=>{const e=f.current;if(!e)return;const t=()=>{const N=Math.round((e.currentTime||0)*1e3),L=Math.round((e.duration||0)*1e3);te.current=N;const J=L?N/L*100:0;C.current&&(C.current.style.width=`${J}%`),h.current&&(h.current.style.left=`${J}%`),I.current&&(I.current.textContent=`${Q(N)} / ${Q(L)}`),W()},s=()=>{xe(e.duration||0),t()},o=()=>se(!0),m=()=>se(!1);return e.addEventListener("timeupdate",t),e.addEventListener("seeked",t),e.addEventListener("loadedmetadata",s),e.addEventListener("durationchange",s),e.addEventListener("play",o),e.addEventListener("pause",m),s(),()=>{e.removeEventListener("timeupdate",t),e.removeEventListener("seeked",t),e.removeEventListener("loadedmetadata",s),e.removeEventListener("durationchange",s),e.removeEventListener("play",o),e.removeEventListener("pause",m)}},[P==null?void 0:P.hash,l.node,l.scenario,A,W]);const F=Math.round(Be*1e3),Y=u[ne]||null,Ne=w==="time"?F:w==="frame"?re.length:w==="index"?u.length:0,V=a.useCallback(e=>{const t=f.current;t&&(t.currentTime=e/1e3)},[]),G=a.useCallback(()=>{const e=f.current;e&&(e.paused?e.play():e.pause())},[]),Ee=(e,t)=>{ie(e),t!=null&&V(t)},Z=a.useCallback(async e=>{const t=f.current;if(!(t!=null&&t.videoWidth))return null;X(!0),T(i("annotator.capturing"));try{t.seeking&&await new Promise(L=>t.addEventListener("seeked",L,{once:!0}));const s=document.createElement("canvas");s.width=t.videoWidth,s.height=t.videoHeight;const o=s.getContext("2d");o.drawImage(t,0,0,s.width,s.height),e&&(o.strokeStyle="#ff9a3c",o.lineWidth=Math.max(2,s.width/300),o.strokeRect(e.x/100*s.width,e.y/100*s.height,e.w/100*s.width,e.h/100*s.height));const m=await new Promise(L=>s.toBlob(L,"image/png")),{hash:N}=await Ye(m);if(!N)throw new Error("no hash");return T(""),N}catch{return T(i("annotator.failed")),null}finally{X(!1)}},[i]),ze=a.useCallback(async()=>{var s;const e=f.current;if(!e)return null;e.pause();const t=Math.round((e.currentTime??0)*1e3);return{tMs:t,step:((s=Ie(u,t))==null?void 0:s.step)??null,frame:await Z(null)}},[u,Z]),ue=a.useCallback(async e=>{const t=f.current;if(!t)return;t.pause();const s=Math.round((t.currentTime||0)*1e3),o=Ie(u,s),m=await Z(e),N=[et(s,o==null?void 0:o.step)];m&&N.push(`![frame](/api/yatsu/blob/${m})`),o!=null&&o.node&&o.node!==l.node&&N.push(`re: [[${o.node}]]`),N.push(""),z({seq:++g.current,body:N.join(`
-`)})},[u,l.node,Z]),de=a.useCallback(e=>{var o;if(!R.length)return;let t=R.findIndex(m=>m.i===_);if(t<0){const m=Math.round((((o=f.current)==null?void 0:o.currentTime)||0)*1e3);t=R.reduce((N,L,J)=>L.tMs<=m?J:N,-1)}t=Math.min(R.length-1,Math.max(0,t+e));const s=R[t];ie(s.i),V(s.tMs)},[R,_,V]);a.useEffect(()=>{if(!K)return;const e=t=>{const s=document.activeElement;if(s&&(s.tagName==="INPUT"||s.tagName==="TEXTAREA"||s.tagName==="SELECT"||s.isContentEditable))return;const o=f.current;o&&(t.key===" "?(t.preventDefault(),G()):t.key==="ArrowRight"?(t.preventDefault(),o.currentTime=Math.min(o.duration||o.currentTime,o.currentTime+(t.shiftKey?1:5))):t.key==="ArrowLeft"?(t.preventDefault(),o.currentTime=Math.max(0,o.currentTime-(t.shiftKey?1:5))):t.key===","?(t.preventDefault(),o.currentTime=Math.max(0,o.currentTime-1/30)):t.key==="."?(t.preventDefault(),o.duration&&(o.currentTime=Math.min(o.duration,o.currentTime+1/30))):t.key==="ArrowDown"?(t.preventDefault(),de(1)):t.key==="ArrowUp"?(t.preventDefault(),de(-1)):(t.key==="a"||t.key==="A")&&(t.preventDefault(),ue(null)))};return window.addEventListener("keydown",e),()=>window.removeEventListener("keydown",e)},[K,G,de,ue]);const $e=e=>{var o;const t=(o=j.current)==null?void 0:o.getBoundingClientRect(),s=f.current;!t||!t.width||!s||!s.duration||(s.currentTime=Math.min(1,Math.max(0,(e-t.left)/t.width))*s.duration)},Oe=e=>{e.preventDefault(),ae(!0),$e(e.clientX)},Ue=e=>{var s;const t=(s=j.current)==null?void 0:s.getBoundingClientRect();t!=null&&t.width&&oe(Math.min(100,Math.max(0,(e.clientX-t.left)/t.width*100)))};a.useEffect(()=>{if(!we)return;const e=s=>$e(s.clientX),t=()=>ae(!1);return window.addEventListener("mousemove",e),window.addEventListener("mouseup",t),()=>{window.removeEventListener("mousemove",e),window.removeEventListener("mouseup",t)}},[we]);const Se=e=>{const t=x.current.getBoundingClientRect();return{x:(e.clientX-t.left)/t.width*100,y:(e.clientY-t.top)/t.height*100}},He=e=>{if(e.button!==0||D)return;const t=Se(e);b({x0:t.x,y0:t.y,x:t.x,y:t.y})},_e=e=>{var s,o;if(!r)return;const t=Se(e);!((s=f.current)!=null&&s.paused)&&(Math.abs(t.x-r.x0)>1||Math.abs(t.y-r.y0)>1)&&((o=f.current)==null||o.pause()),b({...r,x:t.x,y:t.y})},qe=()=>{if(!r)return;const e={x:Math.min(r.x0,r.x),y:Math.min(r.y0,r.y),w:Math.abs(r.x-r.x0),h:Math.abs(r.y-r.y0)};if(b(null),e.w<1&&e.h<1){G();return}ue(e)},U=r&&{x:Math.min(r.x0,r.x),y:Math.min(r.y0,r.y),w:Math.abs(r.x-r.x0),h:Math.abs(r.y-r.y0)};return n.jsxs("div",{className:"an-detail",children:[n.jsxs("header",{className:"an-head",children:[n.jsx("span",{className:"an-title",children:l.scenario}),n.jsx("span",{className:"an-node",children:l.node}),n.jsx("span",{className:`an-verdict-badge ${Fe(p)}`,children:ve(p)}),p.evaluator&&n.jsx("span",{className:"an-meta",children:p.evaluator}),n.jsx("span",{className:"an-meta",children:new Date(p.ts).toLocaleString()}),n.jsx(tt,{originator:Xe,sessions:d,kind:"eval",onOpenSession:$}),E&&E.length>1&&n.jsxs("div",{className:"an-ab",children:[n.jsx(fe,{icon:"chevron-left",size:13,className:"an-ab-nav",disabled:A>=E.length-1,onClick:()=>q(e=>Math.min(E.length-1,e+1)),label:i("annotator.abOlder")}),n.jsx("div",{className:"an-ab-track",children:E.slice().reverse().map((e,t)=>{const s=E.length-1-t;return n.jsx("button",{type:"button",className:`an-ab-pip ${Fe(e)} ${s===A?"on":""}`,onClick:()=>q(s),"data-tip":`${ve(e)} ${new Date(e.ts).toLocaleString()}`,children:ve(e)},`${e.ts}-${s}`)})}),n.jsx(fe,{icon:"chevron-right",size:13,className:"an-ab-nav",disabled:A<=0,onClick:()=>q(e=>Math.max(0,e-1)),label:i("annotator.abNewer")}),n.jsx("span",{className:"an-ab-pos",children:A===0?i("annotator.abLatest"):i("annotator.abPos",{i:E.length-A,n:E.length})})]})]}),n.jsxs("div",{className:"an-work",children:[n.jsxs("div",{className:"an-stage-col",children:[p.expected&&n.jsxs("div",{className:"an-expected",children:[n.jsx("b",{children:i("nodeView.eval.expected")})," ",p.expected]}),O.length>0&&((Le=p.verdict)==null?void 0:Le.note)&&n.jsxs("div",{className:"an-expected an-prior-note",children:[n.jsx("b",{children:i("nodeView.eval.noteLabel")})," ",p.verdict.note]}),!p.fresh&&(((Te=p.staleAxes)==null?void 0:Te.length)??0)>0&&n.jsxs("div",{className:"an-expected an-stale","data-tip":i("nodeView.eval.staleReadoutTitle"),children:[n.jsx("b",{children:i("nodeView.eval.staleLabel")})," ",p.staleAxes.join(" · "),(((De=p.codeDrift)==null?void 0:De.length)??0)>0&&n.jsxs("span",{className:"an-stale-files",children:[" — ",p.codeDrift.map(e=>`${e.file.split("/").pop()} +${e.behind}`).join(", ")]})]}),P&&n.jsxs(n.Fragment,{children:[n.jsxs("div",{className:"an-player",ref:k,children:[n.jsxs("div",{className:`an-stage ${H?"playing":"paused"}`,ref:x,onMouseDown:He,onMouseMove:_e,onMouseUp:qe,children:[n.jsx("video",{className:"an-video",ref:f,src:`/api/yatsu/blob/${P.hash}`,preload:"metadata",playsInline:!0}),U&&n.jsx("div",{className:"an-rect live",style:{left:`${U.x}%`,top:`${U.y}%`,width:`${U.w}%`,height:`${U.h}%`}}),!H&&!r&&n.jsx("div",{className:"an-bigplay","aria-hidden":!0,children:n.jsx(nt,{name:"play",size:22})})]}),n.jsxs("div",{className:"an-bar",children:[n.jsx(fe,{icon:H?"pause":"play",size:14,className:"an-play",label:i(H?"annotator.pause":"annotator.play"),onClick:G}),n.jsxs("div",{className:"an-seek",ref:j,onMouseDown:Oe,onMouseMove:Ue,onMouseLeave:()=>oe(null),children:[n.jsx("div",{className:"an-seek-trk"}),F>0&&w==="time"&&u.map((e,t)=>n.jsx("div",{className:"an-band",style:{left:`${e.at/F*100}%`},"data-tip":e.step},`band-${t}`)),n.jsx("div",{className:"an-seek-play",ref:C}),F>0&&R.map(e=>n.jsx("button",{type:"button",className:`an-mk ${_===e.i?"on":""} ${ye===e.i?"active":""}`,style:{left:`${e.tMs/F*100}%`},"data-tip":e.label,onMouseDown:t=>t.stopPropagation(),onClick:t=>{t.stopPropagation(),Ee(e.i,e.tMs)}},`mk-${e.i}`)),n.jsx("div",{className:"an-knob",ref:h}),le!=null&&F>0&&n.jsx("div",{className:"an-seek-hov",style:{left:`${le}%`},children:Q(le/100*F)})]}),n.jsx("span",{className:"an-time",ref:I}),Y&&n.jsx("span",{className:"an-curstep","data-tip":Y.node?`→ ${Y.node}`:void 0,children:Y.step}),n.jsx(st,{target:k})]})]}),u.length>0&&n.jsx(Pe,{events:u,axis:w,extent:Ne,activeStepIdx:ne,onSeek:V}),n.jsx("div",{className:"an-hint",children:i("annotator.hint")}),n.jsx("div",{className:"an-keys",children:i("annotator.keys")}),S&&n.jsx("div",{className:"an-flash",children:S})]}),!P&&u.length>0&&n.jsx(Pe,{events:u,axis:w,extent:Ne,activeStepIdx:ne,onSeek:V}),re.length>0&&n.jsx("div",{className:"an-gallery",children:re.map((e,t)=>n.jsx(Ae,{e,alt:l.scenario},`${e.hash}-${t}`))}),Ve.map((e,t)=>n.jsx(Ae,{e,alt:l.scenario},`${e.hash}-${t}`)),O.length===0&&((Ce=p.verdict)!=null&&Ce.note?n.jsx("pre",{className:"eval-transcript",children:p.verdict.note}):n.jsx("div",{className:"an-hint",children:i("nodeView.eval.noImage")}))]}),n.jsx(ht,{entry:l,comments:ce,specs:c,sessions:d,onWrite:v,codeSha:p.codeSha,seekMs:K?V:null,anchorNow:K?ze:null,draft:ee,selIdx:_,activeIdx:ye,onSelect:K?Ee:null,events:K?u:null})]})]})}function ht({entry:l,comments:c,codeSha:d,specs:v,sessions:$,onWrite:i,seekMs:f,anchorNow:x,draft:j,selIdx:k,activeIdx:g,onSelect:u,events:M}){var r;const w=pe(),y=(b,S)=>Ge({node:l.node,scenario:l.scenario,body:b,codeSha:d,evidence:S});return n.jsxs("aside",{className:"an-rail",children:[n.jsx("div",{className:"an-comments-head",children:w("annotator.comments",{n:c.length})}),n.jsx("div",{className:"an-rail-list",children:n.jsx(at,{replies:c,onSeek:f,selIdx:k,activeIdx:g,onSelect:u,events:M,threadId:((r=l.thread)==null?void 0:r.id)??null,onRemarkChange:()=>i==null?void 0:i("")})}),n.jsx("div",{className:"an-rail-compose",children:n.jsx(lt,{onSend:y,specs:v,sessions:$,focusId:l.node,onDone:i,anchorNow:x,draft:j},`${l.node}·${l.scenario}`)})]})}function Ke({rowKeys:l,sel:c,onSel:d,detail:v,children:$}){const[i,f]=a.useState(!1),x=a.useRef({});x.current={rowKeys:l,sel:c},a.useEffect(()=>{const k=g=>{var b;const u=(b=g.target)==null?void 0:b.tagName;if(u==="INPUT"||u==="TEXTAREA"||g.metaKey||g.ctrlKey||g.altKey||g.key!=="j"&&g.key!=="k")return;g.preventDefault(),g.stopPropagation();const{rowKeys:M,sel:w}=x.current;if(!M.length)return;const y=M.indexOf(w),r=y<0?g.key==="j"?0:M.length-1:Math.max(0,Math.min(M.length-1,y+(g.key==="j"?1:-1)));d(M[r])};return window.addEventListener("keydown",k,!0),()=>window.removeEventListener("keydown",k,!0)},[d]),a.useEffect(()=>{var k;(k=document.querySelector(".fv-list-col .sel"))==null||k.scrollIntoView({block:"nearest"})},[c]);const j=n.jsx(me,{className:"fv-fold-inline",onToggle:()=>f(!0)});return n.jsxs("div",{className:`fv-master ${i?"folded":""}`,children:[i&&n.jsx(me,{className:"fv-unfold",folded:!0,onToggle:()=>f(!1)}),n.jsx("div",{className:"fv-list-col",style:i?{display:"none"}:void 0,children:typeof $=="function"?$(j):n.jsxs(n.Fragment,{children:[n.jsx(me,{className:"fv-fold",onToggle:()=>f(!0)}),$]})}),n.jsx("div",{className:"fv-detail",children:v})]})}function mt({specs:l=[],sessions:c=[],reloadBoard:d,onOpenSession:v}){const $=pe(),{page:i,param:f}=ot(),[x,j]=a.useState(null),[k,g]=a.useState(""),[u,M]=a.useState([]),w=a.useRef([]),y=a.useMemo(()=>new Map(u.map(h=>[he(h),h])),[u]);w.current=u.map(he);const r=x&&y.has(x)?x:w.current[0]??null,b=a.useMemo(()=>{if(!f)return null;const h=f.indexOf("/");return h>0?`eval:${f.slice(0,h)}·${f.slice(h+1)}`:null},[f]),[S,T]=a.useState(null);a.useEffect(()=>{i==="evals"&&b&&(j(b),T(b))},[i,b]),a.useEffect(()=>{S&&y.has(S)&&T(null)},[S,y]);const D=x&&!y.has(x),X=a.useMemo(()=>!D||it(l).some(h=>he(h)===x),[D,l,x]);a.useEffect(()=>{D&&!X&&(j(null),T(null))},[D,X]),a.useEffect(()=>{x&&!S&&u.length&&!y.has(x)&&j(null)},[x,S,u,y]),a.useEffect(()=>{if(i!=="evals"||!r||D)return;const h=/^eval:([^·]+)·(.+)$/.exec(r);h&&rt("evals",`${h[1]}/${h[2]}`,{replace:!0})},[i,r,D]);const ee=a.useCallback(h=>M(h),[]),z=h=>{h&&(g(h),setTimeout(()=>g(""),6e3))},C=r?y.get(r):null;return n.jsx(Ke,{rowKeys:w.current,sel:r,onSel:j,detail:C?n.jsx(ft,{entry:C,specs:l,sessions:c,onOpenSession:v,onWrite:async h=>{z(h),await(d==null?void 0:d())}}):n.jsx("div",{className:"fv-note",children:$("evalsFeed.empty")}),children:h=>n.jsxs(n.Fragment,{children:[k&&n.jsx("div",{className:"fv-notice",children:k}),n.jsx(ct,{nodes:l,sessions:c,sel:r,onSel:I=>j(I),onRows:ee,mustShow:S,lead:h})]})})}const gt=Object.freeze(Object.defineProperty({__proto__:null,EvalMasterDetail:Ke,default:mt},Symbol.toStringTag,{value:"Module"}));export{ft as E,Ke as a,gt as b};