feat(runtime): implement single-article consolidation runtime and modularize codebase

2026-08-24 00:14:07 -03:00
parent e1e0be1353
commit 23de7d8fe7
176 changed files with 266754 additions and 10179 deletions
@@ -0,0 +1,35 @@
+# Production Operations & Maintenance Runbook
+
+## 1. Operational Commands
+
+### 1.1 Preflight Verification
+```bash
+python -m src.cli.preflight --config runtime_config.local.json
+```
+
+### 1.2 Smoke Test
+```bash
+python -m src.cli.smoke --config runtime_config.local.json
+```
+
+### 1.3 State & Artifact Reconciliation
+```bash
+python -m src.cli.reconcile --config runtime_config.local.json --cleanup-orphans
+```
+
+### 1.4 Telemetry Flush
+```bash
+python -m src.cli.telemetry_flush --config runtime_config.local.json --batch-size 100
+```
+
+## 2. Standard Consolidation Execution
+```bash
+python -m src.cli.consolidate -i <article.json> -e <ecp_snapshot.json> -c runtime_config.local.json
+```
+
+### Exit Codes
+- `0`: Completed successfully / Rejected by ECP
+- `1`: Invalid article or ECP schema
+- `2`: Configuration or preflight error
+- `3`: Failed processing / LLM failure
+- `4`: Persistence failure