# Repo runtime map

## Existing runtime pieces

- Assistant backend: `llm_normalizer/backend`
- Technical export formatter: `llm_normalizer/frontend/src/utils/conversationExport.ts`
- Async single-case runner: `POST /api/eval/run-async/start`
- Async polling: `GET /api/eval/run-async/:job_id`
- Session store path: `llm_normalizer/data/assistant_sessions/<session_id>.json`
- Session API: `GET /api/assistant/session/:session_id`

## Capture strategy for this repo

1. Prefer automated capture with:
   - `python scripts/domain_case_loop.py run-case ...`
2. If baseline already exists as copied markdown export, import it with:
   - `python scripts/domain_case_loop.py import-export ...`
3. Use `baseline_turn.json` / `rerun_turn.json` as canonical analyst input.
4. Use `baseline_output.md` / `rerun_output.md` as human-readable paired artifacts.

## Default run assumptions

- backend URL: `http://127.0.0.1:8787`
- eval target: `assistant_stage1`
- single-case async run uses generated case id `AUTO-001`
- artifact root: `artifacts/domain_runs/<case_id>/`

## Important constraints

- Reuse current assistant runtime; do not build a parallel execution lane.
- Preserve UTF-8 without BOM for every generated artifact.
- Do not overwrite existing AGENTS rules; extend them.