Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -117,6 +117,12 @@ jobs:
slug: performance
skip_performance: ""
args: e2e/specs/app/performance.spec.ts
# The local Storybook catalog runs in its own job so the smoke group
# stays inside its timeout; `just check` stays browser-free.
- group: catalog
slug: catalog
skip_performance: "1"
args: ""
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
- uses: actions/setup-go@b7ad1dad31e06c5925ef5d2fc7ad053ef454303e # v7.0.0
Expand All @@ -134,9 +140,13 @@ jobs:
- name: just ui-deps
run: just ui-deps
- name: just e2e-browsers
if: matrix.slug == 'smoke'
if: matrix.slug == 'smoke' || matrix.slug == 'catalog'
run: just e2e-browsers
- name: just design-check
if: matrix.slug == 'catalog'
run: just design-check
- name: just e2e
if: matrix.slug != 'catalog'
run: just e2e ${{ matrix.args }}
env:
FANOUT_E2E_SKIP_PERFORMANCE: ${{ matrix.skip_performance }}
Expand Down
22 changes: 10 additions & 12 deletions THIRD_PARTY_NOTICES
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ COMPONENT INVENTORY
- Go: go.yaml.in/yaml/v3 v3.0.5
- Go: golang.org/x/crypto v0.58.0
- Go: golang.org/x/exp v0.0.0-20261011100332-faecfb24eb49
- Go: golang.org/x/net v0.61.0
- Go: golang.org/x/net v0.62.0
- Go: golang.org/x/oauth2 v0.37.0
- Go: golang.org/x/sync v0.24.0
- Go: golang.org/x/sys v0.49.0
Expand All @@ -74,10 +74,10 @@ COMPONENT INVENTORY
- Go: modernc.org/memory v1.12.1
- Go: modernc.org/sqlite v1.61.0
- Native: DuckDB v2.0.0 (d54cbbe3df)
- npm: @ag-ui/client 1.0.2 (declared license: MIT)
- npm: @ag-ui/core 1.0.2 (declared license: MIT)
- npm: @ag-ui/encoder 1.0.2 (declared license: MIT)
- npm: @ag-ui/proto 1.0.2 (declared license: MIT)
- npm: @ag-ui/client 1.0.4 (declared license: MIT)
- npm: @ag-ui/core 1.0.4 (declared license: MIT)
- npm: @ag-ui/encoder 1.0.4 (declared license: MIT)
- npm: @ag-ui/proto 1.0.4 (declared license: MIT)
- npm: @bufbuild/protobuf 2.16.0 (declared license: (Apache-2.0 AND BSD-3-Clause)); no license file was present in the installed package
- npm: @codemirror/autocomplete 6.20.3 (declared license: MIT)
- npm: @codemirror/commands 6.11.1 (declared license: MIT)
Expand Down Expand Up @@ -289,7 +289,6 @@ COMPONENT INVENTORY
- npm: walk-up-path 4.0.0 (declared license: ISC)
- npm: which 2.0.2 (declared license: ISC)
- npm: yaml 2.9.1 (declared license: ISC)
- npm: zod 3.25.76 (declared license: MIT)
- npm: zod 4.6.6 (declared license: MIT)
- npm: zrender 6.1.0 (declared license: BSD-3-Clause)
- npm: zwitch 2.0.4 (declared license: MIT)
Expand Down Expand Up @@ -753,10 +752,10 @@ Apache License

--- Applies to -------------------------------------------------------------
- Go: github.com/ag-ui-protocol/ag-ui/sdks/community/go v0.0.0-20260930215002-015baf5dc150 / LICENSE
- npm: @ag-ui/client 1.0.2 / LICENSE
- npm: @ag-ui/core 1.0.2 / LICENSE
- npm: @ag-ui/encoder 1.0.2 / LICENSE
- npm: @ag-ui/proto 1.0.2 / LICENSE
- npm: @ag-ui/client 1.0.4 / LICENSE
- npm: @ag-ui/core 1.0.4 / LICENSE
- npm: @ag-ui/encoder 1.0.4 / LICENSE
- npm: @ag-ui/proto 1.0.4 / LICENSE
----------------------------------------------------------------------------

