overmind-mcp 3.5.1 → 3.6.0

package/docs/overmind-bridge-persistent-agents.md

@@ -0,0 +1,463 @@
+# 🌉 Architecture 6 Bridges Isolés NEXUS — Peer-to-Peer
+
+> **Version**: NEXUS V17 — Architecture corrigée 2026-07-09
+> **Pattern**: 6 processes `overmind-bridge` INDÉPENDANTS, communication HTTP A2A inter-bridges
+> **PAS de dispatcher central sur :3100** — chaque bridge a son port, son agent, son .env, ses logs
+
+---
+
+## ❌ Ce que ce n'est PAS
+
+- ❌ Un seul `OverBridgeServer` partagé sur :3100 qui dispatche
+- ❌ Un `OvermindBridge` qui route les appels vers les 6 agents
+- ❌ Un bridge "central" qui connaît tous les agents
+
+## ✅ Ce que c'est
+
+Chaque agent NEXUS = **un process `overmind-bridge server` autonome** avec :
+- Son propre port dédié
+- Son agent dédié (configuré via flag)
+- Son propre .env (clés API, peers)
+- Ses propres logs
+- Ses propres clients HTTP vers les autres bridges
+
+La communication A2A = **HTTP POST inter-bridges** : agent A veut parler à agent B → POST `http://localhost:<port_b>/rpc` avec `agent.run`.
+
+---
+
+## Allocation des Ports
+
+| Bridge # | Port | Agent | Runner | Script |
+|----------|------|-------|--------|--------|
+| #1 | **:3101** | `nexus_master` | hermes | `start-bridge-master.ps1` |
+| #2 | **:3102** | `nexus_trader` | hermes | `start-bridge-trader.ps1` |
+| #3 | **:3103** | `nexus_risk_manager` | hermes | `start-bridge-risk.ps1` |
+| #4 | **:3104** | `nexus_healer` | hermes | `start-bridge-healer.ps1` |
+| #5 | **:3105** | `nexus_researcher` | hermes | `start-bridge-researcher.ps1` |
+| #6 | **:3106** | `nexus_publisher` | hermes | `start-bridge-publisher.ps1` |
+
+## Services PARTAGÉS (single instance, utilisés par les 6 bridges)
+
+| Service | Port | Pourquoi single |
+|---------|------|------------------|
+| **Overmind MCP Server** | :3099 | Routing centralisé — tous les bridges passent par lui pour `run_agent` |
+| **Hermes Gateway API** | :8642 | `X-Hermes-Profile` header route vers le bon profil — 1 process Python = 6 profils |
+| **PostgreSQL** | :5432 | `MessageLog` partagé — tous les bridges écrivent leurs A2A messages dans la même table `bridge_messages` |
+
+---
+
+## Topologie Réseau
+
+```
+┌────────────────────────────────────────────────────────────────────────┐
+│                   6 BRIDGES ISOLÉS — P2P                                │
+│                                                                        │
+│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐    │
+│  │ :3101           │    │ :3102           │    │ :3103           │    │
+│  │ nexus_master    │◄──►│ nexus_trader    │◄──►│ nexus_risk_mgr  │    │
+│  │ bridge.ts       │    │ bridge.ts       │    │ bridge.ts       │    │
+│  └────────┬────────┘    └────────┬────────┘    └────────┬────────┘    │
+│           │ HTTP A2A            │ HTTP A2A            │ HTTP A2A      │
+│           │                     │                     │               │
+│  ┌────────▼────────┐    ┌───────▼─────────┐    ┌──────▼──────────┐    │
+│  │ :3104           │    │ :3105           │    │ :3106           │    │
+│  │ nexus_healer    │◄──►│ nexus_researcher│◄──►│ nexus_publisher │    │
+│  │ bridge.ts       │    │ bridge.ts       │    │ bridge.ts       │    │
+│  └─────────────────┘    └─────────────────┘    └─────────────────┘    │
+│                                                                        │
+│           │                     │                     │               │
+│           └─────────────────────┼─────────────────────┘               │
+│                                 │                                      │
+│                                 ▼                                      │
+│           ┌──────────────────────────────────────┐                   │
+│           │  SERVICES PARTAGÉS (single)           │                   │
+│           │  • :3099  Overmind MCP Server         │                   │
+│           │  • :8642  Hermes Gateway API          │                   │
+│           │  • :5432  PostgreSQL (MessageLog)     │                   │
+│           └──────────────────────────────────────┘                   │
+└────────────────────────────────────────────────────────────────────────┘
+```
+
+### Pattern de Communication
+
+Quand `nexus_master` veut demander à `nexus_trader` d'exécuter un trade :
+
+```typescript
+// Dans bridges/nexus_master/src/clients/MasterToTrader.ts
+import { BridgeClient } from '@nexus/bridge-common';
+
+export class MasterToTrader {
+  private client = new BridgeClient('http://127.0.0.1:3102');
+
+  async requestTrade(symbol: string, action: 'buy' | 'sell', size: number) {
+    return this.client.call('agent.run', {
+      agentName: 'nexus_trader',
+      runner: 'hermes',
+      prompt: `Exécute trade: ${action} ${size} ${symbol}`,
+      externalKey: 'master_to_trader',
+    });
+  }
+}
+```
+
+**Flow** :
+1. `nexus_master` (port 3101) reçoit une requête externe
+2. Il appelle `MasterToTrader.requestTrade()` 
+3. `BridgeClient` fait `POST http://127.0.0.1:3102/rpc`
+4. Le bridge `nexus_trader` (port 3102) reçoit, exécute via MCP
+5. Réponse remontée : `nexus_trader` → `nexus_master` → client externe
+
+---
+
+## Arborescence des Bridges
+
+```
+C:\Users\Deamon\Nexus\
+│
+├── bridges/                            ← 6 WRAPPERS ISOLÉS (un par agent)
+│   │
+│   ├── nexus_master/                   ← Bridge #1 (:3101)
+│   │   ├── package.json                ← name: @nexus/bridge-master, dep: overmind-mcp
+│   │   ├── tsconfig.json
+│   │   ├── .env                        ← AGENT_NAME, BRIDGE_PORT=3101, peers URLs
+│   │   ├── README.md
+│   │   ├── src/
+│   │   │   ├── bridge.ts               ← Entry point — lance OverBridgeServer
+│   │   │   ├── config.ts               ← Lit .env + export config typée
+│   │   │   ├── logger.ts               ← Pino logger dédié
+│   │   │   ├── startup.ts              ← init MessageLog + SessionStore + connect MCP
+│   │   │   └── clients/
+│   │   │       ├── MasterToTrader.ts   ← POST :3102/rpc
+│   │   │       ├── MasterToRisk.ts     ← POST :3103/rpc
+│   │   │       ├── MasterToResearcher.ts ← POST :3105/rpc
+│   │   │       └── MasterToPublisher.ts  ← POST :3106/rpc
+│   │   ├── logs/
+│   │   │   └── bridge-master.log
+│   │   └── dist/                       ← Compilé
+│   │
+│   ├── nexus_trader/                   ← Bridge #2 (:3102)
+│   │   ├── package.json                ← name: @nexus/bridge-trader
+│   │   ├── .env                        ← BRIDGE_PORT=3102
+│   │   ├── src/
+│   │   │   ├── bridge.ts
+│   │   │   └── clients/
+│   │   │       ├── TraderToMaster.ts   ← POST :3101/rpc (comm au maître)
+│   │   │       ├── TraderToRisk.ts     ← POST :3103/rpc (check risk)
+│   │   │       └── TraderToPublisher.ts ← POST :3106/rpc (publier trade)
+│   │   └── ...
+│   │
+│   ├── nexus_risk_manager/             ← Bridge #3 (:3103)
+│   │   └── ...
+│   ├── nexus_healer/                   ← Bridge #4 (:3104)
+│   │   └── ...
+│   ├── nexus_researcher/               ← Bridge #5 (:3105)
+│   │   └── ...
+│   └── nexus_publisher/                ← Bridge #6 (:3106)
+│       └── ...
+│
+├── common/                             ← PARTAGÉ entre les 6 bridges
+│   ├── package.json                    ← name: @nexus/bridge-common
+│   ├── src/
+│   │   ├── BaseBridge.ts               ← Classe abstraite — factorise le boot
+│   │   ├── BridgeClient.ts             ← Client HTTP vers un autre bridge
+│   │   ├── types.ts                    ← Interfaces partagées
+│   │   └── logger.ts                   ← Pino config commune
+│   └── dist/
+│
+├── profiles/                           ← Profils Hermes (existants)
+│   ├── nexus_master/{config.yaml,SOUL.md,.env,memories/,sessions/}
+│   ├── nexus_trader/
+│   ├── nexus_risk_manager/
+│   ├── nexus_healer/
+│   ├── nexus_researcher/
+│   └── nexus_publisher/
+│
+├── shared-infra/                       ← SERVICES PARTAGÉS (déjà en prod)
+│   ├── mcp-server/                     ← Overmind MCP :3099
+│   ├── hermes-gateway/                 ← Gateway :8642
+│   └── postgres/                       ← :5432
+│
+├── scripts/                            ← SCRIPTS DE GESTION
+│   ├── start-all-bridges.ps1           ← Démarre les 6 en parallèle (Start-Job)
+│   ├── stop-all-bridges.ps1
+│   ├── status-bridges.ps1
+│   ├── seed-bridges.ps1                ← Crée dossiers + .env pour les 6
+│   └── test-a2a-network.ps1            ← Test E2E inter-bridges
+│
+└── logs/
+    ├── bridges/
+    │   ├── nexus_master.log
+    │   ├── nexus_trader.log
+    │   ├── nexus_risk_manager.log
+    │   ├── nexus_healer.log
+    │   ├── nexus_researcher.log
+    │   └── nexus_publisher.log
+    └── network/
+        └── a2a-traffic.log
+```
+
+---
+
+## Fichiers Clés
+
+### 1. `bridges/nexus_master/.env`
+
+```bash
+# === Bridge :3101 — nexus_master ===
+AGENT_NAME=nexus_master
+RUNNER=hermes
+BRIDGE_PORT=3101
+BRIDGE_HOST=127.0.0.1
+
+# Upstream (services partagés)
+MCP_URL=http://[::1]:3099/mcp
+HERMES_GATEWAY_URL=http://127.0.0.1:8642
+HERMES_GATEWAY_KEY=hIhOKpVn3AgfW_sQO8XShjMb8YRhaZngSSv6UsWY0dc
+POSTGRES_HOST=localhost
+POSTGRES_DB=overmind
+POSTGRES_USER=overmind
+POSTGRES_PASSWORD=***
+
+# Peers (autres bridges)
+PEER_TRADER_URL=http://127.0.0.1:3102
+PEER_RISK_URL=http://127.0.0.1:3103
+PEER_HEALER_URL=http://127.0.0.1:3104
+PEER_RESEARCHER_URL=http://127.0.0.1:3105
+PEER_PUBLISHER_URL=http://127.0.0.1:3106
+
+# Session config
+SESSION_TTL_MS=14400000
+MESSAGE_LOG_ENABLED=true
+DIRECTIVES_ENABLED=true
+```
+
+### 2. `common/src/BaseBridge.ts` (partagé)
+
+```typescript
+import {
+  OverBridgeServer,
+  OverBridgeService,
+  loadMessageLogConfigFromEnv,
+  createBridgeLogger,
+} from 'overmind-mcp/bridge';
+import { BridgeClient } from './BridgeClient.js';
+
+export interface BaseBridgeConfig {
+  agentName: string;
+  port: number;
+  host: string;
+  mcpUrl: string;
+  logger: any;
+}
+
+export abstract class BaseBridge {
+  protected service: OverBridgeService;
+  protected server: OverBridgeServer;
+
+  constructor(protected config: BaseBridgeConfig) {
+    this.service = new OverBridgeService({
+      mcpUrl: config.mcpUrl,
+      defaultTimeoutMs: 60_000,
+      agentTimeoutMs: 2_700_000,
+      maxRetries: 2,
+    }, config.logger);
+
+    this.server = new OverBridgeServer(this.service, {
+      port: config.port,
+      host: config.host,
+      postgres: loadMessageLogConfigFromEnv(),
+      enableMessageLog: true,
+      enableSessionStore: true,
+      enableDirectives: true,
+      sessionTtlMs: 4 * 60 * 60 * 1000,
+      rateLimitMax: 200,
+      sanitizeJson: true,
+    }, config.logger);
+  }
+
+  abstract getClients(): BridgeClient[];
+
+  async start(): Promise<void> {
+    await this.server.start();
+    this.config.logger.info(`🚀 Bridge ${this.config.agentName} ready on :${this.config.port}`);
+    for (const client of this.getClients()) {
+      await client.healthCheck();
+    }
+  }
+
+  async stop(): Promise<void> {
+    await this.server.stop();
+  }
+}
+```
+
+### 3. `bridges/nexus_master/src/bridge.ts`
+
+```typescript
+import { BaseBridge } from '@nexus/bridge-common';
+import { config } from './config.js';
+import { MasterToTrader } from './clients/MasterToTrader.js';
+import { MasterToRisk } from './clients/MasterToRisk.js';
+import { MasterToResearcher } from './clients/MasterToResearcher.js';
+import { MasterToPublisher } from './clients/MasterToPublisher.js';
+import { logger } from './logger.js';
+
+class MasterBridge extends BaseBridge {
+  protected getClients() {
+    return [
+      new MasterToTrader(config.peerTraderUrl, logger),
+      new MasterToRisk(config.peerRiskUrl, logger),
+      new MasterToResearcher(config.peerResearcherUrl, logger),
+      new MasterToPublisher(config.peerPublisherUrl, logger),
+    ];
+  }
+}
+
+const bridge = new MasterBridge();
+await bridge.start();
+```
+
+### 4. `bridges/nexus_master/src/clients/MasterToTrader.ts`
+
+```typescript
+import { BridgeClient } from '@nexus/bridge-common';
+
+export class MasterToTrader {
+  private client: BridgeClient;
+
+  constructor(traderUrl: string, logger: any) {
+    this.client = new BridgeClient(traderUrl, logger);
+  }
+
+  async requestTrade(symbol: string, action: 'buy' | 'sell', size: number): Promise<any> {
+    return this.client.call('agent.run', {
+      agentName: 'nexus_trader',
+      runner: 'hermes',
+      prompt: `Exécute trade: ${action} ${size} ${symbol}`,
+      externalKey: 'master_to_trader',
+    });
+  }
+
+  async askAnalysis(marketData: any): Promise<any> {
+    return this.client.call('agent.run', {
+      agentName: 'nexus_trader',
+      runner: 'hermes',
+      prompt: `Analyse ces données: ${JSON.stringify(marketData)}`,
+    });
+  }
+}
+```
+
+---
+
+## Scripts de Gestion
+
+### `scripts/start-all-bridges.ps1`
+
+```powershell
+# Démarre les 6 bridges en parallèle
+$bridges = @(
+    @{ Name="master"; Port=3101 },
+    @{ Name="trader"; Port=3102 },
+    @{ Name="risk_manager"; Port=3103 },
+    @{ Name="healer"; Port=3104 },
+    @{ Name="researcher"; Port=3105 },
+    @{ Name="publisher"; Port=3106 }
+)
+
+$jobs = @()
+foreach ($b in $bridges) {
+    $script = "cd '$PSScriptRoot\..\bridges\nexus_$($b.Name)' ; node dist/bridge.js"
+    $jobs += Start-Job -ScriptBlock { Invoke-Expression $args[0] } -ArgumentList $script
+    Write-Host "✅ Started nexus_$($b.Name) on :$($b.Port)"
+}
+
+Write-Host "`n6 bridges running. Press Ctrl+C to stop."
+Wait-Job -Job $jobs
+```
+
+### `scripts/seed-bridges.ps1`
+
+```powershell
+# Crée la structure de dossiers + .env pour les 6 bridges
+$template = @'
+AGENT_NAME={AGENT}
+RUNNER=hermes
+BRIDGE_PORT={PORT}
+BRIDGE_HOST=127.0.0.1
+MCP_URL=http://[::1]:3099/mcp
+HERMES_GATEWAY_URL=http://127.0.0.1:8642
+HERMES_GATEWAY_KEY=<KEY>
+PEER_TRADER_URL=http://127.0.0.1:3102
+PEER_RISK_URL=http://127.0.0.1:3103
+PEER_HEALER_URL=http://127.0.0.1:3104
+PEER_RESEARCHER_URL=http://127.0.0.1:3105
+PEER_PUBLISHER_URL=http://127.0.0.1:3106
+'@
+
+$config = @(
+    @{ Name="master"; Port=3101 },
+    @{ Name="trader"; Port=3102 },
+    @{ Name="risk_manager"; Port=3103 },
+    @{ Name="healer"; Port=3104 },
+    @{ Name="researcher"; Port=3105 },
+    @{ Name="publisher"; Port=3106 }
+)
+
+foreach ($c in $config) {
+    $dir = "$PSScriptRoot\..\bridges\nexus_$($c.Name)"
+    New-Item -ItemType Directory -Force -Path "$dir/src/clients"
+    New-Item -ItemType Directory -Force -Path "$dir/logs"
+    $env = $template -replace '{AGENT}', "nexus_$($c.Name)" -replace '{PORT}', $c.Port
+    Set-Content -Path "$dir/.env" -Value $env
+    Write-Host "✅ Seeded nexus_$($c.Name) on :$($c.Port)"
+}
+```
+
+---
+
+## Avantages de cette Architecture
+
+| Bénéfice | Explication |
+|----------|-------------|
+| **Isolation** | Chaque agent = son process, son port, ses logs. Crash d'un agent ≠ crash des autres. |
+| **Scaling indépendant** | Tu peux redémarrer `nexus_trader` sans toucher aux autres. |
+| **Monitoring clair** | `GET :3101/health`, `GET :3102/health`, etc. — chaque agent a sa métrique. |
+| **Déploiement granulaire** | Tu peux déployer un agent sur une autre machine en gardant le même code. |
+| **Logs séparés** | `logs/bridges/nexus_master.log` — debugging facile par agent. |
+| **Config par agent** | `.env` dédié — clés API différentes si besoin. |
+| **Pas de SPOF** | Si le bridge master crash, les 5 autres continuent à fonctionner entre eux. |
+
+## Flow Complet — Exemple Concret
+
+```
+Discord !sniper trade BTC
+  ↓
+discord_llm bridge (:3001)
+  ↓ HTTP POST /send
+  ↓
+nexus_master bridge (:3101)
+  ↓ BridgeClient.call('agent.run', agentName='nexus_trader')
+  ↓ HTTP POST http://localhost:3102/rpc
+  ↓
+nexus_trader bridge (:3102)
+  ↓ service.runAgent() → BridgeProxy → HTTP POST :3099/mcp
+  ↓
+Overmind MCP Server (:3099)
+  ↓ runHermesAgent() → HermesGatewayRunner
+  ↓ HTTP POST :8642/v1/chat/completions + X-Hermes-Profile: nexus_trader
+  ↓
+Hermes Gateway (:8642)
+  ↓ Route vers profil nexus_trader
+  ↓ Response: "BUY 0.1 BTC @ 67500"
+  ↑ retour en sens inverse ↑
+```
+
+---
+
+## Références
+
+- `overmind-mcp/bridge` exports : `OverBridgeServer`, `OverBridgeService`, `BridgeProxy`, `SessionStore`, `MessageLog`
+- Doc source : `Workflow/src/bridge/OverBridgeServer.ts` (1928 lignes)
+- Profils Hermes existants : `~/.hermes/profiles/nexus_*` (7 profils créés)
+- Gateway API : `Workflow/src/services/HermesGatewayRunner.ts` (HTTP+SSE, port 8642)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "overmind-mcp",
-  "version": "3.5.1",
+  "version": "3.6.0",
   "description": "Orchestrateur universel agents IA multi-modeles via MCP. Inclut le protocole 'Custom-Nickname' pour identifier vos agents avec des surnoms originaux (The Chaos Prophet, Shadow Sniper, etc.), l'isolation mémoire (Private Memory Context) et le support pour QwenCli et Nous Hermes. Installation automatique des dépendances Docker (PostgreSQL, pgvector) inclus.",
   "type": "module",
   "main": "dist/index.js",

package/docs/SOUL_pdf_bon_travail_v2.md

@@ -1,132 +0,0 @@
-# BT Secretary — Gestion bons de travail et feuilles de temps
-
-## RÈGLE #1 — RÉPONSE OBLIGATOIRE PAR SMS
-
-À CHAQUE message reçu, tu DOIS:
-1. Appeler `call_sms` du serveur `voipms-mcp` pour envoyer ta réponse
-2. Puis rédiger ta réponse dans le chat (même contenu)
-
-```json
-call_sms({ "dst": "<NUMERO_SANS_PLUS>", "message": "Réponse max 160 chars" })
-```
-- `did` est HARDCODÉ en interne — ne pas passer
-- Le `dst` SANS le +. Ex: +14187207735 → dst="4187207735"
-- Format SMS: texte brut, JAMAIS de markdown/gras/listes
-
----
-
-## IDENTITÉ
-
-Tu es **Mamadou**, secrétaire virtuelle de **Bon Air Construction**. 
-Femme, 27 ans, chrétienne. Tu gères les bons de travail et feuilles de temps par SMS.
-Réponds en **français**, texte brut, max 160 chars quand possible.
-
-### TON ADAPTÉ
-Récupère le profil: `SELECT ton, expressions, emoji_usage, surnom FROM bt_employes_profils WHERE employe_id = <id>;`
-- professionnel: clair, efficace, peu d'emojis
-- familier: chaleureux, expressions québécoises, emojis
-- neutre: factuel, aucun emoji
-
----
-
-## BASE DE DONNÉES
-
-PostgreSQL: localhost:5432, base: `financial_analyst`
-
-### TABLES PRINCIPALES
-
-**bt_employes**: id, prenom, nom, poste, tel, actif, email
-**bt_contrats**: id, no_projet(UNIQUE), client, adresse, ville, type(commerciale|residentielle|industrielle|genie_civil|regie|non_regie), statut(actif|termine|suspendu), notes
-**bt_semaines**: id, employe_id, contrat_id, no_projet, date_debut(lundi), heures_lun..heures_dim(numeric 4,1), description_ligne1..6, notes
-**bt_feuilles_temps**: id, employe_id, semaine_du(lundi), semaine_au(dimanche), mois, annee, statut(en_cours|soumis|valide), pdf_path, pdf_url
-**bt_feuilles_temps_lignes**: id, feuille_temps_id, jour(lundi|mardi|...), ligne_index(0-2), no_projet, heures_reg/comm/res/ind/ind_lourd/genie_civil, heure_debut/pause1_dbt/pause1_fin/diner_dbt/diner_fin/pause2_dbt/pause2_fin/fin, km
-**bt_bons**: id, contrat_id, employe_id, semaine_id, feuille_temps_id, no_projet, no_bon, date_bon, description, notes, pdf_path
-**bt_materiaux**: id, bon_id, semaine_id, description, qte, unite, prix_unitaire, prix_total
-
-### IDENTIFICATION EMPLOYÉ
-```sql
-SELECT id, prenom, nom, poste FROM bt_employes 
-WHERE RIGHT(REPLACE(REPLACE(tel, '-', ''), '+', ''), 10) = RIGHT(REPLACE('<NUMERO>', '+', ''), 10) AND actif = true;
-```
-Si non trouvé → SMS: "Bonjour! Je ne te reconnais pas. Demande à ton contremaître de t'inscrire."
-
----
-
-## RÈGLES MÉTIER
-
-### R1: SYNC BON/FEUILLE
-Chaque bon = une semaine sur un chantier (bt_semaines). Trigger DB synchronise vers bt_feuilles_temps_lignes.
-
-### R2: CHEF vs ÉQUIPIER
-- Chef d'équipe (Nicolas, id=1): rédige le bon, donne descriptions + matériaux
-- Équipier (Samuel, id=2): enregistre ses heures mais NE rédige PAS. Dis: "Heures notées! Nicolas s'occupe du bon."
-- Exception: équipier seul sur chantier = peut rédiger
-
-### R3: NOUVEAU CHANTIER
-Si no_projet inexistant: `INSERT INTO bt_contrats (no_projet, client, type, statut) VALUES ('<projet>', 'À confirmer', 'non_regie', 'actif');`
-Puis SMS: "Nouveau chantier créé. Nom du client et adresse?"
-
-### R4: ÉCRITURE IMMÉDIATE
-Quand un employé donne une info → exécute le SQL IMMÉDIATEMENT avant de répondre. Jamais dire "c'est noté" sans avoir fait l'INSERT/UPDATE.
-
-### R5: DATE LUNDI OBLIGATOIRE
-date_debut et semaine_du = TOUJOURS le lundi de la semaine. Jamais mardi/mercredi.
-
-### R6: HORAIRES CCQ PAR DÉFAUT
-- heure_debut: heure donnée ou '07:00'
-- pause1: 09:00-09:15, dîner: 12:00-12:30, pause2: 14:30-14:45
-- heure_fin: début + heures travaillées + 1h pauses
-- km: 0.0 par défaut
-
-### R7: ÉQUIPE NICOLAS & SAMUEL
-- Écritures DISTINCTES obligatoires (id=1 et id=2 séparés)
-- Samuel peut arriver en retard (ex: 08:30 au lieu de 07:00)
-- ATTENTION TRIGGER: UPDATE bt_semaines efface les horaires détaillés dans bt_feuilles_temps_lignes → DOIT ré-écrire les horaires après chaque UPDATE bt_semaines
-
-### R8: DOUBLONS MATÉRIAUX
-Vérifie existence avant INSERT. Si similaire → demande clarification.
-
----
-
-## PDF PIPELINE
-
-NE JAMAIS créer de PDF soi-même (pas de fitz/PyMuPDF).
-
-**Étape A**: Écrire données en DB (INSERT/UPDATE)
-**Étape B**: Appeler les scripts:
-```bash
-# Bon de travail
-/home/demon/bt-sms/pdfjob_clean/.venv/bin/python /home/demon/bt-sms/pdfjob_clean/Outils/fill_bon_travail.py --bon-id <ID>
-# Feuille de temps  
-/home/demon/bt-sms/pdfjob_clean/.venv/bin/python /home/demon/bt-sms/pdfjob_clean/Outils/fill_feuille_temps.py --feuille-id <ID>
-```
-**Étape C**: Upload `POST http://localhost:3149/upload-local {path: "/home/demon/bt-sms/bons_pdf/<file>"}` puis `send_mms({dst, message, media1: url})`
-
----
-
-## ACTIONS SPÉCIALES
-
-### OCR (photos de feuilles)
-`/home/demon/bt-sms/pdfjob_clean/.venv/bin/python3 /home/demon/bt-sms/pdfjob_clean/Outils/ocr_extract.py "<URL_MEDIA>"`
-
-### Rapport Vocal (MMS MP4)
-1. Rédiger résumé hebdo complet
-2. `/home/demon/bt-sms/pdfjob_clean/.venv/bin/python3 /home/demon/bt-sms/pdfjob_clean/Outils/generate_vocal_mms.py --text "<rapport>" --name "rapport_<semaine>"`
-3. `send_mms({dst, message, media1: url})`
-
-### Email
-- Expéditeur: agenticspeedworkflow@gmail.com
-- CC: nicolasracine44@gmail.com
-- Templates HTML: /home/demon/bt-sms/templates/email_rapport_hebdo.html
-- Toujours vérifier heures en DB avant d'envoyer (SQL SELECT)
-- 1 bon de travail par chantier (pas de doublon par employé)
-
----
-
-## RÈGLES ABSOLUES
-1. Identifier l'employé en PREMIER
-2. Ne jamais inventer de données
-3. Répondre par SMS/MMS via voipms-mcp
-4. Texte brut sans markdown dans les SMS
-5. Écrire en DB avant de confirmer
-6. Jamais afficher de code technique dans un SMS