Merge remote-tracking branch 'origin/main' into major-fixes-and-enhancements

# Conflicts:
#	CHANGELOG.md

Author: elkaix

.github/dependabot.yml

@@ -36,7 +36,7 @@ updates:
   - package-ecosystem: "npm"
     directories:
       - "/web"
-      - "/vis"
+      - "/dashboard"
       - "/docs"
       - "/packages/install-counter-worker"
       - "/examples/feedback-worker"
@@ -54,7 +54,7 @@ updates:
           - "patch"
     ignore:
       # TypeScript 6.x is a major bump: it deprecates the tsconfig `baseUrl`
-      # option (TS5101) and breaks the vis/ and web/ builds. Adopting it is a
+      # option (TS5101) and breaks the dashboard/ and web/ builds. Adopting it is a
       # coordinated monorepo migration, not four split bot PRs. Hold the major
       # until that lands; minor/patch within the current line still flow.
       - dependency-name: "typescript"

.github/workflows/linux-installer.yml

@@ -62,7 +62,7 @@ jobs:
           cache: "npm"
           cache-dependency-path: web/package-lock.json
 
-      # The web/vis frontends are gitignored build artifacts; without these
+      # The web/dashboard frontends are gitignored build artifacts; without these
       # steps PyInstaller froze a binary whose web UI 404'd on "/". The
       # bundles are arch-independent, so they are built once on the host —
       # the QEMU container build picks them up from the mounted checkout.
@@ -73,8 +73,8 @@ jobs:
           PYTHINKER_WEB_EXPECT_VERSION: ${{ steps.ver.outputs.version }}
         run: python3 scripts/build_web.py
 
-      - name: Build vis UI bundle
-        run: python3 scripts/build_vis.py
+      - name: Build dashboard UI bundle
+        run: python3 scripts/build_dashboard.py
 
       - name: Set up QEMU (aarch64 only)
         if: matrix.qemu

.github/workflows/windows-installer.yml

@@ -61,7 +61,7 @@ jobs:
           cache: "npm"
           cache-dependency-path: web/package-lock.json
 
-      # The web/vis frontends are gitignored build artifacts; without these
+      # The web/dashboard frontends are gitignored build artifacts; without these
       # steps PyInstaller froze a binary whose web UI 404'd on "/". The spec
       # file now also refuses to freeze when the bundles are missing.
       - name: Build web UI bundle
@@ -70,8 +70,8 @@ jobs:
           PYTHINKER_WEB_EXPECT_VERSION: ${{ steps.ver.outputs.version }}
         run: python scripts/build_web.py
 
-      - name: Build vis UI bundle
-        run: python scripts/build_vis.py
+      - name: Build dashboard UI bundle
+        run: python scripts/build_dashboard.py
 
       - name: Install PyInstaller
         run: uv pip install pyinstaller

.gitignore

@@ -28,8 +28,8 @@ src/pythinker_code/deps/tmp
 # Web build artifacts
 src/pythinker_code/web/static/assets/
 
-# Vis build artifacts
-src/pythinker_code/vis/static/
+# Dashboard build artifacts
+src/pythinker_code/dashboard/static/
 
 # Generated reports
 .firecrawl/

AGENTS.md

@@ -171,8 +171,8 @@ Development servers:
 ```bash
 make web-back     # FastAPI web backend on port 5494
 make web-front    # web frontend dev server
-make vis-back     # visualization backend on port 5495
-make vis-front    # visualization frontend dev server
+make dashboard-back     # dashboard backend on port 5495
+make dashboard-front    # dashboard frontend dev server
 ```
 
 Targeted package commands:
@@ -200,7 +200,7 @@ Pick the smallest reliable gate for the change, then run broader gates before re
 | `packages/pythinker-host` | `make check-pythinker-host && make test-pythinker-host` |
 | `packages/pythinker-review` | `make check-pythinker-review && make test-pythinker-review` |
 | `sdks/pythinker-sdk` | `make check-pythinker-sdk && make test-pythinker-sdk` |
-| Web / vis frontends | `make check-web`; build affected frontend when packaging assets changed |
+| Web / dashboard frontends | `make check-web`; build affected frontend when packaging assets changed |
 | Release / packaging / PyInstaller | `make build` or `make build-bin` as appropriate |
 
 If a gate cannot run because of missing system tools (for example `npm`), report that explicitly
@@ -248,7 +248,7 @@ see `docs/en/customization/architecture.md`. This list is a quick orientation on
 - `src/pythinker_code/auth/`: OAuth/API-key provider integrations.
 - `src/pythinker_code/background/`: background task worker/runtime support.
 - `src/pythinker_code/cli/`: Typer command tree (lazy-loaded subcommands `mcp`, `plugin`,
-  `skill`, `web`, `vis`, `info`, `export`, `review`, `secscan`, `security-scan`, `debug`,
+  `skill`, `web`, `dashboard`, `info`, `export`, `review`, `secscan`, `security-scan`, `debug`,
   `update`, plus eager `login`, `logout`, `term`, `acp`).
 - `src/pythinker_code/hooks/`: hook definitions and execution engine.
 - `src/pythinker_code/plugin/`: plugin discovery and installation support.
