opencode-extended-sidebar 0.2.90

package/.oesignore

@@ -0,0 +1,17 @@
+# Directories hidden from the Files panel.
+tmp/
+.tmp/
+.omo/
+.agentize/
+.hidden/
+
+# Boilerplate root files.
+.gitignore
+backlog.md
+CHANGELOG.md
+LICENSE
+oes.json
+opencode.json
+package.json
+README.md
+skills-lock.json

package/CHANGELOG.md

@@ -0,0 +1,95 @@
+# Changelog
+
+- **0.2.90** (2026-09-07) Publish the sidebar to npm so OpenCode can install it by package name.
+- **0.2.89** (2026-09-07) Rewrite the panel reference as per-feature tables so each sidebar capability is one scannable row.
+- **0.2.88** (2026-09-05) Offer start work from the Plans archive picker so an archived plan can be launched directly and the archive drops Approve.
+- **0.2.87** (2026-09-05) Reconcile a plan with no parseable status against its boulder work so a completed plan lands in Finished instead of the Plans archive.
+- **0.2.86** (2026-09-05) Open the My-work Plans and Draft docs archives through the approval picker so a click offers Navigate to session before the preview instead of previewing the fi.
+- **0.2.85** (2026-09-05) Hide drafts superseded by a plan of the same name in the shared omo scan so one rule drops them from both the Session draft list and the My-work buckets.
+- **0.2.84** (2026-09-05) Make the open-question reconcile backstop a configurable 15 s oes.json option and merge the approvals and docs scans into one shared per-root omo stamp cache.
+- **0.2.83** (2026-09-05) Measure every sidebar row budget in wcwidth columns so wide CJK/emoji text clips cleanly instead of wrapping, surface plan files that no action group covers in .
+- **0.2.82** (2026-09-04) Scope the Session-tab drafts list to drafts the current session wrote and add a My-work Draft docs archive for drafts no action group covers.
+- **0.2.81** (2026-09-04) Add a token-rate bar and realtime fullscreen modal to the OES bar, widen the shared chart plot, and shrink the preview dialog chrome.
+- **0.2.80** (2026-09-04) describe the realtime fullscreen modal and prune inline-fullscreen references.
+- **0.2.79** (2026-09-04) route the realtime fullscreen F into a live modal instead of inline expansion.
+- **0.2.78** (2026-09-04) fullscreen realtime modal with category selector and multi-line series.
+- **0.2.77** (2026-09-04) add a pure multi-series realtime line renderer with per-series scale.
+- **0.2.76** (2026-09-04) give each realtime selector row its own unit label.
+- **0.2.75** (2026-09-04) Replace the project-wide open-question scan with an in-memory per-session cache invalidated by targeted question-part host events plus a 30-second reconcile bac.
+- **0.2.74** (2026-09-04) Move recent sessions into the My work Sessions group, remove spare gap rows above OES and below the tab bar, and retune direction-glyph sin-fades on the 50ms ti.
+- **0.2.73** (2026-09-04) Move the project-wide open-question scan into the snapshot worker so the ~500ms json_extract over every part no longer freezes the UI thread, expose it as snap(.
+- **0.2.72** (2026-09-04) Fold the whole realtime block (OES status bar, realtime category tabs and the 4-row chart) under a chevron-led OES header that starts collapsed and is remembere.
+- **0.2.71** (2026-09-03) Add an on-screen debug console to the bottom of the sidebar that shows the newest event labels from a 200-line in-memory ring fed only while a debug or profile .
+- **0.2.70** (2026-09-03) Gate the plugin self-cost line behind the debug/profile loggers, swap the tab-header pipe separators for per-tab status-light glyphs whose My-work light scans p.
+- **0.2.69** (2026-09-03) Add Codecov coverage reporting with a 90% line gate and live README badge, excluding thin TUI wrappers and runtime I/O glue from coverage.
+- **0.2.68** (2026-09-03) Extract the inline work-state and canonical status literals behind constants: new WORK_STATE_* values in the omo planStatus module (the WorkState type now deriv.
+- **0.2.67** (2026-09-03) Calibrate the sidebar row-plan chrome from the opencode TUI source: split PANEL_CHROME into the measured 6-row host frame plus a title reserve, and drop the dea.
+- **0.2.66** (2026-09-03) Fold D:/ vs D:\ and git-bash /d/ path spellings through shared foldPathKey/samePath helpers and compare the realtime session.updated project filter through same.
+- **0.2.65** (2026-09-03) Flank the realtime braille chart with a compact axis column showing the recent max on top and the 0 baseline below, via a <=3-char formatCompact label.
+- **0.2.64** (2026-09-03) Unify the realtime widget onto one shared 300ms wall-clock timeline whose token/cache series are 1s windowed derivatives reconciled with estimated stream deltas.
+- **0.2.63** (2026-09-03) Tune the realtime block to 30 ms CPU/RAM sampling with a rolling 1 s window and 40 ms coalesced token redraws, draw the chart 3 rows tall, and show a one-row co.
+- **0.2.62** (2026-09-03) Add an event-driven realtime block with token, cache and process CPU/RAM series under the OES bar and route glyph colours through a shared resolver.
+- **0.2.61** (2026-09-02) Expose a shared new-session prompt as.
+- **0.2.60** (2026-09-02) Switch the tok/s sparkline to ASCII output and align chart docs and tests.
+- **0.2.59** (2026-09-02) Add a Dismissed questions My work group and route dismissed-question errors into it.
+- **0.2.58** (2026-09-02) Add a GitHub Actions CI workflow that typechecks, tests with coverage, and benchmarks on push.
+- **0.2.57** (2026-09-02) Smooth the OES token-rate sparkline by bucket-averaging and window-averaging the series before rendering.
+- **0.2.56** (2026-09-02) Fix the stuck OES status bar, add a live braille token-rate sparkline, normalize prefixed session IDs, and hide empty ghost sessions.
+- **0.2.55** (2026-09-02) Add a live token-rate status bar and auto-resolve or dismiss stale interrupted My work questions.
+- **0.2.54** (2026-09-02) Normalize OS-specific ignore rules and cross-platform line endings for consistent multi-OS development.
+- **0.2.53** (2026-09-01) Drop the redundant queued glyph on delegate rows so a pending task shows one hourglass.
+- **0.2.52** (2026-09-01) Indent delegate children one glyph column under their agent header.
+- **0.2.51** (2026-09-01) Normalize row highlighting so only active rows are coloured and static lists stay muted.
+- **0.2.50** (2026-09-01) Add a Session Drafts group and give file lists a searchable view-all header action.
+- **0.2.49** (2026-09-01) Remove the OMO bottom group and fold the document index into per-kind file resolvers with session and plan-status filters.
+- **0.2.48** (2026-09-01) Stop the sidebar freezing on a locked database by failing fast on lock waits, serving the last snapshot, and reading the runtime snapshot in a worker thread.
+- **0.2.47** (2026-09-01) Round perf trend y-axis labels to drop trailing-zero decimals.
+- **0.2.46** (2026-09-01) Rename the Details tab to Project and tag the current session with a [C] suffix.
+- **0.2.45** (2026-09-01) Reconcile My work plan grouping against boulder work and writer-session todos so an approved plan whose work finished shows as Finished instead of Ready to star.
+- **0.2.44** (2026-09-01) Replace the touched-file detail DialogPad with a native DialogSelect that offers Preview or Copy relative path, and disable approval dialog actions instead of t.
+- **0.2.43** (2026-09-01) Close the tab-status test gap by extracting the render decision into a tested tabStatusLine helper so a ready tab's null status can no longer crash the row.
+- **0.2.42** (2026-09-01) Fix the My work tab briefly showing nothing on first open by re-delivering the initial snapshot the bus dropped before its listener attached, and treat a not-ye.
+- **0.2.41** (2026-09-01) Add per-tab status rows that show session-switch and cold-tab loading with a braille spinner, DB errors and Stats empty notes until data lands, and relabel the .
+- **0.2.40** (2026-09-01) Document perf chart modules and the dependency change.
+- **0.2.39** (2026-09-01) Render perf bars and trends with chart libraries, dropping hand-rolled barGlyphs and sparkline.
+- **0.2.38** (2026-09-01) Add perf charts dialog with stats, histogram and gauges.
+- **0.2.37** (2026-09-01) Add perf chart and stat render helpers (asciiTrend, shareBar, perfStatLine, histogram, gauge).
+- **0.2.36** (2026-09-01) Add perf series pipeline helpers (interpolate, smooth, downsample, stripAnsi).
+- **0.2.35** (2026-09-01) Add asciichart, simple-statistics and @crafter/charts chart/stat dependencies.
+- **0.2.34** (2026-09-01) Close the omo layer's cross-domain edges by moving workStatusGlyph into core and the approval session-state enrichment type into runtime (EnrichedApproval), correct the perf layer rule so its TUI view may import ui, and version the .cursor rules in the repo
+- **0.2.33** (2026-09-01) Extract the host and OMO event wiring into a typed event bus (pware.oc.core.bus with PwareEvent and per-layer EV_* event-name constants), adapt host TUI events .
+- **0.2.32** (2026-09-01) Refresh a session's status together with its age on live-snapshot cache hits so the My work Running group no longer keeps sessions that went idle, list only run.
+- **0.2.31** (2026-09-01) Replace the left/right direction flows with single-dot waves growing from the middle row (⠂⠒⠲ right while a tool call is in flight, ⠐⠒⠙ left while tokens stream.
+- **0.2.30** (2026-09-01) Split every sidebar row into a state glyph plus a per-direction braille flow where a single dot sweeps right while a tool call is in flight, left while tokens s.
+- **0.2.29** (2026-09-01) Add a Running group to the My work queue that lists recent main sessions still running or idle with their live status label, built by a toRunningItems filter ov.
+- **0.2.28** (2026-09-01) Move the plan-to-writer-session index from the opencode resolver into the omo layer as a shared per-document-kind file engine (plan, draft, notepads, evidence, .
+- **0.2.27** (2026-09-01) Make My work an action-based queue — Ready to review / Ready to start / Finished / Drafting groups with a planner-session row suffix backed by an in-memory plan.
+- **0.2.26** (2026-08-31) Make every panel list end in a clickable "+N more" revealer via a shared RowList with useReveal and MoreReveal (replacing sliceWithOverflow so no content row is.
+- **0.2.25** (2026-08-31) Extract shared sidebar primitives into a new pware.oc.ui.sections module (useFold over the legacy folded kv contract, FoldSection, budget-sliced GroupSection, a.
+- **0.2.24** (2026-08-31) Add a live plugin self-cost status line above the panel that samples event, scan and tick latency plus renderer FPS through a new perf.self reader, export it fr.
+- **0.2.23** (2026-08-31) Show the ulw-plan review lifecycle on My work approval rows (R<round> per-lane momus/independent glyphs) by parsing the draft frontmatter review block in plan.t.
+- **0.2.22** (2026-08-31) Enforce CRLF line endings via a repo .gitattributes (text=auto eol=crlf) so git stops warning about LF-to-CRLF conversions on Windows, and keep the shell hooks .
+- **0.2.21** (2026-08-31) Extract OpenCode and OMO string literals into documented per-domain constants (partType, eventType, toolName in core; planStatus, boulderStatus, backgroundTask,.
+- **0.2.20** (2026-08-31) Reorganize the plugin source into pware.-prefixed layered modules (core, opencode, omo, runtime, perf, ui) with per-layer barrels and an ARCHITECTURE.md module map, rename the live-snapshot symbols to runtime naming (RuntimeSnapshot, readRuntimeSnapshot, resetRuntimeCache), move SPARK_FRAMES back into pulse to restore the core-never-imports-ui layer rule, mirror the test tree to the new layout, repoint the plugin entry export, and add an always-on architecture rule
+- **0.2.19** (2026-08-31) Show the planner session state on pending-approval rows in My work (working/waiting/idle/archived/unknown) by enriching each approval via a new approvalState re.
+- **0.2.18** (2026-08-31) Make My work questions project-wide so a restart or session switch can no longer hide an open question, and widen the Sessions list with a sessionFetch revealer.
+- **0.2.17** (2026-08-31) Rename the pending-approval Continue row to Navigate to session and add an Approve row in its own category that sends an ok reply to the plan's writer session v.
+- **0.2.16** (2026-08-31) Extract every status-to-character mapping into a single pware.oc.ui.glyphs module (workStatusGlyph, markGlyph with queued rendering as the ◷ clock instead of th.
+- **0.2.15** (2026-08-31) Extract the resolution layer into src/resolvers: per-entity opencode (session/tool/file/question/todo) and omo (boulder/plan/approval/doc/config) resolver modul.
+- **0.2.14** (2026-08-31) Add a Project tab rolling up tools and files across recent sessions (tab bar is now OES | Project | Session | Perf, old Current renamed to Session), show the wi.
+- **0.2.13** (2026-08-31) Filter Files through `.oesignore` and `.gitignore` with the `ignore` package, exclude `question` from Perf timing, and add a `… N more` Files expander.
+- **0.2.12** (2026-08-31) Add perf timing log feature and update project files.
+- **0.2.11** (2026-08-31) Open a dated Perf timing log when you click a Time phase, Models header, or slow-tool row.
+- **0.2.10** (2026-08-30) Show a success toast when the sidebar plugin loads.
+- **0.2.9** (2026-08-30) Split OES and OMO into stacked groups with Works, Boulder, and Docs tabs plus height-aware row trimming.
+- **0.2.8** (2026-08-30) Open OMO plan rows as a headed markdown preview and mark plan status with check glyphs.
+- **0.2.7** (2026-08-30) Keep file previews inside a terminal-sized scrollbox so Copy and Close stay on screen.
+- **0.2.6** (2026-08-30) Use a down-triangle glyph on Delegate group headers so they no longer look like rows.
+- **0.2.5** (2026-08-30) Add click-for-detail dialogs with formatted Markdown preview and group Delegates by agent name.
+- **0.2.4** (2026-08-30) Stop leftover Delegates spinners once the OpenCode session is idle, extract tool and file metadata in SQLite, and spawn git status off the TUI thread.
+- **0.2.3** (2026-08-30) Add an OMO Plans tab, underline clickable chrome, and label task tools by their short description.
+- **0.2.2** (2026-08-30) Speed up large-tree refresh and mark thinking with a therefore sign instead of a star.
+- **0.2.1** (2026-08-30) Initial public release of the OpenCode Extended Sidebar TUI plugin.
+One sentence per commit. The `commit-msg` hook bumps the patch in `package.json` and prepends a line here.
+
+- **0.2.0** (2026-08-30) Session switcher, live tools, file diffs, and oes.json display options.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pleware
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,235 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/pleware/opencode-extended-sidebar/main/assets/branding.png" alt="OpenCode Extended Sidebar" width="720" />
+</p>
+
+# OpenCode Extended Sidebar | TUI Plugin
+
+**Mission control for your OpenCode agents — right inside the TUI.**
+
+Switch sessions, watch tools run live, see which files changed, and where the time went. No browser, no dashboard, four tiny dependencies.
+
+![OpenCode plugin](https://img.shields.io/badge/OpenCode-TUI%20plugin-000?style=flat-square) ![CI](https://github.com/pleware/opencode-extended-sidebar/actions/workflows/ci.yml/badge.svg) [![npm](https://img.shields.io/npm/v/opencode-extended-sidebar)](https://www.npmjs.com/package/opencode-extended-sidebar) [![codecov](https://codecov.io/gh/pleware/opencode-extended-sidebar/branch/main/graph/badge.svg)](https://codecov.io/gh/pleware/opencode-extended-sidebar) ![Runtime deps](https://img.shields.io/badge/runtime%20deps-4-brightgreen?style=flat-square) ![Read only](https://img.shields.io/badge/database-read--only-blue?style=flat-square) ![License](https://img.shields.io/badge/license-MIT-lightgrey?style=flat-square)
+
+---
+
+## Demo
+
+**[ demo recording goes here ]**
+
+*A short GIF showing session switching, live tool activity and file diffs.*
+
+---
+
+## Why
+
+OpenCode gives you one conversation at a time. Real work looks different: an orchestrator, delegates, tool calls, and a trail of edited files. Extended Sidebar puts that back on screen. It reads OpenCode's own database — nothing to sync, no daemon. Open the TUI and the panel is there.
+
+## ⇄ Session switcher
+
+> Recent sessions, one click away, now live in the **My work** tab as the `Sessions` group. Title, age, and whether it is still alive. The current session is tagged `[C]`. The group header keeps two right-rail labels: `switch` opens the host session switcher (the same `/sessions` command) and `new` jumps to the home prompt — the native new-session composer with `/` slash autocomplete, `@` mentions and the agent/model picker; Enter creates the session and sends it. The command palette exposes `nw`, and slash autocomplete exposes `/nw` (alias `/new`); both jump to that same home prompt. Empty sessions that were never prompted are hidden from the list. A trimmed group ends in a clickable `… +N more`. **Project** still rolls up the tools and files from those same recent sessions.
+
+## ⊚ Live activity pulse
+
+> Two glyphs per live row: a **state** glyph first — the braille spinner while working, `•` idle, `⧗` queued, `×` failed — then a **direction** glyph while one is active: **→** while a tool call is in flight, **←** while tokens stream in, **◷** while waiting on the model — blinking about twice a second and coloured by what is happening: green receiving tokens, yellow waiting on the model, accent a tool in flight. Idle rows keep the slot blank so the list stays aligned. Colours come from your OpenCode theme.
+
+## ≡ Tool Calls feed that names things
+
+> Each row is labelled with what actually ran — command, file, pattern, or task — plus how long it took. Running calls tick live; failures show `×`. Click a tool for a metadata sheet (never args or output). **Project** carries the same feed rolled up from the recent sessions. The feed shows the latest `toolRows` (default 5) and ends in a `… +N more` control that reveals the next batch with each click, up to `toolFetch` (default 20) rows of history.
+
+## ± File changes with diff stats
+
+> Files this session touched, with `+N −M` and git letters (`M` `A` `D` `R` `C` `U` `T` `?`). **V** means viewed — a session read with no git status. Click Markdown for a scrollable preview; other files open a native picker — **Preview** or **Copy relative path**. **Project** merges the same list across the recent sessions. A file list's header carries a `view all` action that opens a searchable picker of every file.
+>
+> Scratch dirs (`tmp/`, `.tmp/`, `.omo/`) and boilerplate filenames are hidden via the plugin's default `.oesignore`. The project's own `.oesignore` (gitignore format) is honoured automatically when present; set `skipGitignore` to also honour the project's `.gitignore`.
+
+## ⋔ Delegates and sub-agents
+
+> When an orchestrator hands work off, delegates appear as their own rows — tokens, status, pulse, click to jump. **Project** lists the project's boulder. **Session** lists only this session's children.
+
+## ? My work — what is waiting on you
+
+> One queue of things that need **your** action, shown first in the core group. Open `question` tools anywhere in the project appear as rows. Three states: `?` **Awaiting answer** (the agent is live and waiting — click to jump to the session and answer), `⊘` **Interrupted** (the question was aborted — answer never came, the reason shows on a muted line under the session name; once an interrupted question has terminated it is treated as resolved and hidden), and `×` **Errors** (the question tool genuinely failed — collapsed by default, expand for the error text on a muted line under the session name). Interrupted and Errors rows open a picker with **Navigate to session** and **Dismiss** — dismissing hides the row and is remembered for the project. Then a **Sessions** group (`◔`) — every recent session, live or idle, each showing the title, its live status mark and the `[C]` current tag, click to jump straight back in. A `Pinned` group (empty for now) sits ahead of the queue for sessions you pin. OMO plans and drafts appear in six foldable groups — four action queues plus two archives. Click a group header to fold it to its count line, and a trimmed group ends in a clickable `… +N more`: `Ready to review` (`!`, plans genuinely waiting for your sign-off), `Ready to start` (`▶`, approved plans you can launch), `Finished` (`✓`, done plans — an approved plan is auto-reconciled to Finished when its boulder work completed, or the writer session's todos are all done) and `Drafting` (`…` rows, drafts still being written — click for a picker: **Navigate to session** jumps to the session that wrote the draft, **Preview plan file** opens it as a preview) and `Draft docs` (`•` rows — draft files no action queue shows and whose plan file does not exist yet (a draft superseded by a plan of the same name is hidden entirely): approved or done drafts, unknown-status drafts, or notes with no status at all; click opens the file as a preview) and `Plans` (`▸` rows — plan files that no action queue shows: plans with an unknown or absent status). Clicking an archived plan opens the native, searchable picker: **Navigate to session** jumps to the session that wrote the plan (a muted reason is shown when no session is found), **Preview plan file** opens it as a preview, and the three **start work** rows (`start work`, `start work --make-pr`, `start work --ship`) launch the OMO plan in the current session. An archived plan can be started directly, not only previewed, and the archive offers no **Approve**. Rows are names only — no per-row age or session-status clutter; the right rail carries the review state when present. Review-required plans add the ulw-plan review state `R<round> <momus><independent>`, with per-lane glyphs `✓` approved, `!` changes requested, `?` inconclusive, `…` review live, `·` waiting. A session row carries a clickable `P` pin link (placeholder until the pinned backend is wired). When `.omo/` is absent the approval section is simply gone; the question queue works on OpenCode alone.
+
+## ◴ Where the time actually goes
+
+> **Perf** splits the wall clock into wait, think, stream and tools, then ranks models and slow calls. Click a phase, a section title, or a tool row for a dated column log. The scan runs only while this tab is open.
+>
+> The top row is the **OES bar**: a braille spinner while a tab loads or a session switch is in flight and `×` on a real error (with the message). When the status is quiet it shows an 8-column block bar plus an integer **tok/s** estimate from streaming deltas (≈ code points ÷ 4 over a 5 s window) — the same live reading the old bar used before the realtime widget. The bar is an inline trend, so it renders at 30% opacity; the number beside it takes full contrast only while tokens are actually moving, and fades with the bar at `0 tok/s`. A **`C`** link on the right opens the **charts** popup: Tok / Cache / Proc / Net category tabs, row selectors, and one 8-row ASCII trend at a time (sized to the dialog, live on the shared timeline); dismiss with **esc** or the header link, same as native OpenCode dialogs. The sidebar itself no longer carries inline category tabs or a braille chart. On a cold start the first line is briefly taken by a one-row `engage` boot line — a braille spinner plus a block fill that completes in about a second — which ends when the first snapshot lands and hands over to the `Loaded. Engage!` success toast. No prompt or output text ever leaves the panel — only the count.
+>
+> A muted **self** line above the tab row — `self 0.4ms/ev · 1.2ms/sc · 59fps` — shows what the plugin itself costs: average event-handler ms, average scan (fingerprint + snapshot) ms, and the TUI renderer's FPS. It measures the plugin's own runtime, not the model's. The line is diagnostic: it renders — and its timing runs — only while `OES_DEBUG_OPENCODE` or `OES_DEBUG_PROFILE` is active, so a normal session pays nothing for it. `OES_DEBUG_OPENCODE=1` additionally writes `self`-tagged JSON lines to the debug log.
+
+## ▣ One group, four views
+
+> ```
+> • My work  • Session  • Project  • Stats
+> ```
+>
+> **Session** is this agent, its delegates, tools, files and — with OMO — the drafts this session wrote (last five inline behind a `view all` picker). **My work** is the queue of things waiting on you — open questions, the recent sessions list (with `switch`/`new`), OMO plan approvals grouped by the action they need, and the `Draft docs` + `Plans` archives of leftover draft/plan files. **Project** is the project-wide view — the tools and files every recent session touched. **Stats** is timing. Each tab is led by a status light in place of a separator: `Session`, `Project` and `Stats` always show a muted `•`, while the **My work** light turns into `?` / `×` / `!` / `▶` / `⊘` whenever something is waiting on you **right now** — a live open question, a still-open failed question, a plan to review or start, an interrupted question. An *ended* failure is history (the Errors group still lists it once My work is open) and never lights the tab. The scan is project-wide and re-runs whenever the DB snapshot changes (≈1 s) with a 5-second periodic floor, so a freshly asked question lights the tab almost immediately. Tabs and folds are remembered. Clickable labels underline on hover. While a tab waits for its data a transient status row sits at its top — a braille spinner with `switching · <id>` while a session switch is in flight, `loading` on a cold tab, or an error/empty note (`no turns yet` on Stats) — and disappears the moment the data lands, so a switch never reads as a broken panel.
+
+## ⇕ Rows that fit the window
+
+> `oes.json` row counts are ceilings. A short terminal trims live activity last, then Files, then Delegates. Every list ends in a clickable `… +N more`: the Tool Calls feed reveals another `toolRows` per click (up to `toolFetch`); My work groups and Delegates reveal more with each click too. File lists (Files, Drafts) drop the inline revealer for a header `view all` that opens a searchable picker of the full list.
+>
+> Row text is clipped to the measured column width (wcwidth), not to code units — a wide glyph (CJK, emoji) is cut off cleanly instead of wrapping the line to a second row.
+
+## ⊘ Privacy first
+
+> The panel never shows prompts, tool arguments, outputs, patch bodies, or absolute paths. The database is opened read-only. What you see is names, counts, statuses and durations.
+
+## ∅ Four dependencies
+
+> Four runtime packages — [`ignore`](https://www.npmjs.com/package/ignore), [`asciichart`](https://www.npmjs.com/package/asciichart), [`simple-statistics`](https://www.npmjs.com/package/simple-statistics), [`@crafter/charts`](https://www.npmjs.com/package/@crafter/charts) — each with zero transitive dependencies. SQLite comes from `bun:sqlite` or `node:sqlite`; everything else is an OpenCode peer you already have.
+
+## Legend
+
+The glyph says *what* is happening; the colour says *how fresh* it is. Both come from your OpenCode theme.
+
+**Glyphs**
+
+| Glyph                           | Meaning                                                       |
+| ------------------------------- | ------------------------------------------------------------- |
+| `⠋ ⠙ ⠹ ⠸ ⠼ …`                   | working — the same braille spinner OpenCode uses for thinking |
+| `◷`                             | waiting on the model (direction glyph — blinks)              |
+| `→`                             | tool in flight (direction glyph — blinks)                     |
+| `←`                             | tokens streaming in (direction glyph — blinks)                |
+| `•`                             | idle — finished or archived                                  |
+| `⧗`                             | queued — waiting for a concurrency slot                       |
+| `▾`                             | group header (`▼` is the section fold)                       |
+| `×`                             | failed                                                        |
+| `?` `⊘` `×` `◔` `!` `…` `•` `▸` `▶` `✓` | My work: awaiting an answer / interrupted / errors / running / ready to review / drafting / draft docs (muted document rows) / plans (muted document rows) / ready to start / finished |
+| `✓` `!` `?` `·`                 | Review lanes: approved / changes requested / inconclusive / waiting |
+| `M` `A` `D` `R` `C` `U` `T` `?` | Files: git status — same letters as `git status --short`      |
+| `V`                             | Files: viewed (session read only)                             |
+| `[C]`                           | Sessions: the current session label                           |
+| `∴`                             | Perf: thinking                                                 |
+| `█░`                            | Perf: share of the wall clock — `@crafter/charts` bar, filled `█` + partial blocks, space-empty |
+| `▁▂▃▄▅▆▇█`                      | Perf: trend line chart — `asciichart`, nulls interpolated |
+
+The working spinner animates on a separate fast glyph tick (80 ms) while rows and ages stay on the coarse 50 ms / 1 s clocks, and a direction glyph fades in and out on the tick cadence, expiring on its own — it stops after ~2 s receiving tokens, ~15 s waiting on the model, ~30 s after a tool call — unless the session is still busy. The state glyph shows `×` on a failed row and `•` on a finished one; the direction slot shows the glyph only while it is active, staying blank otherwise so every row aligns. A queued delegate shows `⧗` in warning yellow — it is waiting for a slot, not done.
+
+**Colours**
+
+| Colour                 | Theme key                   | Meaning                                          |
+| ---------------------- | --------------------------- | ------------------------------------------------ |
+| green                  | `success`                   | receiving tokens, or active within the last 5 s  |
+| yellow                 | `warning`                   | waiting on the model, queued work, or last seen 5–10 s ago |
+| accent                 | `primary`                   | tool in flight — also the current row            |
+| red                    | `error`                     | failed                                           |
+| muted                  | `textMuted`                 | idle, done or archived                           |
+| green `+N` / red `−M`  | `diffAdded` / `diffRemoved` | added and removed lines                          |
+| `A` green / `D` red / `M` yellow | `success` / `error` / `warning` | Files: git-status letter by state; other letters muted |
+| accent `∴`             | `primary`                   | Perf: thinking                                   |
+
+While an arrow is lit it drives the colour. The current session is **bold** and tagged `[C]` in the Sessions list. Clickable labels **underline on hover**. On Perf the same arrows mean measured time: wait, stream, tools.
+
+## Install
+
+This is a TUI plugin. It belongs in `tui.json`, not `opencode.json`.
+
+```sh
+opencode plugin opencode-extended-sidebar --global
+```
+
+Or add the npm name in `~/.config/opencode/tui.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "plugin": ["opencode-extended-sidebar"]
+}
+```
+
+Restart the OpenCode TUI. OpenCode installs the package from npm and the panel starts reading your existing session history.
+
+For local development, point `plugin` at a `file:///` path to this checkout instead.
+
+## Configuration
+
+Later files win:
+
+1. the plugin's own `oes.json` (defaults)
+2. `~/.config/opencode/oes.json` (respects `XDG_CONFIG_HOME`)
+3. `<project>/oes.json`
+
+```json
+{
+  "fileRows": 8,
+  "perfHistory": 3,
+  "perfRows": 5,
+  "perfTurns": 120,
+  "questionReconcileSec": 15,
+  "sessionFetch": 20,
+  "skipGitignore": false,
+  "toolRows": 5,
+  "toolFetch": 20
+}
+```
+
+| Key                      | Default                          | What it controls                                      |
+| ------------------------ | -------------------------------- | ----------------------------------------------------- |
+| `fileRows`               | `8`                              | most file rows shown                                  |
+| `perfHistory`            | `3`                              | sessions under Perf → History; `0` hides it          |
+| `perfRows`               | `5`                              | rows per Perf section                                  |
+| `perfTurns`              | `120`                            | recent turns Perf measures                            |
+| `questionReconcileSec`   | `15`                             | seconds between full open-question rescans when no live hint arrives |
+| `sessionFetch`           | `20`                             | recent sessions fetched for the My work `Sessions` group |
+| `skipGitignore`          | `false`                          | also honour the project's root `.gitignore` (`.oesignore` is always honoured) |
+| `toolRows`               | `5`                              | most tool-call rows shown; the `… +N more` control reveals another `toolRows` per click |
+| `toolFetch`              | `20`                             | tool-call history kept behind the `… +N more` revealer; distinct from `toolRows` |
+
+Row counts are ceilings: a short terminal trims below them. Changes apply on the next refresh — no restart.
+
+Ignored files come from `.oesignore` and, when enabled, `.gitignore` — both at the project root, both in gitignore format. The plugin ships a default `.oesignore`.
+
+## Debug
+
+Set `OES_DEBUG_OPENCODE` in the environment **before** starting OpenCode, then restart the TUI. While either logger is active the sidebar shows the muted `self` cost line with a yellow flag row above it — `debug mode` and/or `profile` — plus a second muted row that prints the **resolved log directory** (`logs <path>`) so you can see exactly where files are being written. Below everything the panel then also draws a read-only **debug console**: short event labels (`db open`, …) newest first, only 5 visible rows over a 200-line in-memory ring that wheel-scrolls to older events. The console is fed only while a logger is on — with no logger active the `self` line, its measurement, and the console are off entirely.
+
+```bash
+# writes to <plugin>/logs/oes-debug-YYYY-MM-DD.log
+OES_DEBUG_OPENCODE=1 opencode
+```
+
+```powershell
+$env:OES_DEBUG_OPENCODE = "1"
+opencode
+```
+
+`1`, `true`, `yes`, or `on` use the plugin's `logs/` directory. Any other non-empty value is treated as a directory path. `0`, `false`, `no`, or `off` turns it off. Lines are JSON (`ts`, `tag`, `msg`, optional `data`) — path resolution, monitor emits, Perf reads, and the `self` tag logs the plugin's own measured latencies. Logging never crashes the panel.
+
+SQLite reads fail fast: `busy_timeout` is 100 ms, so a transient WAL lock no longer freezes the panel — the previous snapshot is kept on screen and a `sql.busy` debug line (with the SQL in `data.q`) is appended so lock contention is visible in the log.
+
+The same semantics power `OES_DEBUG_PROFILE`, which times **every plugin entry point and hotspot** and writes one line per call to `<plugin>/logs/oes-profile-YYYY-MM-DD.log`: `{ ts, tag, ms, data? }`. In this local repo checkout, `<plugin>/logs` means `./logs` at the repository root (not `./src/logs`). Tags: `event` (per event type), `tick`, `render` (the re-render trigger), `requestRender`, `row` (per row built), `scan`, `monitor.emit` (fingerprint + snapshot), `db.snapshot` / `db.feed` / `db.questions` / `perf.read`, `sql` (every query, with its SQL in `data.q`), `omo.read` / `omo.stamp` / `omo.config` / `omo.approvals` / `omo.docs`, `mywork.approvals` (the per-approval session lookup), `files.decorate` (git marks), `git`, `remount`, `hydrate`, and the async host calls `rpc.diff` / `rpc.selectSession` / `rpc.startWork` / `rpc.approve`. When the panel unmounts, one `summary` line with per-tag `{ n, total, avg, max }` is appended — the whole wall-clock split in a single line.
+
+## How it works
+
+The panel is a read-only view of data OpenCode already stores.
+
+| Source          | Path                                                          | Used for                         |
+| --------------- | ------------------------------------------------------------- | -------------------------------- |
+| OpenCode SQLite | `~/.local/share/opencode/opencode.db` (or `OPENCODE_DB`) | sessions, tools, files, timings  |
+| OMO             | `<project>/.omo/`                                            | plan approvals (My work) — optional |
+| `oes.json`      | plugin / user config / project                                 | display limits                    |
+| ignore files    | `<project>/.oesignore` (always) · `.gitignore` (with `skipGitignore`) | files hidden from the panel     |
+
+It refreshes from database stamps, file watches, and OpenCode events. The always-on runtime snapshot is read off the TUI main thread in a Bun worker (with a synchronous fallback if the worker is unavailable), so SQLite reads never block the UI. Cost is shown only when the provider reports it. The `self` line measures the plugin's own runtime with `performance.now()` and the TUI renderer's native frame stats — no extra data source — and it runs only while a debug or profile logger is active.
+
+## Contributing
+
+Issues and pull requests are welcome. Constraints: read-only OpenCode data, no prompts or tool I/O in the UI, every row must survive a narrow terminal.
+
+Every commit patch-bumps `package.json` and prepends one English sentence to [CHANGELOG.md](CHANGELOG.md). Write that sentence as the first line of the commit message. A green CI run on `main` publishes that version to npm.
+
+`bun test` runs unit and fixture tests. `bun run typecheck` checks types with `tsc --noEmit`. `bun run bench` times the 5k-part scan.
+
+## License
+
+MIT. Copyright © 2026 [pleware](https://github.com/pleware).
+
+<p>
+  <a href="https://github.com/pleware"><img src="https://raw.githubusercontent.com/pleware/opencode-extended-sidebar/main/assets/branding.pware.png" alt="pware" width="72" /></a>
+</p>
+
+## Acknowledgements
+
+This plugin started as a TUI take on the same idea as [Phrouros](https://github.com/disaeye/phrouros) — a live view of OpenCode agents, delegates and session activity, only inside the sidebar instead of a browser. Thank you to [disaeye](https://github.com/disaeye) for Phrouros.

package/oes.json

@@ -0,0 +1,11 @@
+{
+  "fileRows": 8,
+  "perfHistory": 3,
+  "perfRows": 5,
+  "perfTurns": 120,
+  "questionReconcileSec": 15,
+  "sessionFetch": 20,
+  "skipGitignore": false,
+  "toolRows": 5,
+  "toolFetch": 20
+}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "opencode-extended-sidebar",
+  "version": "0.2.90",
+  "description": "OpenCode TUI sidebar: session switcher, live tools/files, click-for-detail dialogs with scrollable file preview, perf timing logs and a chart dialog with trend lines, histograms and gauges, debug/profile mode banners with a resolved log-path hint, a live self-cost status line (event/scan latency + renderer FPS), height-aware row trimming, an action-based My work queue (open questions + plan approvals grouped by ready-to-review / ready-to-start / finished / drafting / draft-docs and plans archives, a pinned-sessions group, and a review-state suffix), per-tab transient status rows (session-switch spinner, cold-tab loading, error and empty notes), a new-session jump exposed as command-palette `nw` and slash `/nw`, and optional OMO plan approvals with a delegate view (read-only)",
+  "type": "module",
+  "license": "MIT",
+  "author": "PWare <pawel@pware.ai>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pleware/opencode-extended-sidebar.git"
+  },
+  "homepage": "https://github.com/pleware/opencode-extended-sidebar#readme",
+  "bugs": {
+    "url": "https://github.com/pleware/opencode-extended-sidebar/issues"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "tui",
+    "sidebar",
+    "session-switcher",
+    "token-usage",
+    "latency",
+    "observability",
+    "charts",
+    "statistics",
+    "asciichart",
+    "perf-charts",
+    "profile-logs",
+    "self-cost",
+    "fps",
+    "oh-my-openagent",
+    "markdown-preview",
+    "my-work",
+    "work-queue",
+    "tab-status",
+    "loading-indicator",
+    "command-palette",
+    "slash-command",
+    "plan-resolution",
+    "session-status",
+    "phrouros"
+  ],
+  "oc-plugin": [
+    "tui"
+  ],
+  "exports": {
+    "./tui": "./src/pware.oc.ui.tsx"
+  },
+  "files": [
+    "src",
+    "oes.json",
+    ".oesignore",
+    "scripts/install-git-hooks.mjs",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.3.7",
+    "@opentui/core": ">=0.5.8",
+    "@opentui/solid": ">=0.5.8",
+    "solid-js": ">=1.9.0"
+  },
+  "devDependencies": {
+    "@opentui/core": "^0.5.9",
+    "@opentui/solid": "^0.5.9",
+    "@types/bun": "^1.4.0",
+    "solid-js": "^1.9.15"
+  },
+  "peerDependenciesMeta": {
+    "@opentui/core": {
+      "optional": true
+    },
+    "@opentui/solid": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "prepare": "node scripts/install-git-hooks.mjs",
+    "test": "bun test test/unit test/snapshot",
+    "typecheck": "tsc --noEmit",
+    "bench": "bun test test/bench"
+  },
+  "dependencies": {
+    "ignore": "^7.0.7",
+    "asciichart": "^1.5.25",
+    "simple-statistics": "^7.11.0",
+    "@crafter/charts": "^0.2.5"
+  }
+}

package/scripts/install-git-hooks.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+/**
+ * Ustawia core.hooksPath=.githooks tylko gdy ten pakiet jest samym klonem repo
+ * (nie gdy leży w node_modules innego projektu).
+ */
+import { execSync } from "node:child_process"
+import { existsSync } from "node:fs"
+import { dirname, resolve } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const pkgRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..")
+const hook = resolve(pkgRoot, ".githooks/commit-msg")
+if (!existsSync(hook)) process.exit(0)
+
+try {
+  const top = execSync("git rev-parse --show-toplevel", {
+    cwd: pkgRoot,
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "ignore"],
+  }).trim()
+  if (resolve(top) !== pkgRoot) process.exit(0)
+
+  execSync("git config core.hooksPath .githooks", {
+    cwd: pkgRoot,
+    stdio: "ignore",
+  })
+} catch {
+  // brak gita / poza klonem — nic nie rób
+}

package/src/pware.oc.core/constants/index.ts

@@ -0,0 +1,18 @@
+/**
+ * pware.oc.core.constants
+ *
+ * Single source of truth for the plugin's string literals: OpenCode host
+ * literals (part types, host event types, tool names) plus the plugin's own
+ * canonical vocabularies (statuses, pulse/marks, row kinds, event kinds,
+ * My work groups, Perf/self phases).
+ */
+export * from "./pware.oc.core.constants.partType.js"
+export * from "./pware.oc.core.constants.eventType.js"
+export * from "./pware.oc.core.constants.toolName.js"
+export * from "./pware.oc.core.constants.status.js"
+export * from "./pware.oc.core.constants.pulse.js"
+export * from "./pware.oc.core.constants.eventKind.js"
+export * from "./pware.oc.core.constants.rowKind.js"
+export * from "./pware.oc.core.constants.myWork.js"
+export * from "./pware.oc.core.constants.phase.js"
+export * from "./pware.oc.core.constants.eventName.js"

package/src/pware.oc.core/constants/pware.oc.core.constants.eventKind.ts

@@ -0,0 +1,29 @@
+/**
+ * pware.oc.core.constants.eventkind
+ *
+ * The plugin's own classification of host events — the four buckets the panel
+ * reacts to. `pware.oc.core.events.ts` maps raw event types onto these.
+ */
+
+/** Event kind: model flow (delta / step / status). */
+export const EVENT_KIND_FLOW = "flow"
+
+/** Event kind: a tool call. */
+export const EVENT_KIND_TOOL = "tool"
+
+/** Event kind: a file was edited. */
+export const EVENT_KIND_FILE = "file"
+
+/** Event kind: the database should be re-read. */
+export const EVENT_KIND_DB_REFRESH = "db-refresh"
+
+/** Every host event kind the plugin recognizes. */
+export const EVENT_KINDS = [
+  EVENT_KIND_FLOW,
+  EVENT_KIND_TOOL,
+  EVENT_KIND_FILE,
+  EVENT_KIND_DB_REFRESH,
+] as const
+
+/** A host event kind. */
+export type EventKind = (typeof EVENT_KINDS)[number]

package/src/pware.oc.core/constants/pware.oc.core.constants.eventName.ts

@@ -0,0 +1,13 @@
+export const EV_OES_REFRESH_HINT = "pware.oes.refresh.hint"
+export const EV_OES_SNAPSHOT = "pware.oes.snapshot"
+export const EV_OES_SESSION_SELECT = "pware.oes.session.select"
+export const EV_OES_QUESTION_HINT = "pware.oes.question.hint"
+
+export const OES_EVENT_NAMES = [
+  EV_OES_REFRESH_HINT,
+  EV_OES_SNAPSHOT,
+  EV_OES_SESSION_SELECT,
+  EV_OES_QUESTION_HINT,
+] as const
+
+export type OesEventName = (typeof OES_EVENT_NAMES)[number]