v0.4.1 : Phase 1 complete (17/17) - dashboard TUI (#33), favoris/notes/tags (#39), profils d'environnement (#40), completions dynamiques + man pages (#41), packaging officiel + CI (#42), self-update Gitea, state v3, 212 tests

2026-08-17 10:50:13 -04:00
parent 4f4cd034b2
commit 56732d672b
93 changed files with 9412 additions and 1270 deletions
@@ -285,3 +285,99 @@ avec purge.
    $ am uninstall cowsay --purge --yes
    removed 'cowsay' from .../cowsay.yaml (backup: .../cowsay.yaml.bak)
    uninstalled Cowsay (files removed, config purged)
+
+## Favoris, notes et tags personnels (v0.4.1)
+
+    $ am favorite claude-code
+    ⭐ claude-code added to favorites
+
+    $ am note claude-code use sonnet for this repo
+    note saved for 'claude-code'
+
+    $ am tag claude-code python frontend
+    tagged 'claude-code' with python, frontend
+
+    $ am tags
+    ┌───┬────────────┬───────┬─────────────┐
+    │ # │ TAG        │ COUNT │ AGENTS      │
+    ├───┼────────────┼───────┼─────────────┤
+    │ 0 │ #frontend  │ 1     │ claude-code │
+    │ 1 │ #python    │ 1     │ claude-code │
+    └───┴────────────┴───────┴─────────────┘
+
+L'étoile apparaît dans am list, am status et am info ; les tags sont
+filtrables avec am search --tag, et tout survit au redémarrage (état v3) :
+
+    $ am info claude-code | tail
+      tags  anthropic · assistant · source-available · mainstream
+      personal
+      ● favorite ★
+      ● tags #frontend #python
+      ● note use sonnet for this repo
+
+    $ am search --tag python
+    ┌───┬──────────────────────────┬──────────────┬─────────────┬─────────────┐
+    │ # │ NAME                     │ CATEGORY     │ INSTALLABLE │ DESCRIPTION │
+    ├───┼──────────────────────────┼──────────────┼─────────────┼─────────────┤
+    │ 0 │ ★ Claude Code            │ coding-agent │ yes         │ Agent termi… │
+    └───┴──────────────────────────┴──────────────┴─────────────┴─────────────┘
+
+## Profils d'environnement (v0.4.1)
+
+Des profils nommés dans la configuration (env + args + agent par défaut)
+s'appliquent au lancement :
+
+    profiles:
+      dev:
+        agent: claude-code
+        env: {DEBUG: "1", LOG_LEVEL: debug}
+        args: [--model, sonnet]
+      prod:
+        env: {LOG_LEVEL: info}
+
+    $ am profile list
+    PROFILE  AGENT        ENV                    ARGS
+    -------  -----------  ---------------------  ----------------
+    dev      claude-code  DEBUG=1 LOG_LEVEL=…    --model sonnet
+    prod     —            LOG_LEVEL=info         —
+
+    $ am start claude-code --profile dev
+    # lance claude --model sonnet avec DEBUG=1 et LOG_LEVEL=debug
+
+    $ am start --profile dev        # agent par défaut du profil
+    $ am start --profile staging    # -> error: unknown profile 'staging' — …
+    #    available profiles: dev, prod
+
+## Dashboard TUI (v0.4.1)
+
+am dashboard ouvre un tableau de bord temps réel (ratatui/crossterm, aucune
+dépendance runtime) : vue d'ensemble (statuts, PID, uptime, ★), activité
+(journal d'événements), stats par agent, sessions et projets. Tab / ← / →
+changent d'onglet, j/k défilent, q quitte ; rafraîchissement chaque seconde.
+Sur une sortie non interactive (pipe, script), un instantané texte est
+affiché à la place :
+
+    $ am dashboard | head
+    agent-manager dashboard — 2 installed · 1 running · 12 sessions
+
+    overview
+      ★ claude-code       running   2.1.233    pid 4242  (up 3h12m)
+        aider             installed 0.76.0     —
+        codex             external  —          —
+
+    $ am dashboard --json   # l'instantané complet en JSON pour les scripts
+
+## Pages de manuel et complétions dynamiques (v0.4.1)
+
+    $ am man dashboard
+    .TH am-dashboard 1  "dashboard "
+    .SH NAME
+    dashboard - Live TUI dashboard: overview, activity, stats, sessions, projects
+    ...
+
+    $ am man --output man/          # am.1 + une page par commande (44 pages)
+    man pages written to man/ (am.1 + 44 pages)
+
+    $ am completion bash --installed   # Tab complète dynamiquement les
+                                        # agents installés, alias et groupes
+                                        # (interroge 'am _agents --installed')