Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
66 commits
Select commit Hold shift + click to select a range
0ec7070
docs(plans): add agent dashboards milestone 3 implementation plan
vishr Oct 8, 2026
4b739b7
feat(ui): render dashboard fragments in a single-file MCP app built f…
vishr Oct 8, 2026
6b70125
fix(ui): share variable, drill and zoom handling between dashboards a…
vishr Oct 8, 2026
fd4281e
feat(mcp,ui)!: serve chat views as dashboard fragments from one panel…
vishr Oct 8, 2026
c06c6f1
fix(mcp,ui): bound chat fragments and stop the app resize loop
vishr Oct 8, 2026
5960594
fix(ui): one contain-fitted layered service map for chat and dashboards
vishr Oct 8, 2026
1173d5b
fix(ui): restore compact service-map cards so every node keeps its name
vishr Oct 8, 2026
267adb4
fix(mcp,ui): reduce oversized fragments by row and keep map text read…
vishr Oct 8, 2026
546cec3
build: pin deadcode v0.50.0 and knip 6.38.0 for dead-code gates
vishr Oct 8, 2026
28db4bd
refactor!: remove superseded observability routes, caches and dead code
vishr Oct 8, 2026
6d4f039
fix: stabilise the rail, finish legacy cleanup and run every gate in CI
vishr Oct 8, 2026
25e48a9
feat(eval): add a reproducible dashboard authoring eval CLI with mock…
vishr Oct 8, 2026
9f42631
fix(eval): score against real server shapes and settle failed prompts…
vishr Oct 8, 2026
726d78c
fix(agent): keep intermediate step text out of chat answers
vishr Oct 8, 2026
640e843
feat(agent,ui): stream provisional text live without leaking narration
vishr Oct 8, 2026
44d4b44
fix(agent): document clientErrorCode and clientErrorMessage in place
vishr Oct 8, 2026
3d86688
fix(agent,ui): stream reasoning events and keep layout stable on fina…
vishr Oct 8, 2026
c597e53
feat(dashboard,mcp): return committed panel changes and post-save checks
vishr Oct 8, 2026
85cc00d
fix(dashboard): tag only moved panels and pin concurrent receipts in …
vishr Oct 8, 2026
d50d1c1
feat(chat,dashboard): show quiet build receipts and keep build proven…
vishr Oct 8, 2026
dcae8f6
refactor(chat): keep the receipt problem resolver private
vishr Oct 8, 2026
573fb88
fix(chat,mcp): report only observed receipt outcomes and keep provena…
vishr Oct 8, 2026
7549452
fix(db): index dashboard_origins by thread before the migration ships
vishr Oct 8, 2026
43f84e3
fix(chat): show interrupted saves as unknown instead of failed
vishr Oct 8, 2026
7013fa1
feat(mcp): list and restore dashboard versions with save receipts
vishr Oct 8, 2026
20bf93d
fix(mcp,chat): read structured tool errors everywhere and keep restor…
vishr Oct 8, 2026
3f11353
feat(dashboards): add version history with inspectable changes and re…
vishr Oct 8, 2026
97a765c
fix(dashboards): scope restore errors, guard theme tokens and refuse …
vishr Oct 8, 2026
9f06b8a
fix(dashboards): keep the history live status for screen readers only
vishr Oct 8, 2026
478c3d1
feat(dashboards,agent): share full-screen panels and keep Explain rea…
vishr Oct 8, 2026
3a78ca0
fix(ui,chat): real chat full-screen, readable end labels and scaled a…
vishr Oct 8, 2026
8c9c6d5
fix(ui): one close control in chat full-screen and unclipped end labels
vishr Oct 8, 2026
14a95a7
feat(dashboards): keyboard chart navigation, range selection and shor…
vishr Oct 8, 2026
234a6f5
fix(dashboards): make keyboard access work from page load and keep ra…
vishr Oct 8, 2026
5bdceb7
fix(dashboards): overlay keyboard chart controls without moving the plot
vishr Oct 8, 2026
61fbd1d
fix(dashboards): keep keyboard chart help out of the plot and legend
vishr Oct 8, 2026
394642e
fix(dashboards): show the full keyboard hint while a chart is focused
vishr Oct 8, 2026
59017e4
fix(dashboards): fit the focused chart hint on one subtitle line
vishr Oct 8, 2026
0e28ef2
feat(dashboards): lock log-pattern context, keep empty selections in …
vishr Oct 8, 2026
ae4c063
fix(dashboards): keep mouse clicks out of keyboard chart mode and set…
vishr Oct 9, 2026
5a17796
fix(dashboards): one drill URL form, literal quoted links and real pa…
vishr Oct 9, 2026
c38c44d
build(ui): pin @playwright/test 1.63.0 for the browser smoke test
vishr Oct 9, 2026
3ae922a
fix(dashboards): recover keyboard selection, scope panel retries and …
vishr Oct 9, 2026
342aca0
fix(agent): keep saved dashboard panels independent of one result's IDs
vishr Oct 9, 2026
502467e
docs(benchmarks): record the milestone 3 authoring benchmark
vishr Oct 9, 2026
df2d31c
test(e2e): add a browser smoke test for dashboards and chat fragments
vishr Oct 9, 2026
de31318
fix(dashboards): offer only working panel actions and announce refres…
vishr Oct 9, 2026
32e2663
fix(dashboards): let the server mark retryable panel errors and keep …
vishr Oct 9, 2026
ab346c5
test(e2e): wait for readiness and assert real chart content in the sm…
vishr Oct 9, 2026
a59642f
fix(dashboards): log a batch deadline once and open the compact fix t…
vishr Oct 9, 2026
ba5b0e7
fix(dashboards): span the panel window, fit the service map and keep …
vishr Oct 9, 2026
7bf9eb1
fix(dashboards): keep the log pattern summary out of the live region
vishr Oct 9, 2026
1cb33a2
fix(dashboards): snap packed rows to one height and keep charts insid…
vishr Oct 9, 2026
da812e5
fix(dashboards): fill packed rows across all twelve columns with one …
vishr Oct 9, 2026
84ad807
fix(dashboards): wrap unrouted services, keep chips off the legend an…
vishr Oct 9, 2026
36797d5
fix(dashboards): fade cropped service-map edges and let Fit show the …
vishr Oct 9, 2026
16f8185
docs(benchmarks): record milestone 3 final acceptance results
vishr Oct 9, 2026
f05ffa2
fix(panel): stop logging caller cancellations the engine reports as i…
vishr Oct 9, 2026
232f22c
fix(panel): treat engine interrupts as operational during spec checks
vishr Oct 9, 2026
5ca2254
docs(benchmarks): record the milestone 3 sealed holdout run
vishr Oct 9, 2026
1363d97
test(eval): create temporary roots under the OS temp directory
vishr Oct 9, 2026
59afe4a
ci(codeql): skip the generated panel app bundle
vishr Oct 9, 2026
ca4af2d
fix(notices): leave platform-specific optional packages out
vishr Oct 9, 2026
8108a9a
fix(panel,dashboard): bound edit-distance and order tables
vishr Oct 9, 2026
057a51a
test(query): time annotation history bounds after engine startup
vishr Oct 9, 2026
3309cb4
fix(build): copy the eval golden fixture into the UI image stage
vishr Oct 9, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 0 additions & 2 deletions .dockerignore
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,6 @@ bin/
fanout
ui/host/node_modules/
ui/host/dist/
ui/apps/node_modules/
ui/apps/dist/

