feat: add TaskChef Next passive sidebar demo

README.md

@@ -47,10 +47,14 @@ every task.
 
 The screenshots in this walkthrough use illustrative demo data. Open the
 dashboard beside TaskChef master to see both tasks across your projects.
-In Codex, you can also call `open_taskchef_board` for a compact [sidebar app](docs/mcp-app.md)
-with a task board, task details, chat links, and confirmed manual status changes.
-**Board** groups tasks by **Working**, **Needs input**, **Completed**, and
-**Failed** so you can see their status at a glance.
+In Codex, call `open_taskchef_board` for the [TaskChef sidebar](docs/mcp-app.md).
+It reads local Codex data and groups chats as **Scheduled**, **Running**,
+**Waiting for input/review**, and **Done**. Interrupted chats stay in Waiting with an **Interrupted** tag. Empty board columns remain visible with a short message. Ambiguous records stay
+**Unverified**. Running follows the latest selected turn
+state; these labels do not prove task outcomes. Mark Done writes only TaskChef's separate local state. A new Codex turn
+resets that mark.
+The main dashboard's **Board** groups reported tasks by **Working**,
+**Needs input**, **Completed**, and **Failed** so you can see their status at a glance.
 
 ![TaskChef master beside the dashboard board with recipe-book working and payments needing input](docs/images/readme-board.png)
 

assets/README.md

@@ -0,0 +1,19 @@
+# TaskChef icons
+
+All icons use the same chef hat and T artwork. The SVG files are the editable sources.
+
+| Use | File | Background |
+| --- | --- | --- |
+| App and navbar, light theme | `taskchef.svg` | Rounded orange square; transparent outside |
+| App and navbar, dark theme | `taskchef-dark.svg` | Rounded orange square; transparent outside |
+| App icon PNG export, dark theme | `taskchef-app-rounded.png` | Rounded orange square; transparent outside |
+| Sidebar preview, light theme | `taskchef-sidebar-light.svg` | Dark strokes; transparent |
+| Sidebar preview, dark theme | `taskchef-sidebar-dark.svg` | Light strokes; transparent |
+| Codex sidebar | `taskchef-sidebar.svg` | Monochrome `currentColor`; transparent |
+| GitHub and other services that apply a circle crop | `taskchef-avatar-square.svg`, `taskchef-avatar-square.png` | Solid orange to all four edges |
+
+The app and sidebar SVGs are unchanged. The square avatar uses the current dark-theme navbar artwork and colors. Its hat is enlarged by 30% and centered for circle crops. The two sidebar preview files show the same light/dark colors that the MCP server already provides; the runtime continues to use the theme-neutral template. Both PNG exports are 512 × 512 pixels.
+
+For GitHub, upload `taskchef-avatar-square.png` and set the badge background color to `#F59E0B`. Keep the full image when GitHub asks for a crop.
+
+Export PNGs directly from the SVG sources. Do not use an image generator: these are flat vector icons, with no gradients, shadows, or texture.

docs/advanced-guide.md

@@ -7,15 +7,10 @@ Detailed setup, operation, recovery, and development reference for TaskChef.
 TaskChef requires Node.js 18 or newer, Git, Codex desktop, and local access to
 the projects that will receive work.
 