MIT License
Expand Down Expand Up @@ -2870,7 +2869,7 @@ limitations under the License.
--- Applies to -------------------------------------------------------------
- Go: golang.org/x/crypto v0.58.0 / LICENSE
- Go: golang.org/x/exp v0.0.0-20261011100332-faecfb24eb49 / LICENSE
- Go: golang.org/x/net v0.61.0 / LICENSE
- Go: golang.org/x/net v0.62.0 / LICENSE
- Go: golang.org/x/oauth2 v0.37.0 / LICENSE
- Go: golang.org/x/sync v0.24.0 / LICENSE
- Go: golang.org/x/sys v0.49.0 / LICENSE
Expand Down Expand Up @@ -10581,7 +10580,6 @@ TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
THIS SOFTWARE.

--- Applies to -------------------------------------------------------------
- npm: zod 3.25.76 / LICENSE
- npm: zod 4.6.6 / LICENSE
----------------------------------------------------------------------------

Expand Down
71 changes: 71 additions & 0 deletions docs/testing.md
Original file line number Diff line number Diff line change
Expand Up @@ -283,6 +283,77 @@ Refresh the README's light and dark System overview captures with `just landing-

To record chat and dashboard clips, set `FANOUT_LANDING_RECORDINGS=1` and the external-instance variables above, then run `bun run e2e e2e/specs/app/landing-recordings.spec.ts --project=app-1440-light --project=app-1440-dark` from `ui/host`. Follow [landing-recordings.md](../site/scripts/landing-recordings.md) to encode and upload them.

## Local product catalog

Run `just design` to review the product at `http://127.0.0.1:6706`.
Use `just design 6707` for another port. Storybook is local review only, never
published. The Docs tab shows every state in each entry; pages and flows have
separate 800px iframes. Review light and dark at 1280×800 (the recording size)
and 1024×768 using the toolbar.

- `just design-check` runs every story and play in headless Chromium, in both
schemes at both widths. Install the locked browser with `just e2e-browsers`
first. Accessibility errors, clipped or overlapping text, horizontal page
overflow, covered scrollbars, and unexpected API requests fail the check.
- CI runs the catalog in the browser smoke job, after installing Chromium;
`just check` stays browser-free. The check uses one worker, no file
parallelism, and a 60-second story timeout to remain runnable on shared
machines.
- From `ui/host`, `bun run design-build` checks the static catalog build. Its
ignored `storybook-static/` output is for local inspection only.
- `bun run test` keeps the unit suite in `vitest.unit.config.ts`. The standard
`vitest.config.ts` owns only the catalog.

`Pages` uses the shipping route tree, shell, auth gate, query client, and screens
with memory history. Explore, Logs, Traces, and Alerts have full-page stories
in the same light/dark matrix. Explore includes FanQL fix-its and per-panel
validation diagnostics in both editors. Dashboard and receipt states show invalid
panels alongside successful siblings and a corrected save. Settings includes
chat-disabled and token-rotation states with a fictional `foi_` token.
The dashboard index opens the default dashboard when one
exists; an empty workspace shows its creation prompt. `Flows/Ask a question`
and `Flows/Ask chat for a dashboard` contain independently reproducible stages
and complete interactions through the real SSE client. Select the interactive
story canvas to replay the typing and focus steps; Docs does not autoplay plays.

For landing clips, select **Stream pace → Recording** in the Storybook toolbar
before replaying a flow: mocked tool calls take 1.5 seconds and text streams at
about 31 characters per second; catalog checks default to **Fast**.

Typed fixtures use fictional checkout, cart, accounting, and payment telemetry,
fixed timestamps and generated IDs. A fresh fetch service per story responds
only to listed API and MCP operations, records unexpected calls, and cancels
streams and timers during cleanup. Storage is mocked in memory per story.
No backend, provider, email, or persistent store is contacted.

The inline analysis stories use the shipping sandboxed `MCPAppFrame` and
AppBridge. Every design command first runs the shipping `vite.apps.config.ts`
build into an ignored dependency cache. Storybook serves that fresh `panels.html`
under `/catalog-apps`; the mocked MCP `resources/read` returns those exact bytes.
This leaves the committed app assets untouched and keeps the catalog current.
No alternate iframe markup or app transport is introduced.
The sandbox has an opaque origin, so parent-document accessibility and text
checks cannot inspect its contents. `Embedded/Analysis views` renders the same
shipping `FragmentView` directly to check health, latency, and service-map
content; the browser MCP suite continues to check the built iframe itself.

