integ: merge ORCH-068 reconciler livelock fix

# Conflicts:
#	docs/architecture/README.md
#	src/reconciler.py

src/config.py

@@ -295,6 +295,18 @@ class Settings(BaseSettings):
     reconcile_notify_unblock: bool = True
     reconcile_skip_blocked_enabled: bool = True
 
+    # ORCH-068: TTL for the per-project Plane states cache (_STATES_CACHE in
+    # plane_sync). Historically the cache lived for the whole process lifetime,
+    # so a status added to Plane after start was never seen without a restart
+    # ("stale set -> no pipeline action"). With a TTL the entry self-heals by
+    # re-fetching /states/ after it expires (invalidation reuses the existing
+    # reload_project_states() primitive — no duplicated reset logic).
+    #   plane_states_ttl_s (env ORCH_PLANE_STATES_TTL_S):
+    #     >0 -> seconds before a cache entry is re-fetched (default 300 = 5 min);
+    #      0 -> disable TTL -> strictly the previous lifetime cache (back-compat
+    #           escape hatch). get_project_states return shape is unchanged.
+    plane_states_ttl_s: int = 300
+
     # ORCH-021: post-deploy production monitoring + degradation reaction. After
     # the terminal deploy->done transition for an applicable repo, a reserved-agent
     # `post-deploy-monitor` job (no LLM, modelled on deploy-finalizer) probes prod