# Multi-Chat Architecture
> Node runtime service construction is documented separately in [`node/serviceBootstrapping.md`](node/serviceBootstrapping.md). Host
194k5d agoReviewMountCreate a free account to mount
overridden sections) and the full config at `trace`. Keep new config shapes summarizable there.
- **Tests.** `../../../test/node/agentHostPromptRegistry.test.ts` covers the registry/wiring; `../../../test/node/toolInstructions.test.ts` covers the composition/gating. Add cases there, not new harnesses
194k5d agoReviewMountCreate a free account to mount
Agent host unit tests
For tests in this area that touch the SessionDatabase, they MUST use an in-memory database, not a real database file on disk. Use `SessionDatabase.open(':memory
194k5d agoReviewMountCreate a free account to mount
generator.
- `.github/workflows/`: CI pipelines for PR quality validation, stale checks, site deployment, and Go tests.
## When Modifying the Awesome List
- Read and respect `CONTRIBUTING.md` (alphabetical order, one item
191k4y agoReviewMountCreate a free account to mount
files, and the
`check-env-defaults-blank` pre-commit hook (plus the matching unit test in
`single-container/tests/test_runtime_config.py`, which CI runs) asserts that
the settings listed in `BLANK
188k11d agoReviewMountCreate a free account to mount
task and the code it touches. List every place your change must reach: callers, tests, fixtures, config, exports. Check what your change could break for users: data it would destroy
Steady11 mentions in 2 weeks
No other project uses it yet
182k5mo agoReviewMountCreate a free account to mount
AUTH_AZURE_AD_ISSUER=
```
Optional features:
```
OPENAI_API_KEY= # For AI-powered semantic search
```
## Testing
Currently no automated tests. When implementing:
- Place tests adjacent to source files or in `__tests
2 projects use a version of this
175k9mo agoReviewMountCreate a free account to mount
lint` / `npm run js-lint` — lint
- `npm run docs-build` — build docs site
- `npm test` — full test suite (lint + dist + tests + docs)
## Writing style
Use ASD-STE100 Simplified Technical English
No other project uses it yet
175k25d agoReviewMountCreate a free account to mount
docstrings.
- `make check-repo` — `make typing` plus consistency checks.
- `RUN_SLOW=1 pytest ...` — many tests are marked slow and skipped in CI.
Run `make style` (or `make fix-repo
No other project uses it yet
168k56d agoReviewMountCreate a free account to mount
docs/BACKEND_DATABASE_SCHEMA.md) guides.
## Repository Gotchas
- Run backend commands through `uv run --project api `.
- Backend integration tests are CI-only and are not expected to run locally.
- Keep `docker/.env.example` limited to variables
160k4d agoReviewMountCreate a free account to mount
repository root:
- Format and lint: `make lint`
- Type check: `make type-check`
- Unit tests: `make test`
- Targeted tests: `make test TARGET_TESTS=./api/tests/ `
Run direct Python commands through
160k4d agoReviewMountCreate a free account to mount
requires the Bun version pinned in `.bun-version`; command-tree generation and the `dev`, `test`, and `build` pre-scripts invoke it. Read [`ARD.md`] before adding a command or changing shared
No other project uses it yet
160k4d agoReviewMountCreate a free account to mount
agent/`:
- Lint: `make check`
- Format and fix lint: `make fix`
- Type check: `make typecheck`
- Tests: `make test`
Use the package's `uv` environment and Pydantic v2 APIs. Inspect current dependency
160k4d agoReviewMountCreate a free account to mount
when a required fixture is missing.
## Browser, API, And Contract Boundaries
The action under test belongs to the browser. APIs may prepare fixtures, poll persistence, and clean up; they
160k4d agoReviewMountCreate a free account to mount
port. Switch to the Next.js development server (`pnpm -C web dev:next`) only when testing Next.js-specific functionality or investigating behavior that differs from Next.js.
- Read `docs/test.md` only for frontend
160k4d agoReviewMountCreate a free account to mount
make format_frontend # Format TypeScript (biome)
make format # Both
make lint # mypy type checking
```
### Testing
```bash
make unit_tests # Backend unit tests (pytest, parallel)
make unit_tests async=false # Sequential
Steady6 mentions in 2 weeks
No other project uses it yet
156k2mo agoReviewMountCreate a free account to mount