Keep stories and fixtures under their existing catalog locations. Both production
Vite builds reject any runtime import of `src/catalog`, `.storybook`, or a story
file. Knip excludes those local review inputs from its production analysis.

Known accessibility exceptions are recorded in `src/catalog/accessibility.ts`:
the shipping shell and dashboard/settings screens nest main landmarks; the
panel loader labels a span without a role; and the light-theme degraded-health
label measures 3.27:1 on white. The last two exceptions target only those elements;
all other contrast and ARIA checks remain active. Settings also exempts only
the existing hover-underlined Sending telemetry and MCP connection links from `link-in-text-block`
until its resting-state link treatment is fixed. The selected chat timestamp
also has a targeted contrast exception (3.9:1 on its light selection background). These exceptions preserve the
shipping UI within this catalog-only change and should be removed when the
product markup and semantic ink are corrected. Alerts exempts only its blank
actions-column header from `empty-table-header`; Logs exempts only expandable
table rows from `aria-conditional-attr` because they use `aria-expanded` without
a treegrid. Other table and ARIA checks stay active.

## FanQL performance checks

Expand Down
2 changes: 1 addition & 1 deletion go.mod
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ require (
github.com/wneessen/go-mail v0.8.1
github.com/zeebo/xxh3 v1.1.0
go.opentelemetry.io/proto/otlp v1.11.1
golang.org/x/net v0.61.0
golang.org/x/net v0.62.0
golang.org/x/oauth2 v0.37.0
golang.org/x/sync v0.24.0
golang.org/x/sys v0.49.0
Expand Down
4 changes: 2 additions & 2 deletions go.sum
Original file line number Diff line number Diff line change
Expand Up @@ -145,8 +145,8 @@ golang.org/x/exp v0.0.0-20261011100332-faecfb24eb49 h1:pQo5TwmxKJvI8k39uYS2Gqkk8
golang.org/x/exp v0.0.0-20261011100332-faecfb24eb49/go.mod h1:DBoxwWhjaW8DJJw/YeM4zpeOKMC1FMXSblsYy+1mFSw=
golang.org/x/mod v0.42.0 h1:ICeL3t2L30ljSPHHxDnR4fqVcBt/zR2zJAb9juavmQg=
golang.org/x/mod v0.42.0/go.mod h1:u5fzIrRInkL8MaO1cbRkUHT64v303YIT5KEqpNr7jRs=
golang.org/x/net v0.61.0 h1:RR+6j/BTBCrggOLugxa+66R8FvoN6MHlzDlZIbN9YFw=
golang.org/x/net v0.61.0/go.mod h1:WgDCOTH8iwtB66T4/GfI94AHo/hhdb7Hah9NDseQfiI=
golang.org/x/net v0.62.0 h1:18ELalfM5+XNRwzM2nYqXsZQ9ByS1uhj2O/U7+5jqRY=
golang.org/x/net v0.62.0/go.mod h1:WgDCOTH8iwtB66T4/GfI94AHo/hhdb7Hah9NDseQfiI=
golang.org/x/oauth2 v0.37.0 h1:JUlcxA8oAtauLfiH8FX2/FkAWHAdi0QtGCGc+hofE98=
golang.org/x/oauth2 v0.37.0/go.mod h1:IxwZNxUULJmpBFf9K/9NTMSIfZZuvuTy1gGxhigP/58=
golang.org/x/sync v0.24.0 h1:iqiDrGoDgyuvAKrhLQthUEzU/R378N78gXbBjxed7oA=
Expand Down

Large diffs are not rendered by default.

Large diffs are not rendered by default.

1 change: 0 additions & 1 deletion internal/ui/dist/assets/chat._threadId-BRElk84v.js

This file was deleted.

1 change: 1 addition & 0 deletions internal/ui/dist/assets/chat._threadId-BwQn9i54.js
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
import{t as e}from"./chat-J0n_1tmz.js";var t=e;export{t as component};
1 change: 0 additions & 1 deletion internal/ui/dist/assets/chat.index-BRElk84v.js

This file was deleted.

1 change: 1 addition & 0 deletions internal/ui/dist/assets/chat.index-BwQn9i54.js
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
import{t as e}from"./chat-J0n_1tmz.js";var t=e;export{t as component};
Loading
Loading