next-tjwater-frontend/AGENTS.md

Repository Guidelines

Project Structure

This is a Vite React single-page WebGIS Agent workbench. Runtime TypeScript lives under src/.

• src/app/: application shell and providers.
• src/features/agent/: controlled Agent UI protocol, schemas, renderer, and views.
• src/features/map/: WebGIS map shell and future MapLibre/deck.gl integrations.
• src/shared/: reusable UI, config, styles, and utilities.
• src/mocks/: MSW handlers and fixtures for backend-independent development.
• src/test/: Vitest setup.
• server/: same-origin Edge TTS adapter used by Vite and the production container.

Commands

Use pnpm.

pnpm dev
pnpm build
pnpm typecheck
pnpm lint
pnpm test
pnpm test:browser

Coding Notes

Use TypeScript and React function components. Prefer explicit exported types at module boundaries. Keep Agent dynamic UI rendering schema-driven: Agent output must be validated before it reaches React components.

Do not add Next.js APIs or general BFF routes to this frontend. Agent behavior belongs in the Agent service; the local server/ exception is limited to the same-origin Edge TTS network adapter.