opencode-extended-sidebar 0.2.90 → 0.2.91

package/src/pware.oc.core/pware.oc.core.status.ts

@@ -1,214 +1,214 @@
-/**
- * Canonical lifecycle / tool / work status. OpenCode and OMO use different
- * synonyms; every mapper in the panel goes through this file. The raw status
- * strings live in `constants/pware.oc.core.constants.status.js`.
- */
-import {
-  STATUS_ABANDONED,
-  STATUS_ARCHIVED,
-  STATUS_COMPLETED,
-  STATUS_ERROR,
-  STATUS_IDLE,
-  STATUS_PAUSED,
-  STATUS_PENDING,
-  STATUS_RUNNING,
-  STATUS_UNKNOWN,
-  type CanonicalStatus,
-  type ToolStatus,
-} from "./constants/pware.oc.core.constants.status.js"
-import { formatTokenRate } from "./pware.oc.core.pulse.js"
-import { clipMiddleWidth } from "./pware.oc.core.width.js"
-
-export type { CanonicalStatus, ToolStatus }
-
-/** The transient one-line status a tab shows while it waits for its data. */
-export type TabTone = "loading" | "error" | "muted"
-
-/** Null when the tab's data is ready — the row does not exist then. */
-export type TabStatus = { label: string; tone: TabTone } | null
-
-/** The transient DB state right after a session is selected but its row is not visible yet. */
-export const TAB_STATUS_SESSION_NOT_IN_DB = "session not in db yet"
-
-/** A tab status resolved to a render line: static glyph + label + tone. Null = no row. */
-export type TabStatusLine = {
-  label: string
-  tone: TabTone
-  /** Static prefix glyph for error/muted; null for loading — the row animates the spinner. */
-  glyph: "×" | "•" | null
-} | null
-
-export function normalizeStatus(raw: string | null | undefined): CanonicalStatus {
-  const s = (raw || "").toLowerCase()
-  if (s === "running" || s === "in_progress" || s === "active") return STATUS_RUNNING
-  if (s === "completed" || s === "done" || s === "success") return STATUS_COMPLETED
-  if (s === "error" || s === "failed") return STATUS_ERROR
-  if (s === "pending" || s === "queued") return STATUS_PENDING
-  if (s === "paused") return STATUS_PAUSED
-  if (s === "abandoned") return STATUS_ABANDONED
-  if (s === "archived") return STATUS_ARCHIVED
-  if (s === "idle") return STATUS_IDLE
-  return STATUS_UNKNOWN
-}
-
-export function toToolStatus(raw: string | null | undefined): ToolStatus {
-  const c = normalizeStatus(raw)
-  if (c === STATUS_RUNNING) return STATUS_RUNNING
-  if (c === STATUS_COMPLETED) return STATUS_COMPLETED
-  if (c === STATUS_ERROR) return STATUS_ERROR
-  return STATUS_PENDING
-}
-
-/** Short work status for the panel — no full paths, no checklist text. */
-export function toWorkLabel(raw: string | null | undefined): string {
-  const c = normalizeStatus(raw)
-  if (c === STATUS_COMPLETED) return "done"
-  if (c === STATUS_UNKNOWN) return (raw || "").toLowerCase() || "unknown"
-  return c
-}
-
-/**
- * One-cell glyph for a work row's status: ✓ done, × error, ⧗ pending/queued,
- * ║ paused, ⊘ abandoned, ○ unknown. Null while running — the pulse spinner owns
- * the running cell. Core owns this mapping; the ui layer re-exports it.
- */
-export function workStatusGlyph(status: string): string | null {
-  const s = toWorkLabel(status)
-  if (s === "done") return "✓"
-  if (s === STATUS_ERROR) return "×"
-  if (s === STATUS_RUNNING) return null
-  // A single-cell geometric hourglass, not the emoji — one cell, monochrome.
-  if (s === STATUS_PENDING) return "⧗"
-  if (s === STATUS_PAUSED) return "║"
-  if (s === STATUS_ABANDONED) return "⊘"
-  return "○"
-}
-
-export function sessionStatusLabel(status: string): string {
-  return status
-}
-
-/**
- * The one shared decision behind every tab's status row. Priority order:
- * a session switch in flight, then the transient "row not visible yet" state,
- * then any real DB error, then Perf's own states, then a cold (not yet loaded)
- * tab. Null when the tab's data is ready.
- */
-export function tabStatus(opts: {
-  tab: string
-  currentId: string | null
-  dbError: string | null
-  dbPresent: boolean
-  switching: string | null
-  perfError: string | null
-  perfTurns: number
-  cold: boolean
-}): TabStatus {
-  if (opts.switching && opts.currentId !== opts.switching && !opts.dbError) {
-    return { label: `switching · ${clipMiddleWidth(opts.switching, 10)}`, tone: "loading" }
-  }
-  if (opts.dbError === TAB_STATUS_SESSION_NOT_IN_DB) {
-    return { label: "waiting for session", tone: "loading" }
-  }
-  if (opts.dbError) {
-    return { label: opts.dbError, tone: "error" }
-  }
-  if (!opts.dbPresent) {
-    return { label: "waiting for session", tone: "loading" }
-  }
-  if (opts.tab === "perf") {
-    if (opts.perfError) return { label: opts.perfError, tone: "error" }
-    if (opts.cold) return { label: "loading · stats", tone: "loading" }
-    if (opts.perfTurns === 0) return { label: "no turns yet", tone: "muted" }
-    return null
-  }
-  if (opts.cold) {
-    return {
-      label: opts.tab === "mywork" ? "loading · my work" : "loading · sessions",
-      tone: "loading",
-    }
-  }
-  return null
-}
-
-/**
- * Resolve a tab status to its render line. The null contract lives here so it
- * is unit-testable: a ready tab (`null`) returns `null`, and the glyph maps
- * tone → `×` error, `•` muted, `null` loading (the row animates the spinner).
- */
-export function tabStatusLine(status: TabStatus): TabStatusLine {
-  if (!status) return null
-  if (status.tone === "error") return { label: status.label, tone: "error", glyph: "×" }
-  if (status.tone === "muted") return { label: status.label, tone: "muted", glyph: "•" }
-  return { label: status.label, tone: "loading", glyph: null }
-}
-
-/** Tone of the global status bar: loading/error/muted, or "ready" when a tab is done. */
-export type StatusBarTone = TabTone | "ready"
-
-/**
- * Global status-bar line. A ready tab (`null`) still yields a line — with an
- * empty label the bar is a bare `OES` (the realtime category tabs on the same
- * row already lead with their own `•`), never `OES •` + a tab bullet.
- */
-export type StatusBarLine = { label: string; tone: StatusBarTone }
-
-export function statusBarLine(status: TabStatus): StatusBarLine {
-  const line = tabStatusLine(status)
-  if (!line) return { label: "", tone: "ready" }
-  return { label: line.label, tone: line.tone }
-}
-
-/**
- * The OES bar split into the pieces the row draws separately, because the
- * inline trend renders faded while the reading next to it stays full strength.
- * Empty `bar` / `rate` mean the row is a single run of text. `rateIdle` marks
- * a reading of zero, which the row fades to match the trend behind it.
- */
-export type OesBarParts = { head: string; bar: string; rate: string; rateIdle: boolean }
-
-/**
- * What the OES bar says. A busy label always wins — while the bar is reporting
- * a load, a switch or an error, the live token reading is noise and is dropped.
- * On a quiet bar the trend and the rate follow a bare `OES`; with neither, the
- * row is `OES` plus whatever glyph the tone asked for. Pass `rate` as the raw
- * per-second number; idleness follows the number the row actually prints, so a
- * trickle that rounds down to `0 tok/s` fades like a dead stop.
- */
-export function oesBarParts(
-  label: string,
-  glyph: string,
-  rateBar = "",
-  rate?: number | null,
-): OesBarParts {
-  if (label) return { head: `OES ${glyph} ${label}`, bar: "", rate: "", rateIdle: false }
-  if (rateBar || rate !== undefined) {
-    const shown = typeof rate === "number" && Number.isFinite(rate) ? Math.round(rate) : 0
-    return {
-      head: "OES  ",
-      bar: rateBar,
-      rate: rate === undefined ? "" : ` ${formatTokenRate(rate)}`,
-      rateIdle: shown <= 0,
-    }
-  }
-  return { head: glyph ? `OES ${glyph}` : "OES", bar: "", rate: "", rateIdle: false }
-}
-
-/** Paused and abandoned are deliberate stops — they must not keep pulsing. */
-export function workIsTerminal(status: string): boolean {
-  const s = toWorkLabel(status)
-  return s === "done" || s === STATUS_ERROR || s === STATUS_PAUSED || s === STATUS_ABANDONED
-}
-
-export function isRunningLifecycle(raw: string | null | undefined): boolean {
-  return normalizeStatus(raw) === STATUS_RUNNING
-}
-
-export function taskRank(status: string): number {
-  const c = normalizeStatus(status)
-  if (c === STATUS_RUNNING) return 0
-  if (c === STATUS_PENDING) return 1
-  if (c === STATUS_ERROR || (status || "").toLowerCase() === "cancelled") return 2
-  if (c === STATUS_COMPLETED) return 3
-  return 4
-}
+/**
+ * Canonical lifecycle / tool / work status. OpenCode and OMO use different
+ * synonyms; every mapper in the panel goes through this file. The raw status
+ * strings live in `constants/pware.oc.core.constants.status.js`.
+ */
+import {
+  STATUS_ABANDONED,
+  STATUS_ARCHIVED,
+  STATUS_COMPLETED,
+  STATUS_ERROR,
+  STATUS_IDLE,
+  STATUS_PAUSED,
+  STATUS_PENDING,
+  STATUS_RUNNING,
+  STATUS_UNKNOWN,
+  type CanonicalStatus,
+  type ToolStatus,
+} from "./constants/pware.oc.core.constants.status.js"
+import { formatTokenRate } from "./pware.oc.core.pulse.js"
+import { clipMiddleWidth } from "./pware.oc.core.width.js"
+
+export type { CanonicalStatus, ToolStatus }
+
+/** The transient one-line status a tab shows while it waits for its data. */
+export type TabTone = "loading" | "error" | "muted"
+
+/** Null when the tab's data is ready — the row does not exist then. */
+export type TabStatus = { label: string; tone: TabTone } | null
+
+/** The transient DB state right after a session is selected but its row is not visible yet. */
+export const TAB_STATUS_SESSION_NOT_IN_DB = "session not in db yet"
+
+/** A tab status resolved to a render line: static glyph + label + tone. Null = no row. */
+export type TabStatusLine = {
+  label: string
+  tone: TabTone
+  /** Static prefix glyph for error/muted; null for loading — the row animates the spinner. */
+  glyph: "×" | "•" | null
+} | null
+
+export function normalizeStatus(raw: string | null | undefined): CanonicalStatus {
+  const s = (raw || "").toLowerCase()
+  if (s === "running" || s === "in_progress" || s === "active") return STATUS_RUNNING
+  if (s === "completed" || s === "done" || s === "success") return STATUS_COMPLETED
+  if (s === "error" || s === "failed") return STATUS_ERROR
+  if (s === "pending" || s === "queued") return STATUS_PENDING
+  if (s === "paused") return STATUS_PAUSED
+  if (s === "abandoned") return STATUS_ABANDONED
+  if (s === "archived") return STATUS_ARCHIVED
+  if (s === "idle") return STATUS_IDLE
+  return STATUS_UNKNOWN
+}
+
+export function toToolStatus(raw: string | null | undefined): ToolStatus {
+  const c = normalizeStatus(raw)
+  if (c === STATUS_RUNNING) return STATUS_RUNNING
+  if (c === STATUS_COMPLETED) return STATUS_COMPLETED
+  if (c === STATUS_ERROR) return STATUS_ERROR
+  return STATUS_PENDING
+}
+
+/** Short work status for the panel — no full paths, no checklist text. */
+export function toWorkLabel(raw: string | null | undefined): string {
+  const c = normalizeStatus(raw)
+  if (c === STATUS_COMPLETED) return "done"
+  if (c === STATUS_UNKNOWN) return (raw || "").toLowerCase() || "unknown"
+  return c
+}
+
+/**
+ * One-cell glyph for a work row's status: ✓ done, × error, ⧗ pending/queued,
+ * ║ paused, ⊘ abandoned, ○ unknown. Null while running — the pulse spinner owns
+ * the running cell. Core owns this mapping; the ui layer re-exports it.
+ */
+export function workStatusGlyph(status: string): string | null {
+  const s = toWorkLabel(status)
+  if (s === "done") return "✓"
+  if (s === STATUS_ERROR) return "×"
+  if (s === STATUS_RUNNING) return null
+  // A single-cell geometric hourglass, not the emoji — one cell, monochrome.
+  if (s === STATUS_PENDING) return "⧗"
+  if (s === STATUS_PAUSED) return "║"
+  if (s === STATUS_ABANDONED) return "⊘"
+  return "○"
+}
+
+export function sessionStatusLabel(status: string): string {
+  return status
+}
+
+/**
+ * The one shared decision behind every tab's status row. Priority order:
+ * a session switch in flight, then the transient "row not visible yet" state,
+ * then any real DB error, then Perf's own states, then a cold (not yet loaded)
+ * tab. Null when the tab's data is ready.
+ */
+export function tabStatus(opts: {
+  tab: string
+  currentId: string | null
+  dbError: string | null
+  dbPresent: boolean
+  switching: string | null
+  perfError: string | null
+  perfTurns: number
+  cold: boolean
+}): TabStatus {
+  if (opts.switching && opts.currentId !== opts.switching && !opts.dbError) {
+    return { label: `switching · ${clipMiddleWidth(opts.switching, 10)}`, tone: "loading" }
+  }
+  if (opts.dbError === TAB_STATUS_SESSION_NOT_IN_DB) {
+    return { label: "waiting for session", tone: "loading" }
+  }
+  if (opts.dbError) {
+    return { label: opts.dbError, tone: "error" }
+  }
+  if (!opts.dbPresent) {
+    return { label: "waiting for session", tone: "loading" }
+  }
+  if (opts.tab === "perf") {
+    if (opts.perfError) return { label: opts.perfError, tone: "error" }
+    if (opts.cold) return { label: "loading · stats", tone: "loading" }
+    if (opts.perfTurns === 0) return { label: "no turns yet", tone: "muted" }
+    return null
+  }
+  if (opts.cold) {
+    return {
+      label: opts.tab === "mywork" ? "loading · my work" : "loading · sessions",
+      tone: "loading",
+    }
+  }
+  return null
+}
+
+/**
+ * Resolve a tab status to its render line. The null contract lives here so it
+ * is unit-testable: a ready tab (`null`) returns `null`, and the glyph maps
+ * tone → `×` error, `•` muted, `null` loading (the row animates the spinner).
+ */
+export function tabStatusLine(status: TabStatus): TabStatusLine {
+  if (!status) return null
+  if (status.tone === "error") return { label: status.label, tone: "error", glyph: "×" }
+  if (status.tone === "muted") return { label: status.label, tone: "muted", glyph: "•" }
+  return { label: status.label, tone: "loading", glyph: null }
+}
+
+/** Tone of the global status bar: loading/error/muted, or "ready" when a tab is done. */
+export type StatusBarTone = TabTone | "ready"
+
+/**
+ * Global status-bar line. A ready tab (`null`) still yields a line — with an
+ * empty label the bar is a bare `OES` (the realtime category tabs on the same
+ * row already lead with their own `•`), never `OES •` + a tab bullet.
+ */
+export type StatusBarLine = { label: string; tone: StatusBarTone }
+
+export function statusBarLine(status: TabStatus): StatusBarLine {
+  const line = tabStatusLine(status)
+  if (!line) return { label: "", tone: "ready" }
+  return { label: line.label, tone: line.tone }
+}
+
+/**
+ * The OES bar split into the pieces the row draws separately, because the
+ * inline trend renders faded while the reading next to it stays full strength.
+ * Empty `bar` / `rate` mean the row is a single run of text. `rateIdle` marks
+ * a reading of zero, which the row fades to match the trend behind it.
+ */
+export type OesBarParts = { head: string; bar: string; rate: string; rateIdle: boolean }
+
+/**
+ * What the OES bar says. A busy label always wins — while the bar is reporting
+ * a load, a switch or an error, the live token reading is noise and is dropped.
+ * On a quiet bar the trend and the rate follow a bare `OES`; with neither, the
+ * row is `OES` plus whatever glyph the tone asked for. Pass `rate` as the raw
+ * per-second number; idleness follows the number the row actually prints, so a
+ * trickle that rounds down to `0 tok/s` fades like a dead stop.
+ */
+export function oesBarParts(
+  label: string,
+  glyph: string,
+  rateBar = "",
+  rate?: number | null,
+): OesBarParts {
+  if (label) return { head: `OES ${glyph} ${label}`, bar: "", rate: "", rateIdle: false }
+  if (rateBar || rate !== undefined) {
+    const shown = typeof rate === "number" && Number.isFinite(rate) ? Math.round(rate) : 0
+    return {
+      head: "OES  ",
+      bar: rateBar,
+      rate: rate === undefined ? "" : ` ${formatTokenRate(rate)}`,
+      rateIdle: shown <= 0,
+    }
+  }
+  return { head: glyph ? `OES ${glyph}` : "OES", bar: "", rate: "", rateIdle: false }
+}
+
+/** Paused and abandoned are deliberate stops — they must not keep pulsing. */
+export function workIsTerminal(status: string): boolean {
+  const s = toWorkLabel(status)
+  return s === "done" || s === STATUS_ERROR || s === STATUS_PAUSED || s === STATUS_ABANDONED
+}
+
+export function isRunningLifecycle(raw: string | null | undefined): boolean {
+  return normalizeStatus(raw) === STATUS_RUNNING
+}
+
+export function taskRank(status: string): number {
+  const c = normalizeStatus(status)
+  if (c === STATUS_RUNNING) return 0
+  if (c === STATUS_PENDING) return 1
+  if (c === STATUS_ERROR || (status || "").toLowerCase() === "cancelled") return 2
+  if (c === STATUS_COMPLETED) return 3
+  return 4
+}

