(llm-first): context budget, validation, and eval harness, orchestration general-prompt

README.md

@@ -8,25 +8,29 @@ It is not a new generator engine and it is not a compiler platform. The reposito
 - `client/` as the active frontend target output path
 - an LLM-first orchestration baseline with CLI-first framework bootstrap
 - a compact rule set that strengthens the existing pipeline with:
-  - `domain-summary.json`
+  - `api-summary.json` (deterministic intermediate context)
   - a physical root-level realm artifact
   - a lightweight automated validation gate
 
 ## Active knowledge blocks
 
-The active prompt corpus is intentionally normalized to six stable blocks:
+The master generation prompt is `prompts/general-prompt.md`. It contains the complete
+generation workflow, type mappings, naming conventions, and all core rules.
 
-1. [prompts/general-prompt.md](prompts/general-prompt.md)
-2. [prompts/auth-rules.md](prompts/auth-rules.md)
-3. [prompts/backend-rules.md](prompts/backend-rules.md)
-4. [prompts/frontend-rules.md](prompts/frontend-rules.md)
-5. [prompts/runtime-rules.md](prompts/runtime-rules.md)
-6. [prompts/validation-rules.md](prompts/validation-rules.md)
+Companion rule files for artifact-specific details:
+
+1. [prompts/general-prompt.md](prompts/general-prompt.md) — master generation prompt
+2. [prompts/auth-rules.md](prompts/auth-rules.md) — auth seam / realm spec
+3. [prompts/backend-rules.md](prompts/backend-rules.md) — backend reference
+4. [prompts/frontend-rules.md](prompts/frontend-rules.md) — frontend reference
+5. [prompts/prisma-rules.md](prompts/prisma-rules.md) — Prisma schema rules
+6. [prompts/runtime-rules.md](prompts/runtime-rules.md) — runtime / bootstrap
+7. [prompts/validation-rules.md](prompts/validation-rules.md) — validation gate
 
 ## Baseline contracts
 
-- `domain/*.dsl` is the source of truth for the domain model.
-- [domain-summary.json](domain-summary.json) is a derived artifact for LLM stabilization and validation.
+- `domain/*.api.dsl` is the single source of truth for the domain model and API contract.
+- [api-summary.json](api-summary.json) is a derived artifact for LLM stabilization and validation.
 - [toir-realm.json](toir-realm.json) is the physical Keycloak bootstrap artifact baseline.
 - `server/` and `client/` are the active target output paths for this repository.
 - `server/` must remain a valid NestJS workspace baseline.
@@ -45,7 +49,7 @@ The active prompt corpus is intentionally normalized to six stable blocks:
 
 - The active prompts define forbidden generation patterns, required invariants, and recovery rules for future agents.
 - Buildability is part of the baseline contract, not an optional follow-up.
-- Validation targets `domain/*.dsl` as reusable source inputs, while TOiR names remain project defaults/examples.
+- Validation targets `domain/*.api.dsl` as reusable source inputs, while TOiR names remain project defaults/examples.
 
 ## Repository layout
 
@@ -56,13 +60,19 @@ The active prompt corpus is intentionally normalized to six stable blocks:
 ## Commands
 
 ```bash
-npm run generate:domain-summary
+npm run generate:api-summary
 npm run validate:generation
 npm run validate:generation:runtime
+npm run eval:generation
 ```
 
-`npm run validate:generation` now checks both contract shape and workspace validity. When dependencies are installed, it also verifies `npm run build` in `server/` and `client/`. If dependencies are missing, it reports build verification as skipped instead of pretending the baseline is fully green.
+`npm run validate:generation` checks both contract shape and workspace validity. When dependencies are installed, it also verifies `npm run build` in `server/` and `client/`. If dependencies are missing, it reports build verification as skipped instead of pretending the baseline is fully green.
 
-## AID export (OpenAPI + app generator)
+## AID export (OpenAPI)
 
-HTTP-экспортёры для интеграции с AID: **`POST /aid/export/openapi`** (api-format → OpenAPI 3.0) и **`POST /aid/export/app`** (DSL → бандл файлов или `--apply`). Подробно: **[docs/AID_EXPORT_README.md](docs/AID_EXPORT_README.md)**.
+HTTP-экспортёр для интеграции с AID: **`POST /aid/export/openapi`** (api-format → OpenAPI 3.0). Подробно: **[docs/AID_EXPORT_README.md](docs/AID_EXPORT_README.md)**.
+
+> **Note:** The `POST /aid/export/app` endpoint (DSL → generated app bundle) is currently
+> non-operative because its backing script (`generation/generate.mjs`) was removed during
+> the architecture migration to api.dsl-first generation. See `docs/AID_EXPORT_README.md`
+> for details.