-TaskChef pins [`ccusage`](https://github.com/ccusage/ccusage) as an optional
-dependency for dashboard token and API-equivalent cost estimates. A normal npm
-installation uses that package-local executable; plugin-only installations use
-an npm-cache-friendly `npx` fallback to resolve the same exact version's native
-executable. `npx` never launches the analyzer against Codex data. TaskChef then
-requests ccusage's live-capable online pricing and falls back to its bundled
-offline snapshot, while never parsing Codex rollout files itself. Lifecycle
-reporting and the dashboard continue to work when ccusage, npm, or pricing is
-unavailable.
+TaskChef uses its own accounting engine for token usage and API-equivalent cost
+estimates. Usage requires Node.js 22.18+ and readable local Codex records.
+It includes linked subagents and uses the same pricing data as the board.
+Lifecycle reporting and the dashboard continue to work when usage is unavailable.
 
 ```sh
 codex plugin marketplace add favoyang/codex-plugins
@@ -49,7 +44,7 @@ The canonical workspace is `~/.agents/taskchef`. TaskChef owns only:
 AGENTS.md       managed dispatcher instructions plus user additions
 taskchef.json   schema-2 Codex project index, dashboard preference, and delegation metadata
 tasks.jsonl     one task snapshot per line (schema 10; schema 4-9 migration supported)
-.taskchef-usage.json   optional mode-0600 ccusage snapshot and turn-boundary cache
+.taskchef-usage.json   optional mode-0600 normalized usage cache
 ```
 
 To inspect or manually adjust the project index later, use the bootstrap skill:
@@ -356,33 +351,29 @@ will keep the feature disabled until Codex exposes a reliable supported
 app-callable archive interface or guarantees CLI compatibility. The dormant
 server path also rejects requests before discovering or invoking the CLI.
 
-Task details also show whole-task and per-turn token usage when `ccusage` can
-map the linked Codex thread. A completed turn briefly shows “Calculating token
-usage…” while TaskChef performs bounded deferred reconciliation, because
-the terminal lifecycle callback precedes Codex's final output write. The
-dashboard also preloads missing, interrupted, and retry-eligible usage in a
-bounded background queue at startup, after task changes, and on a periodic
-recovery pass; opening task details is not required to start collection. Historical
-tasks may show a trustworthy task total while older turns remain “Token usage
-unavailable” when no cumulative turn boundaries were recorded. Input, cached
-input, output, reasoning, and total counts retain ccusage's categories. Dollar
-figures are labeled API-equivalent estimates; provenance identifies the online
-pricing request or offline fallback mode, and zero-priced unknown models show
-cost unavailable rather than a misleading `$0.00`. Per-turn cost is also
-unavailable when its cumulative boundaries used different ccusage versions or
-pricing modes. TaskChef displays the cumulative estimate supplied by ccusage
-without applying a separate model-family or cache-write coverage policy.
+Task details show chat totals and native per-turn usage from saved Codex records.
+Historical tasks are read when needed, rather than scanned at startup. A turn
+without a matching native Codex turn ID shows usage unavailable; its chat total
+can still be shown. Missing logs and parent links make the known subtotal
+incomplete. Input, cached input, output, reasoning, and total counts use Codex's
+categories. Cached input and reasoning are subsets, not additional tokens.
+Dollar figures are API-equivalent estimates, using the board's pricing table.
+Unknown prices show cost unavailable or a known priced subtotal. Existing saved
+usage projections remain readable. A partial scan cannot replace a larger known
+historical subtotal; missing model prices cannot erase a saved priced subtotal.
+`.taskchef-usage.json` holds the web view's
+normalized projections; the underlying engine reuses the board disk caches.
+
 The same detail view reports lifecycle wall-clock elapsed time independently of
-ccusage. Each terminal turn shows **Elapsed** from `startedAt` to
+token accounting. Each terminal turn shows **Elapsed** from `startedAt` to
 `result.updatedAt`; **Total reported work** sums only valid terminal-turn
 durations, excluding idle gaps and unfinished work. A working turn shows live
 **Elapsed so far** without contributing to the total. This is reported
 wall-clock elapsed time, not model compute time, and malformed or reversed
 timestamp ranges are shown as unavailable.
 The header shows the running TaskChef package version reported by the same
 bounded health identity used for compatible-listener checks.
-The Settings page shows the ccusage version reported by the executable that
-TaskChef resolves at runtime.
+The Settings page identifies TaskChef as the usage provider.
 The canonical port is normally owned by a dashboard session process initialized
 by the TaskChef MCP before its tool transport connects. MCP recovery reuses an
 exact-compatible same-workspace dashboard and reports its actual launcher;

docs/diagrams/taskchef-appearance-wireframe.drawio

@@ -0,0 +1,2 @@
+<?xml version='1.0' encoding='utf-8'?>
+<mxfile host="app.diagrams.net"><diagram id="Appearance panel" name="Appearance panel"><mxGraphModel grid="1" page="1" pageWidth="590" pageHeight="420" background="#171717"><root><mxCell id="0" /><mxCell id="1" parent="0" /><mxCell id="2" value="TaskChef · Appearance panel proposal" style="rounded=1;absoluteArcSize=1;arcSize=16;whiteSpace=wrap;html=1;fillColor=none;strokeColor=none;fontColor=#eeeeee;fontFamily=Helvetica;fontSize=22;fontStyle=1;align=left;verticalAlign=top;spacing=12;" vertex="1" parent="1"><mxGeometry as="geometry" x="14" y="6" width="560" height="40" /></mxCell><mxCell id="3" value="" style="rounded=1;absoluteArcSize=1;arcSize=16;whiteSpace=wrap;html=1;fillColor=#242424;strokeColor=#454545;fontColor=#eeeeee;fontFamily=Helvetica;fontSize=14;fontStyle=0;align=left;verticalAlign=top;spacing=12;" vertex="1" parent="1"><mxGeometry as="geometry" x="20" y="62" width="548" height="50" /></mxCell><mxCell id="4" value="TaskChef" style="rounded=1;absoluteArcSize=1;arcSize=16;whiteSpace=wrap;html=1;fillColor=none;strokeColor=none;fontColor=#eeeeee;fontFamily=Helvetica;fontSize=16;fontStyle=1;align=left;verticalAlign=top;spacing=12;" vertex="1" parent="1"><mxGeometry as="geometry" x="42" y="66" width="230" height="32" /></mxCell><mxCell id="5" value="○     ⚙     ↻     ◐" style="rounded=1;absoluteArcSize=1;arcSize=16;whiteSpace=wrap;html=1;fillColor=none;strokeColor=none;fontColor=#eeeeee;fontFamily=Helvetica;fontSize=18;fontStyle=0;align=left;verticalAlign=top;spacing=12;" vertex="1" parent="1"><mxGeometry as="geometry" x="365" y="66" width="180" height="32" /></mxCell><mxCell id="6" value="" style="rounded=1;absoluteArcSize=1;arcSize=16;whiteSpace=wrap;html=1;fillColor=#242424;strokeColor=#454545;fontColor=#eeeeee;fontFamily=Helvetica;fontSize=14;fontStyle=0;align=left;verticalAlign=top;spacing=12;" vertex="1" parent="1"><mxGeometry as="geometry" x="238" y="126" width="330" height="264" /></mxCell><mxCell id="7" value="Appearance" style="rounded=1;absoluteArcSize=1;arcSize=16;whiteSpace=wrap;html=1;fillColor=none;strokeColor=none;fontColor=#eeeeee;fontFamily=Helvetica;fontSize=16;fontStyle=1;align=left;verticalAlign=top;spacing=12;" vertex="1" parent="1"><mxGeometry as="geometry" x="250" y="134" width="300" height="32" /></mxCell><mxCell id="8" value="" style="rounded=1;absoluteArcSize=1;arcSize=16;whiteSpace=wrap;html=1;fillColor=#333333;strokeColor=#555555;fontColor=#eeeeee;fontFamily=Helvetica;fontSize=14;fontStyle=0;align=left;verticalAlign=top;spacing=12;" vertex="1" parent="1"><mxGeometry as="geometry" x="254" y="182" width="296" height="44" /></mxCell><mxCell id="9" value="DAY" style="rounded=1;absoluteArcSize=1;arcSize=16;whiteSpace=wrap;html=1;fillColor=none;strokeColor=none;fontColor=#eeeeee;fontFamily=Helvetica;fontSize=13;fontStyle=0;align=left;verticalAlign=top;spacing=12;" vertex="1" parent="1"><mxGeometry as="geometry" x="259" y="188" width="84" height="32" /></mxCell><mxCell id="10" value="NIGHT" style="rounded=1;absoluteArcSize=1;arcSize=16;whiteSpace=wrap;html=1;fillColor=#525252;strokeColor=#777777;fontColor=#eeeeee;fontFamily=Helvetica;fontSize=13;fontStyle=1;align=left;verticalAlign=top;spacing=12;" vertex="1" parent="1"><mxGeometry as="geometry" x="350" y="187" width="90" height="34" /></mxCell><mxCell id="11" value="SYSTEM" style="rounded=1;absoluteArcSize=1;arcSize=16;whiteSpace=wrap;html=1;fillColor=none;strokeColor=none;fontColor=#eeeeee;fontFamily=Helvetica;fontSize=13;fontStyle=0;align=left;verticalAlign=top;spacing=12;" vertex="1" parent="1"><mxGeometry as="geometry" x="443" y="188" width="104" height="32" /></mxCell><mxCell id="12" value="Theme" style="rounded=1;absoluteArcSize=1;arcSize=16;whiteSpace=wrap;html=1;fillColor=none;strokeColor=none;fontColor=#eeeeee;fontFamily=Helvetica;fontSize=14;fontStyle=1;align=left;verticalAlign=top;spacing=12;" vertex="1" parent="1"><mxGeometry as="geometry" x="250" y="238" width="290" height="32" /></mxCell><mxCell id="13" value="[preview]   Default     ✓&lt;br&gt;&lt;br&gt;Neutral colors and standard card layout." style="rounded=1;absoluteArcSize=1;arcSize=16;whiteSpace=wrap;html=1;fillColor=#292929;strokeColor=#555555;fontColor=#eeeeee;fontFamily=Helvetica;fontSize=14;fontStyle=0;align=left;verticalAlign=top;spacing=12;" vertex="1" parent="1"><mxGeometry as="geometry" x="254" y="280" width="296" height="82" /></mxCell></root></mxGraphModel></diagram></mxfile>