# Dev files
.env
Expand Down
14 changes: 1 addition & 13 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
Expand Up @@ -33,9 +33,7 @@ updates:
go:
update-types: [minor, patch]

# The two browser workspaces are separate dependency graphs on purpose, and
# each carries its own `overrides` block pinning security fixes, so they are
# listed separately rather than as one glob.
# One browser workspace builds the SPA and portable MCP app.
- package-ecosystem: bun
directory: /ui/host
schedule:
Expand All @@ -46,16 +44,6 @@ updates:
host:
update-types: [minor, patch]

- package-ecosystem: bun
directory: /ui/apps
schedule:
interval: weekly
commit-message:
prefix: "chore(deps)"
groups:
apps:
update-types: [minor, patch]

# The documentation site is npm, not bun.
- package-ecosystem: npm
directory: /site
Expand Down
33 changes: 33 additions & 0 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -97,6 +97,39 @@ jobs:
- name: just test-race
run: just test-race

e2e:
name: Browser smoke
runs-on: ubuntu-24.04
timeout-minutes: 15
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
- uses: actions/setup-go@b7ad1dad31e06c5925ef5d2fc7ad053ef454303e # v7.0.0
with:
go-version-file: go.mod
cache: true
cache-dependency-path: go.sum
- uses: extractions/setup-just@53165ef7e734c5c07cb06b3c8e7b647c5aa16db3 # v4
- uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2.2.0
with:
bun-version: 1.4.2
- uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020 # v7.0.0
with:
node-version: 24.19.0
- name: just ui-deps
run: just ui-deps
- name: just e2e
run: just e2e
- name: Upload browser failures
if: failure()
uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
with:
name: browser-smoke-failure
path: |
ui/host/playwright-report/
ui/host/test-results/
if-no-files-found: ignore
retention-days: 7