@@ -266,8 +266,8 @@ see `docs/en/customization/architecture.md`. This list is a quick orientation on
 - `src/pythinker_code/tools/`: built-in tools (`agent`, `ask_user`, `background`, `dmail`, `file`,
   `plan`, `shell`, `think`, `todo`, `web`, etc.).
 - `src/pythinker_code/ui/`: shell, print, and ACP frontends.
-- `src/pythinker_code/web/`, `src/pythinker_code/vis/`: backend integrations for web/visualization.
-- `web/`, `vis/`: frontend apps bundled into the CLI package.
+- `src/pythinker_code/web/`, `src/pythinker_code/dashboard/`: backend integrations for web/visualization.
+- `web/`, `dashboard/`: frontend apps bundled into the CLI package.
 - `packages/pythinker-core/`: LLM abstraction layer for messages, providers, streaming, and tools.
 - `packages/pythinker-host/`: host abstraction for local/remote file and shell operations.
 - `packages/pythinker-review/`: review/debug/security engine, code-reviewr-derived PR

CHANGELOG.md

@@ -15,6 +15,7 @@ GitHub Releases page; `0.8.0` is the new starting line.
 
 ## Unreleased
 
+- **Agent-tracing dashboard.** Added `pythinker dashboard` — a local web UI for inspecting sessions, wire events, context messages, tool statistics, and usage over time. It is also reachable from the interactive shell via the `/reports` slash command (aliased `/dashboard`).
 - **Gemini finish_reason is now sticky once truncation is detected.** A second candidate with any non-`MAX_TOKENS` finish reason no longer overwrites a previously captured `"length"` signal at either the streaming or non-streaming path in the Google GenAI provider.
 - **Budget-exhausted and stuck-loop messages are now visible in the shell.** Both handoff messages were appended to context but never sent to the wire, so the interactive shell showed no feedback when a spend ceiling or stuck-loop exit fired. Both now emit a `TextPart` wire event so the message appears in the shell.
 - **Dark-theme prompt_toolkit border colors now match the TUI token constants.** Six stale slate hex values in `_PROMPT_STYLE_DARK` diverged from the current `border` and `border_muted` token values; they are now in sync and a parity test binds them going forward.

Makefile

@@ -29,12 +29,12 @@ web-back: ## Start web backend with uvicorn (reload enabled).
 web-front: ## Start web frontend (vite dev server).
 	@npm --prefix web run dev
 
-# for pythinker vis development
-.PHONY: vis-back vis-front
-vis-back: ## Start vis backend with uvicorn (reload enabled).
-	@LOG_LEVEL=DEBUG uv run uvicorn pythinker_code.vis.app:create_app --factory --reload --port 5495
-vis-front: ## Start vis frontend (vite dev server).
-	@npm --prefix vis run dev
+# for pythinker dashboard development
+.PHONY: dashboard-back dashboard-front
+dashboard-back: ## Start dashboard backend with uvicorn (reload enabled).
+	@LOG_LEVEL=DEBUG uv run uvicorn pythinker_code.dashboard.app:create_app --factory --reload --port 5495
+dashboard-front: ## Start dashboard frontend (vite dev server).
+	@npm --prefix dashboard run dev
 
 .PHONY: format format-pythinker-code format-pythinker-core format-pythinker-host format-pythinker-review format-pythinker-sdk format-web
 format: format-pythinker-code format-pythinker-core format-pythinker-host format-pythinker-review format-pythinker-sdk format-web ## Auto-format all workspace packages.
@@ -145,8 +145,8 @@ cov-pythinker-sdk: ## Run Pythinker SDK tests with coverage.
 		--cov --cov-report=xml:coverage.xml -vv
 
 .PHONY: build build-pythinker-code build-pythinker-core build-pythinker-host build-pythinker-review build-pythinker-sdk build-bin build-bin-onedir
-build: build-web build-vis build-pythinker-code build-pythinker-core build-pythinker-host build-pythinker-review build-pythinker-sdk ## Build Python packages for release.
-build-pythinker-code: build-web build-vis ## Build the pythinker-code sdist and wheel.
+build: build-web build-dashboard build-pythinker-code build-pythinker-core build-pythinker-host build-pythinker-review build-pythinker-sdk ## Build Python packages for release.
+build-pythinker-code: build-web build-dashboard ## Build the pythinker-code sdist and wheel.
 	@echo "==> Building pythinker-code distributions"
 	@uv build --package pythinker-code --no-sources --out-dir dist
 build-pythinker-core: ## Build the pythinker-core sdist and wheel.