package/src/pware.oc.core/pware.oc.core.timing.ts

@@ -1,63 +1,63 @@
-/**
- * pware.oc.core.timing
- *
- * Panel clock budgets — every interval and granularity in one place. The tick
- * drives the animation heartbeat; `now` and the scan debounce decide how often
- * rows and the DB re-read actually re-run. See docs/tick-system.md.
- */
-
-/** UI heartbeat — spinner/arrow animation phase. */
-export const TICK_MS = 50
-
-/**
- * Fast glyph cadence — spinners and direction flows step this often on a
- * separate signal (`glyphFrame`), so the animation is smooth while rows and
- * ages still run on the coarse `TICK_MS` / `NOW_MS` clocks.
- */
-export const GLYPH_TICK_MS = 80
-
-/**
- * Coarse `now` granularity — ages, marks and row arrays recompute at most this
- * often, while glyphs still animate at `TICK_MS`. Displayed ages use 1s
- * granularity anyway (`formatCoarseSec`).
- */
-export const NOW_MS = 1_000
-
-/** FPS read cadence in ticks (TICK_MS × 6 = 300ms). */
-export const FPS_READ_EVERY_TICKS = 6
-
-/** Blink half-period in ticks (TICK_MS × 2 = 100ms). */
-export const BLINK_TICKS = 2
-
-/** Monitor: SQLite poll interval. */
-export const MONITOR_POLL_MS = 1_500
-
-/** Monitor: fs-watch → emit debounce. */
-export const MONITOR_WATCH_DEBOUNCE_MS = 120
-
-/**
- * My-work attention scan cadence while the tab is quiet — the periodic floor.
- * DB-change-driven rescans (see MYWORK_BADGE_COOLDOWN_MS) refresh it sooner.
- */
-export const MYWORK_BADGE_MS = 5_000
-
-/**
- * Minimum gap between My-work badge rescans when a new DB snapshot just landed
- * — a question appears within ~1s instead of waiting for the 5s floor.
- */
-export const MYWORK_BADGE_COOLDOWN_MS = 1_000
-
-/** Host event → scan debounce (trailing). */
-export const EVENT_SCAN_DEBOUNCE_MS = 100
-
-/** Sliding window over which the live token rate is measured. */
-export const TOKEN_RATE_WINDOW_MS = 5_000
-
-/** How long the shared realtime timeline stays in RAM (3 minutes). */
-export const REALTIME_WINDOW_MS = 3 * 60 * 1000
-
-/** Window over which token/cache rates and CPU% are derived (≈ "rate right now"). */
-export const REALTIME_RATE_WINDOW_MS = 1_000
-
-/** Session-switch status row safety: hide the indicator even if no snapshot lands. */
-export const SWITCH_TIMEOUT_MS = 3_000
+/**
+ * pware.oc.core.timing
+ *
+ * Panel clock budgets — every interval and granularity in one place. The tick
+ * drives the animation heartbeat; `now` and the scan debounce decide how often
+ * rows and the DB re-read actually re-run. See docs/tick-system.md.
+ */
+
+/** UI heartbeat — spinner/arrow animation phase. */
+export const TICK_MS = 50
+
+/**
+ * Fast glyph cadence — spinners and direction flows step this often on a
+ * separate signal (`glyphFrame`), so the animation is smooth while rows and
+ * ages still run on the coarse `TICK_MS` / `NOW_MS` clocks.
+ */
+export const GLYPH_TICK_MS = 80
+
+/**
+ * Coarse `now` granularity — ages, marks and row arrays recompute at most this
+ * often, while glyphs still animate at `TICK_MS`. Displayed ages use 1s
+ * granularity anyway (`formatCoarseSec`).
+ */
+export const NOW_MS = 1_000
+
+/** FPS read cadence in ticks (TICK_MS × 6 = 300ms). */
+export const FPS_READ_EVERY_TICKS = 6
+
+/** Blink half-period in ticks (TICK_MS × 2 = 100ms). */
+export const BLINK_TICKS = 2
+
+/** Monitor: SQLite poll interval. */
+export const MONITOR_POLL_MS = 1_500
+
+/** Monitor: fs-watch → emit debounce. */
+export const MONITOR_WATCH_DEBOUNCE_MS = 120
+
+/**
+ * My-work attention scan cadence while the tab is quiet — the periodic floor.
+ * DB-change-driven rescans (see MYWORK_BADGE_COOLDOWN_MS) refresh it sooner.
+ */
+export const MYWORK_BADGE_MS = 5_000
+
+/**
+ * Minimum gap between My-work badge rescans when a new DB snapshot just landed
+ * — a question appears within ~1s instead of waiting for the 5s floor.
+ */
+export const MYWORK_BADGE_COOLDOWN_MS = 1_000
+
+/** Host event → scan debounce (trailing). */
+export const EVENT_SCAN_DEBOUNCE_MS = 100
+
+/** Sliding window over which the live token rate is measured. */
+export const TOKEN_RATE_WINDOW_MS = 5_000
+
+/** How long the shared realtime timeline stays in RAM (3 minutes). */
+export const REALTIME_WINDOW_MS = 3 * 60 * 1000
+
+/** Window over which token/cache rates and CPU% are derived (≈ "rate right now"). */
+export const REALTIME_RATE_WINDOW_MS = 1_000
+
+/** Session-switch status row safety: hide the indicator even if no snapshot lands. */
+export const SWITCH_TIMEOUT_MS = 3_000