# Build the exact runtime image on pull requests and reject high/critical OS,
# Go-binary, or embedded-secret findings before merge.
container-scan:
Expand Down
5 changes: 5 additions & 0 deletions .github/workflows/codeql.yml
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,11 @@ jobs:
with:
languages: ${{ matrix.language }}
build-mode: ${{ matrix.build-mode }}
# The single-file panel app is a minified build of ui/host, which is
# analysed from source; its vendored libraries only repeat alerts.
config: |
paths-ignore:
- internal/mcp/apps/panels.html

- if: matrix.build-mode == 'manual'
run: bash scripts/with-duckdb.sh go build ./...
Expand Down
4 changes: 2 additions & 2 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -20,8 +20,8 @@
ui/host/node_modules/
ui/host/dist/
ui/host/tsconfig.tsbuildinfo
ui/apps/node_modules/
ui/apps/dist/
ui/host/playwright-report/
ui/host/test-results/

# Documentation site workspace outputs.
site/node_modules/
Expand Down
4 changes: 2 additions & 2 deletions .golangci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,8 @@ run:

linters:
default: standard
enable:
- unused
exclusions:
generated: lax
presets:
Expand All @@ -17,5 +19,3 @@ linters:
text: "Close|Remove|Sscanf|Walk|Scan|Read|Export"
- linters: [staticcheck]
text: "QF"
- linters: [unused]
path: cmd/
6 changes: 3 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,16 +32,16 @@
- Dashboard file snapshots use each signal's actual event-time footer bounds,
including signed nanoseconds. Unknown statistics include the file. Never
substitute ingestion time or prune public arbitrary SQL from a dashboard scope.
- Endpoint histograms, log counts, and notable-trace candidates acknowledge
- Notable-trace candidates acknowledge
complete immutable batch IDs transactionally. Query cache markers and rows in
one read transaction under the pinned file snapshot; uncached active files
remain immediately visible. Compaction and retention must invalidate retired
contributions without double counting or losing late publications.
- Version disposable read-cache schema and semantics together; mismatches rebuild
all private read tables. Cache minute aggregates, per-batch trace bounds,
all private read tables. Cache per-batch trace bounds,
and one incremental candidate per trace, never individual event copies or
four globally rewritten scope indexes. Mixed trace scopes use batch parts. Exact
clipped minutes read footer-pruned Parquet, and compaction derives complete
scoped boundaries read footer-pruned Parquet, and compaction derives complete
output contributions from cached inputs. Body search matches redacted text.
Analytical service/edge watermark lag is separate. Completed-batch writes
have their own gate and write-pool slot; analytical writes use disjoint tables.
Expand Down
11 changes: 7 additions & 4 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,22 +47,25 @@ Run `just check` and `just test-race`. Together they match the CI gate:
formatting, linting, browser dependency audits, embedded-asset freshness, Go
and browser tests, then the Go suite under the race detector.

Run `just e2e` with Google Chrome installed for the separate CI browser smoke
suite. See [browser smoke testing](docs/testing.md) for coverage and failure artifacts.

