From 9177ac66ce9e7b68c2ebb539b005dc181ce6c2f9 Mon Sep 17 00:00:00 2001
From: David Blanc Brioir <davidblancbrioir@gmail.com>
Date: Sun, 1 Feb 2026 22:44:00 +0100
Subject: [PATCH] Add /daemon/status documentation to README2

- Document daemon status endpoint with JSON response example
- Add mode interpretation guide (idle/conversation/autonomous)
- Update endpoints table with /daemon/status

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 ikario_processual/README2.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/ikario_processual/README2.md b/ikario_processual/README2.md
index 41c8652..a17c250 100644
--- a/ikario_processual/README2.md
+++ b/ikario_processual/README2.md
@@ -266,6 +266,7 @@ uvicorn ikario_processual.api:app --reload --port 8100
 | `/vigilance` | GET | Vérifier la dérive vs x_ref |
 | `/metrics` | GET | Métriques du système |
 | `/profile` | GET | **Profil processuel complet (100 directions)** |
+| `/daemon/status` | GET | **Statut sémiose interne (mode, rumination)** |
 | `/reset` | POST | Réinitialiser à S(0) |
 
 ### Endpoint `/profile`
@@ -288,6 +289,36 @@ Retourne les projections d'Ikario et David sur les 100 directions :
 }
 ```
 
+### Endpoint `/daemon/status`
+
+Retourne l'état de la sémiose interne d'Ikario :
+
+```json
+{
+  "mode": "autonomous",           // idle | conversation | autonomous
+  "is_ruminating": true,
+  "last_trigger": {
+    "type": "rumination_free",
+    "timestamp": "2026-02-01T22:38:33Z"
+  },
+  "cycles_breakdown": {
+    "user": 1,
+    "veille": 0,
+    "corpus": 0,
+    "rumination_free": 1
+  },
+  "cycles_since_last_user": 1,
+  "time_since_last_user_seconds": 5.5
+}
+```
+
+**Interprétation :**
+- `mode: "idle"` → En attente
+- `mode: "conversation"` → Dialogue avec utilisateur
+- `mode: "autonomous"` + `is_ruminating: true` → **Sémiose interne** 🧠
+
+---
+
 ### Calcul des Tenseurs
 
 #### Ikario (état courant)