docs consolidation

2025-12-24 12:38:14 +02:00
parent 7503c19b8f
commit 9a08d10b89
215 changed files with 2188 additions and 9623 deletions
--- a/docs/modules/telemetry/prep/046_TLTY0101-concelier-observability-schema.md
+++ b/docs/modules/telemetry/prep/046_TLTY0101-concelier-observability-schema.md
@@ -1,58 +0,0 @@
-# 046_TLTY0101 · Concelier Observability Baseline (Ingest Health)
-
-Date: 2025-11-23
-
-Scope: Minimal, deterministic telemetry schema for Concelier ingest health endpoints so downstream services (Console widgets, health/timeline SSE) can proceed.
-
-## Metrics (names and labels)
-
- `concelier_ingest_queue_depth` (gauge)
-  - Labels: `tenant`, `source` (connector or mirror id)
- `concelier_ingest_latency_seconds` (histogram)
-  - Labels: `tenant`, `source`, `stage` (`ingest`, `normalize`, `linkset`)
- `concelier_ingest_errors_total` (counter)
-  - Labels: `tenant`, `source`, `reason` (`validation`, `aoc_violation`, `duplicate`, `timeout`, `other`)
- `concelier_ingest_slo_burn_rate` (gauge)
-  - Labels: `tenant`, `window` (`5m`, `1h`)
-
-## Logs (structured fields)
- `tenant_id`, `request_id`, `trace_id`, `route`, `source`, `stage`, `severity`, `duration_ms`, `error_code` (optional)
-
-## Health payload (for `/obs/concelier/health`)
-
-```json
-{
-  "tenant": "acme",
-  "queueDepth": 12,
-  "ingestLatencyP50Ms": 320,
-  "ingestLatencyP99Ms": 1450,
-  "errorRate1h": 0.002,
-  "sloBurnRate": 0.8,
-  "window": "5m",
-  "updatedAt": "2025-11-23T12:00:00Z"
-}
-```
-
-## Timeline event (for `/obs/concelier/timeline` future task)
-
-```json
-{
-  "type": "ingest.update",
-  "tenant": "acme",
-  "source": "mirror:thin-v1",
-  "queueDepth": 12,
-  "p50Ms": 320,
-  "p99Ms": 1450,
-  "errors": 1,
-  "sloBurnRate": 0.8,
-  "traceId": "4f7c...",
-  "occurredAt": "2025-11-23T12:00:00Z"
-}
-```
-
-## Acceptance
- Add these metric/log names and labels to service instrumentation.
- Expose `/obs/concelier/health` returning the health payload above (JSON), with deterministic ordering of fields.
- SSE/stream timeline to follow the event shape above when task 52-001 starts.
-
-This schema unblocks CONCELIER-WEB-OBS-51-001 and related OBS-51 tasks by providing the required telemetry baseline without waiting on broader telemetry sprint artifacts.
--- a/docs/modules/telemetry/prep/2025-11-20-obs-50-002-prep.md
+++ b/docs/modules/telemetry/prep/2025-11-20-obs-50-002-prep.md
@@ -1,16 +0,0 @@
-# Telemetry Context Propagation Prep — PREP-TELEMETRY-OBS-50-002
-
-Status: Draft (2025-11-20)
-Owners: Telemetry Core Guild
-Scope: Context propagation middleware/adapters for HTTP, gRPC, background jobs, CLI.
-
-## Proposed propagation fields
- `trace_id`, `span_id`, `tenant_id`, `actor`, `imposed_rule`, `correlation_id`.
- Async resume harness for job queue workers.
-
-## Open decisions
- Final field names and required/optional list.
- Which carriers (headers) per transport: HTTP (`x-` headers), gRPC metadata, CLI env.
-
-## Handoff
-Use as prep artefact; update once field list and carriers are finalized.
--- a/docs/modules/telemetry/prep/2025-11-20-obs-51-001-prep.md
+++ b/docs/modules/telemetry/prep/2025-11-20-obs-51-001-prep.md
@@ -1,12 +0,0 @@
-# Telemetry Metrics Helpers Prep — PREP-TELEMETRY-OBS-51-001
-
-Status: Draft (2025-11-20)
-Owners: Telemetry Core Guild · Observability Guild
-Scope: Metrics helpers for golden signals with exemplar support and cardinality guards.
-
-## Needs
- Golden signal definitions (latency, errors, saturation, traffic) with exemplar tagging guidance.
- Roslyn analyzer rules to prevent unsanitised labels.
-
-## Handoff
-Prep artefact; fill when golden signal label set is finalized.