Protocole de contrôle

Fichier runtime

Quand vectron start réussit, les informations runtime sont écrites dans .vectron/runtime.json.

Ce fichier enregistre:

• le PID du processus Vectron
• la racine du workspace
• le chemin de configuration
• le dossier de logs
• le chemin de socket local ou l’adresse de named pipe

Requêtes

Le protocole texte minimal inclut:

• status
• restart <process|process#n>
• logs [<process|process#n>] [json] [once|no-follow] [source=<process|probe|hook|internal>] [failed]

La source de logs par défaut est all; les clients n’ont pas besoin d’envoyer un token de source pour ce comportement. failed limite les logs aux événements d’échec de commandes structurées.

Réponse status

status retourne des lignes tabulées avec les colonnes:

• PROCESS
• INSTANCE
• PID
• PORT
• STATE
• LOG_MODE

Réponse logs

Les logs texte utilisent:

• une ligne de handshake
• un en-tête de connexion
• des lignes de streaming

Les logs JSON sont retournés en JSONL.

Les enregistrements JSON incluent:

• source: process, probe, hook ou internal
• level: sévérité structurée
• metadata: détails clé/valeur propres à la source

Périmètre

Cet endpoint de contrôle est une infrastructure locale de workspace. Ce n’est pas une API distante publique.