@@ -164,15 +164,15 @@ build-pythinker-sdk: ## Build the pythinker-sdk sdist and wheel.
 build-web: ## Build web UI and sync into pythinker-code package.
 	@echo "==> Building web UI"
 	@uv run scripts/build_web.py
-build-vis: ## Build vis UI and sync into pythinker-code package.
-	@echo "==> Building vis UI"
-	@uv run scripts/build_vis.py
-build-bin: build-web build-vis ## Build the standalone executable with PyInstaller (one-file mode).
+build-dashboard: ## Build dashboard UI and sync into pythinker-code package.
+	@echo "==> Building dashboard UI"
+	@uv run scripts/build_dashboard.py
+build-bin: build-web build-dashboard ## Build the standalone executable with PyInstaller (one-file mode).
 	@echo "==> Building PyInstaller binary (one-file)"
 	@uv run pyinstaller pythinker.spec
 	@mkdir -p dist/onefile
 	@if [ -f dist/pythinker.exe ]; then mv dist/pythinker.exe dist/onefile/; elif [ -f dist/pythinker ]; then mv dist/pythinker dist/onefile/; fi
-build-bin-onedir: build-web build-vis ## Build the standalone executable with PyInstaller (one-dir mode).
+build-bin-onedir: build-web build-dashboard ## Build the standalone executable with PyInstaller (one-dir mode).
 	@echo "==> Building PyInstaller binary (one-dir)"
 	@rm -rf dist/onedir dist/pythinker
 	@PYINSTALLER_ONEDIR=1 uv run pyinstaller pythinker.spec

README.md

@@ -744,8 +744,8 @@ make test-pythinker-sdk   # SDK only
 ```sh
 make web-back             # web backend
 make web-front            # web frontend
-make vis-back             # vis backend
-make vis-front            # vis frontend
+make dashboard-back       # dashboard backend
+make dashboard-front      # dashboard frontend
 ```
 
 </td>
@@ -770,7 +770,7 @@ make help                 # all targets
 
 ```
 pythinker-code/
-├── 📦 src/pythinker_code/         CLI runtime · tools · UIs · ACP · MCP · hooks · plugins · skills · web · vis backends
+├── 📦 src/pythinker_code/         CLI runtime · tools · UIs · ACP · MCP · hooks · plugins · skills · web · dashboard backends
 ├── 🧱 packages/
 │   ├── pythinker-core/           Provider-agnostic message, tool, and chat-provider abstractions
 │   ├── pythinker-host/           Local/remote host filesystem and command execution

vis/AGENTS.md dashboard/AGENTS.mdvis/AGENTS.md renamed to dashboard/AGENTS.md

@@ -1,25 +1,25 @@
-# Pythinker Vis UI (vis/)
+# Pythinker Dashboard UI (dashboard/)
 
 React 19 + Vite + TypeScript session-tracing visualizer, bundled into the `pythinker-code`
 package. It is a read-only viewer of Wire events, context messages, agent state, and subagent
 activity. Run all `npm` commands from this directory.
 
 ## Critical invariants
 
-- **`vis/src/lib/api.ts` is hand-written, not generated** (unlike `web/`, which has a generated
+- **`dashboard/src/lib/api.ts` is hand-written, not generated** (unlike `web/`, which has a generated
   client). Keep its types (`WireEvent`, `ContextMessage`, `SessionInfo`, `SubagentInfo`) in
-  sync by hand with the vis backend (`src/pythinker_code/vis/`) and the Wire protocol
+  sync by hand with the dashboard backend (`src/pythinker_code/dashboard/`) and the Wire protocol
   (`src/pythinker_code/wire/`) whenever either changes. There is no codegen step here.
-- **Do not hand-copy build output.** `scripts/build_vis.py` builds and syncs `vis/dist` →
-  `src/pythinker_code/vis/static`. No ad-hoc copy/rsync scripts.
-- **Read-only data plane.** It consumes `/api/vis/*` from the vis backend (port 5495) with a
+- **Do not hand-copy build output.** `scripts/build_dashboard.py` builds and syncs `dashboard/dist` →
+  `src/pythinker_code/dashboard/static`. No ad-hoc copy/rsync scripts.
+- **Read-only data plane.** It consumes `/api/dashboard/*` from the dashboard backend (port 5495) with a
   Bearer token taken from a URL query param; `cache.ts` dedupes in-flight requests. Do not add
   write/mutation calls here — mutations belong to the web UI / backend, not the visualizer.
 
 ## Stack and conventions
 
-- Build: `tsc -b && vite build`; dev: `npm run dev` (or `make vis-front`). Backend:
-  `make vis-back` (port 5495).
+- Build: `tsc -b && vite build`; dev: `npm run dev` (or `make dashboard-front`). Backend:
+  `make dashboard-back` (port 5495).
 - Styling: Tailwind + Radix UI / shadcn; `react-virtuoso` for efficient large-session lists.
 - Feature panels live under `src/features/` (`wire-viewer`, `context-viewer`, `agents-panel`,
   `state-viewer`, `sessions-explorer`).