`just install` also installs [Lefthook](https://lefthook.dev), which runs
formatting and linting on commit and the full gate on push. That is the fastest
way to avoid a red CI run.

Both browser workspaces use `package.json` overrides for transitive security
The browser workspace uses `package.json` overrides for transitive security
fixes that their direct dependencies have not locked yet. Keep those overrides
until the upstream ranges resolve to patched versions; `just ui-audit` accepts
no advisory exceptions.
only the existing build-only braces advisory exception documented in the justfile.

## Things that surprise people

**The browser assets are committed.** `ui/host` builds into `internal/ui/dist`
and `ui/apps` builds into `internal/mcp/apps`, and both outputs are tracked in
and its MCP app builds into `internal/mcp/apps`; both outputs are tracked in
git because `go:embed` needs them present in a source checkout. If you change
anything under `ui/`, run `just ui` and commit the regenerated output.
`just ui-check` fails when the committed bytes do not match a fresh build, so
`just ui-check` fails when the embedded bytes do not match a fresh build, so
CI catches this, but it is friendlier to catch it yourself.

**Diagrams are generated.** `docs/diagrams/*.svg` is rendered from the `.d2`
Expand Down
19 changes: 5 additions & 14 deletions Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -2,24 +2,15 @@

# Bun is a build compiler only. Neither Bun nor Node is copied into the final
# image or launched by the Fanout process.
FROM oven/bun:1.4.2@sha256:9114c058aeae42162ee16dd5084b95fe9473970bb6bcb5b232ab1630f0546895 AS ui-apps-build
WORKDIR /app
COPY ui/apps/package.json ui/apps/bun.lock ./ui/apps/
RUN cd ui/apps && bun install --frozen-lockfile
COPY ui/*.ts ./ui/
COPY ui/panels/ ./ui/panels/
COPY ui/apps/ ./ui/apps/
COPY internal/mcp/apps/ ./internal/mcp/apps/
RUN cd ui/apps && bun run build

FROM oven/bun:1.4.2@sha256:9114c058aeae42162ee16dd5084b95fe9473970bb6bcb5b232ab1630f0546895 AS ui-host-build
FROM oven/bun:1.4.2@sha256:9114c058aeae42162ee16dd5084b95fe9473970bb6bcb5b232ab1630f0546895 AS ui-build
WORKDIR /app
COPY ui/host/package.json ui/host/bun.lock ./ui/host/
RUN cd ui/host && bun install --frozen-lockfile
COPY ui/*.ts ./ui/
COPY ui/panels/ ./ui/panels/
COPY ui/host/ ./ui/host/
COPY internal/ui/ ./internal/ui/
# The build type-checks the host tests, and one reads the eval golden fixture.
COPY scripts/dashboard-eval/testdata/server.json ./scripts/dashboard-eval/testdata/
RUN cd ui/host && bun run build

# DuckDB needs CGO, so this stage must run on the target architecture — there
Expand All @@ -34,8 +25,8 @@ WORKDIR /app
COPY go.mod go.sum ./
RUN --mount=type=cache,target=/go/pkg/mod go mod download
COPY . .
COPY --from=ui-apps-build /app/internal/mcp/apps/ ./internal/mcp/apps/
COPY --from=ui-host-build /app/internal/ui/dist/ ./internal/ui/dist/
COPY --from=ui-build /app/internal/mcp/apps/ ./internal/mcp/apps/
COPY --from=ui-build /app/internal/ui/dist/ ./internal/ui/dist/
RUN --mount=type=cache,target=/go/pkg/mod \
--mount=type=cache,target=/root/.cache/go-build \
CGO_ENABLED=1 GOOS=${TARGETOS} GOARCH=${TARGETARCH} \
Expand Down
9 changes: 4 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -291,11 +291,11 @@ just test # Go tests
just ui # rebuild the embedded browser assets
```

The browser workspaces build **into** `internal/ui/dist` and
The `ui/host` workspace builds the SPA and MCP app **into** `internal/ui/dist` and
`internal/mcp/apps`, and those outputs are committed because `go:embed` needs
them present in a source checkout. The binary is therefore only ever as fresh
as the last UI build, so `just ui-check` rebuilds both workspaces and fails if
the committed bytes no longer match. It is part of `just check` and runs in CI.
as the last UI build. `just ui-check` compares temporary builds of both outputs
and fails if the embedded bytes no longer match. It is part of `just check` and runs in CI.

[Lefthook](https://lefthook.dev) runs formatting and linting on commit and the
full gate on push; `just install` wires it up. The pre-push hook is a
Expand All @@ -307,8 +307,7 @@ the same `just check` unconditionally, and that is what actually enforces it.
```text
cmd/fanout/ process composition and the single entry point
internal/ ingest, storage, query, agent, MCP, auth, alerts
ui/host/ React AG-UI browser host (build-time)
ui/apps/ portable React MCP Apps (build-time)
ui/host/ React browser host and shared MCP app renderer (build-time)
docs/diagrams/ d2 sources and rendered SVG
```

Expand Down
Loading
Loading