STATUS — FG_Pulse — 2026-10-08

STATUS — FG_Pulse

_Article généré automatiquement depuis le STATUS.md de FG_Pulse — 2026-10-08. Les chemins locaux, les hôtes internes et les noms de variables ont été neutralisés._

FG_Pulse — STATUS

Version: 0.1.0 POC
GO POC: 2026-06-11 (FG)
Branche: main

Install autonome

.\scripts\install-all.ps1

Taches planifiees : FG_Pulse-API, FG_Pulse-Agent, FG_Pulse-MediaAgent, FG_Pulse-TelegramHourly (si Telegram configure).

Déployé

Non activé v1 (volontaire)

• Patterns / nudges (C10)
• Logseq, OSC, Ableton, Hero dual POST

Relay Hub (PULSE-01)

Relais EVT agrégé optionnel vers le hub VFVFGPT (POST /api/v1/events), opt-in strict : sans configuration, aucun appel réseau n'est effectué (zéro régression sur le service local).

• packages/api/src/hub-relay.js : buildPulseEvt({ focusRatio, totalDurationS, segments, day }) construit un EVT { schema:1, id, at, project:"FG_Pulse", type:"status", actor:"fg-pulse", status, stats, links } ; relayToHub(hubUrl, token, evt, { fetch }) POST vers ${hubUrl}/api/v1/events avec header x-api-token, remonte une erreur sur réponse 4xx/5xx, et renvoie { skipped:true } sans réseau si hubUrl/token absents.
• scripts/relay-hub.mjs : script Node appelable seul, récupère les stats 24h locales (/api/v1/acts/stats?window=24h) et relaie l'EVT si configuré.
• Câblage : scripts/telegram-hourly-report.ps1 appelle relay-hub.mjs après l'envoi du rapport Telegram, uniquement si [variable d'environnement] est défini.

Variables d'environnement (.env, gitignored)

FG nécessaire : ajouter FG_Pulse:<token>:event-producer dans VFVFGPT/.env (variable [variable d'environnement]=...) pour que le hub accepte les EVT FG_Pulse (isolation projet : body.project doit correspondre au projet du token). Tant que [variable d'environnement] n'est pas renseigné côté FG_Pulse, le relay reste no-op.

Ops

Accès LAN/Tailscale (13/06)

API bindée sur [hôte interne] (.env : PULSE_HOST=0.0.0.0, local non commité) — accessible depuis le tunnel Tailscale :

• Timeline UI : http://[hôte interne]:4330/ui/timeline.html
• API : http://[hôte interne]:4330/api/v1/...

Pare-feu : profil Private désactivé sur ce poste (Ethernet + Tailscale = Private) → pas de règle dédiée nécessaire. Si le profil Private est réactivé un jour, ajouter une règle entrante TCP 4330.

Pause collecte

Stop-ScheduledTask -TaskName FG_Pulse-Agent
Stop-ScheduledTask -TaskName FG_Pulse-MediaAgent

Purge données

Stop-ScheduledTask -TaskName FG_Pulse-Agent -ErrorAction SilentlyContinue
Remove-Item [chemin local] -Force

Désinstall complète

1. Unregister-ScheduledTask -TaskName FG_Pulse-Agent -Confirm:$false
2. Supprimer extension Chrome
3. Retirer hooks Cursor
4. Delete FG_Pulse/data/

Refactor 16/06 — vues + hiérarchie

• Phase 1B : sélecteur vue Blocs / Segments bruts (ui/timeline.js)
• Phase 2 : recurrence_key_coarse · GET /api/v1/acts/tree · UI arbre projet → outil → objet
• Phase 3 : table sessions · GET /api/v1/acts/sessions · vue Sessions Cursor
• Phase 4 : normalize-title · coalesce runtime · dedupe Chrome · project-map étendu
• Fixes : migration DB phase2 · clé coarse canonique · tests isolés
• VFJah : ui/pulse/ sync + proxy MSN v0.3.52 (16/06)

Refactor 11/06 soir

• act-mapper.js partagé (dédup actFromRow/rowFromAct ingest/query, −44 lignes)
• db.js testable : override PULSE_DATA_DIR (lu à l'appel, pas à l'import) + resetDb()
• Harnais node --test : 26 cas (privacy, enrich sur project-map réel, e2e SQLite temporaire)

Dashboard 13/06 — détail + classements

• ui/timeline.html éclaté en timeline.css + timeline.js (module ES) + pulse-utils.js (rule monolithe 400, tous <300 lignes)
• pulse-utils.js : fonctions pures (fmtDur, aggregateBy, topN, relativeTime, peakHour, longestAct…) couvertes par 13 tests (test/ui-utils.test.js)
• Clic sur une ligne du tableau ou un segment de la timeline → modale détail (description, objet, tags/liens, méta JSON, récurrence)
• Nouveaux classements façon WakaTime : Top outils, Classement par type d'action, Top objets/fichiers
• Nouveaux indicateurs : heure la plus active, session la plus longue

Prochaines étapes

• 1 journée complète de segments réels
• Ajustement project-map.yaml après 1 semaine (C9)
• Revue privacy FG sur échantillon acts.jsonl
• Tag v0.1.0
• FG : ajouter FG_Pulse:<token>:event-producer dans VFVFGPT/.env puis renseigner [variable d'environnement] côté FG_Pulse

Qualité de captation — 15/09/2026

• GET /api/v1/acts?window=6h honore désormais la fenêtre relative (m, h, d, bornée à 90 jours). Avant, le paramètre était ignoré et Chronowflow recevait les 500 dernières lignes, couvrant environ vingt heures.
• Mesure en lecture seule sur les données réelles : 500 → 98 actes pour la fenêtre 6 h (−80,4 %), sans supprimer ni migrer l'historique brut.
• Le collecteur Windows construit maintenant name avec le titre du segment qui se termine, au lieu du titre de la nouvelle fenêtre active.
• Validation : npm test 69/69 PASS ; API isolée :4331, requête 6 h 98 contre 2000 sur l'historique de contrôle.
• Suite : vérifier le service :4330 après redémarrage opérationnel, puis auditer le curseur historique Chronos. Aucun redémarrage de tâche planifiée effectué par ce lot.

EN COURS