Used co-pilot for complete review of all documentation, including extensive revision of v1.md

This commit is contained in:
Jim Lancaster
2026-07-02 12:37:32 -05:00
parent 97cb7055d4
commit ec61013b47
17 changed files with 155 additions and 2894 deletions
+3 -3
View File
@@ -41,7 +41,7 @@ The system uses stable, implementation-independent categories:
| --- | --- | --- | --- |
| `validation_error` | Payload or parameter shape/content is invalid | UI/API input validation, service guards | no |
| `user_input_error` | User-provided artifact is unacceptable though structurally valid | unsupported file type, empty file, oversized upload | sometimes |
| `not_found_error` | Requested resource does not exist | missing job/document/transcript | no |
| `not_found_error` | Requested resource does not exist | missing job/document/source/revision | no |
| `conflict_error` | Requested operation violates current state constraints | invalid state transition | no |
| `external_provider_error` | External AI/provider call fails | upstream HTTP/API/provider failures | sometimes |
| `infrastructure_transient_error` | Temporary environment issue | network timeout, DB connection reset | yes |
@@ -111,7 +111,7 @@ All logged errors must include, where available:
- `category`
- `operation` (e.g., `upload.submit`, `worker.process_job`, `jobs.refresh`)
- `exception_type`
- `job_id`, `document_id` (when relevant)
- `job_id`, `document_id`, `source_id` (when relevant)
- UTC timestamp
Rules:
@@ -271,7 +271,7 @@ Change requirements:
- [System overview](index.md)
- [Architecture](architecture.md)
- [Requirements](requirements.md)
- [Intent](intent.md)
- [Intent](Intent.md)
## Glossary