TextNLPClassifierApp/docs/operations.md

Production Operations & Maintenance Runbook

1. Operational Commands

1.1 Preflight Verification

python -m src.cli.preflight --config runtime_config.local.json

1.2 Smoke Test

python -m src.cli.smoke --config runtime_config.local.json

1.3 State & Artifact Reconciliation

python -m src.cli.reconcile --config runtime_config.local.json --cleanup-orphans

1.4 Telemetry Flush

python -m src.cli.telemetry_flush --config runtime_config.local.json --batch-size 100

2. Standard Consolidation Execution

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