Read UI development before changing ui/.
For shared components also read catalog guidance.
Both are in this repository; coordinate component and caller changes together.
- Trace API changes through shared schemas and generated clients.
src/gen/,src/utils/PQLParsing/grammar/, andpqDocs.jsonare generated. Editor help is authored ineditor-hints/editor-hints.json; regenerate withnpm --prefix ui run generate:editor-helpfrom the repository root. Other files undersrc/utils/PQLParsing/include authored code.- Use existing query keys, invalidation helpers, route loaders, mocks, and tests.
- From the repository root use
npm --prefix ui run type-check,npm --prefix ui run lint-check, and focusednpm --prefix ui run test -- --runchecks. - Browser tools are optional. Use available local browser/test tooling and report missing visual evidence; do not require a particular MCP service.