status

Vue d’ensemble

status est l’outil à appeler en premier dans chaque session. Il vérifie la connectivité de chaque dépendance externe (forge git, IP Secure / Jinnove, Hub d’entreprise, Notion, Jira, N8N) et fait un check de santé du ledger local.

Note

C’est le point d’entrée de l’expérience agentique. Un agent SESHAT doit appeler status au début de chaque session — l’utilisateur peut être rappelé à l’ordre si l’agent saute cette étape.

Paramètres

verbose boolean défaut: false

Si true, inclut la liste détaillée des projets avec leurs sources configurées.

Réponse

{
  "git_host": {
    "status": "connected",
    "url": "https://api.github.com",
    "user": "julien"
  },
  "ip_secure": {
    "status": "connected",
    "api_url": "https://api.jinnove.com/ipsecure-api",
    "linked_projects": 3
  },
  "hub": {
    "status": "configured",
    "url": "https://hub.entreprise.fr",
    "queue_pending": 0,
    "queue_pushed_total": 42,
    "queue_failed_total": 0
  },
  "notion": {
    "status": "connected",
    "bot_name": "SESHAT"
  },
  "jira": {
    "status": "connected",
    "base_url": "https://votreorg.atlassian.net",
    "user_email": "julien@votreorg.fr"
  },
  "n8n": {
    "status": "not_configured"
  },
  "database": {
    "status": "healthy",
    "total_records": 142,
    "by_project": {
      "mon-projet": 100,
      "autre-projet": 42
    },
    "by_category": {
      "RESEARCH": 80,
      "CODE": 62
    }
  },
  "last_proof": "2026-05-27T10:30:00Z",
  "projects": [
    {
      "id": "mon-projet",
      "name": "Mon Projet",
      "has_repo": true,
      "has_vault": true,
      "has_notion": true,
      "has_jira": false,
      "has_n8n": false,
      "ipsecure_linked": true
    }
  ]
}

Champs de réponse

git_host object

Connectivité forge. status ∈ connected | disconnected | not_configured. Quand connected, inclut le user authentifié (utile pour vérifier que le PAT est le bon).

ip_secure object

Connectivité IP Secure / Jinnove. status ∈ connected | disconnected | not_configured. linked_projects indique combien de projets SESHAT ont un ipsecure_project_id associé.

hub object

Si un Hub d’entreprise est configuré (HUB_URL), inclut le statut de la queue locale (hub_push_queue) : combien de preuves attendent un push, combien ont été poussées, combien ont échoué définitivement.

notion / jira / n8n object

Connectivité de chaque source de recherche externe. status ∈ connected | disconnected | not_configured.

database object

Statistiques du ledger SQLite local. status ∈ healthy | corrupted | locked. Inclut les comptes par projet et par catégorie.

last_proof string

Timestamp ISO de la dernière entrée scellée — toutes catégories confondues. Utile pour repérer un projet inactif.

projects array

Liste des projets (uniquement avec verbose: true). Chaque projet expose les flags de configuration : has_repo, has_vault, has_notion, has_jira, has_n8n, ipsecure_linked.

Avertissements à afficher

L’agent doit prévenir l’utilisateur quand :

Attention

Forge déconnectée : si git_host.status ≠ connected, les seals PR / commit / tag échoueront. Vérifier GIT_HOST_TOKEN.

Attention

IP Secure non configuré : si ip_secure.status === not_configured, les seals fonctionneront en mode local uniquement (pas de certificat eIDAS). Acceptable pour usage personnel, à clarifier avec l’utilisateur si l’objectif est un dépôt légal.

Attention

Queue Hub bloquée : si hub.queue_pending > 0 et hub.queue_failed_total > 0, le worker n’arrive plus à pousser. Souvent un Hub indisponible ou un token expiré. Lancer seshat hub flush pour relancer manuellement.

Exemples

Check basique

MCP Prompt

Vérifie le statut SESHAT

Réponse

{
  "git_host": { "status": "connected", "user": "julien" },
  "ip_secure": { "status": "connected", "linked_projects": 3 },
  "database": { "status": "healthy", "total_records": 142 },
  "last_proof": "2026-05-27T10:30:00Z"
}

Mode verbeux

MCP Prompt

Statut SESHAT avec verbose pour lister les projets

Réponse

{
  "...": "...",
  "projects": [
    {
      "id": "espace-alberto",
      "name": "Espace Alberto",
      "has_vault": true,
      "has_notion": true,
      "has_jira": true,
      "ipsecure_linked": true
    }
  ]
}

Quand l’appeler

Scénario	Action
Début de session	Toujours — c’est la convention agentique
Avant une certification massive	Vérifier que les sources de recherche répondent
Après une erreur	Identifier rapidement si c’est un problème de connectivité ou de config
Avant un bundle de release	S’assurer que tout est opérationnel
Diagnostic général	Combiner avec seshat doctor (CLI) pour les checks DB profonds