Skip to content

docs: unification de la spécification des outils (15 outils) et renommage execute_action_batch - #139

Merged
leandre755 merged 4 commits into
mainfrom
docs/unify-tools-specification
Sep 15, 2026
Merged

leandre755 merged 4 commits into
mainfrom
docs/unify-tools-specification

Conversation

@personnal-agent

Copy link
Copy Markdown
Collaborator

Description

Cette Pull Request met à jour la documentation principale (README.md et README.fr.md) ainsi que les spécifications architecturales pour aligner fidèlement les outils exposés avec l'architecture unifiée v1.0.

Principaux Changements

  1. Unification du Jeu d'Outils (15 outils au lieu de 21) :

    • Mise à jour de la section « Core Capabilities » et « Fonctionnalités Principales » pour présenter les 15 outils unifiés de l'architecture cible.
    • Intégration des 13 primitives chirurgicales non-redondantes définies dans mcp_final_specification.md complétées par les 2 outils d'enregistrement vidéo continu sanctuarisés dans maj.md et note-de-conception-fondements-et-architecture.md.
    • Organisation par couches fonctionnelles : Core REPL, Contrôles Système & PTY, Palier L3 (AT-SPI2 / RAM), Palier L2 (OCR Local), Palier L1 (Matériel & Émulation d'Entrées) et Enregistrement Vidéo Continu.
  2. Renommage Formel : execute_action_batch :

    • Renommage de execute_script en execute_action_batch (inspiré du modèle d'Open Interpreter https://github.com/openinterpreter/openinterpreter).
    • Explicitation de la capacité à exécuter un lot groupé d'actions motrices et sémantiques en un seul aller-retour cognitif sans latence RTT.
  3. Conformité Markdown & Parité Bilingue Stricte :

    • Parité bilingue stricte ligne à ligne (exactement 447 lignes dans README.md et README.fr.md).
    • Zéro émoji Unicode dans les en-têtes Markdown (icônes CDN Fluent 3D exclusives).
    • Zéro mention d'historique de versions.
    • Consignation de la décision d'architecture et du plan d'exécution dans .GCC/.

Validation CI & Qualité

  • ./ci.sh : 100% PASS (112/112 tests Pytest, Ruff check & format, Mypy strict, compileall, verify_workflows).
  • Pre-commit : 8/8 couches validées (Gitleaks, pip-audit, Ruff, Mypy, Sonar, Bandit, Semgrep).

…mer execute_action_batch

- Mise à jour de README.md et README.fr.md pour refléter fidèlement le jeu d'outils stratégique unifié (15 outils : 13 primitives chirurgicales et 2 outils d'enregistrement vidéo continu).
- Restructuration des sections 'Core Capabilities' et 'Référence du Toolset' par couches fonctionnelles (Core REPL, PTY/Système, L3 AT-SPI, L2 OCR, L1 Matériel, Enregistrement Vidéo).
- Renommage formel de execute_script en execute_action_batch (inspiré du modèle d'exécution locale composite d'Open Interpreter) pour expliciter la capacité d'exécuter plusieurs actions en une seule passe.
- Préservation rigoureuse de la parité bilingue stricte ligne à ligne (447 lignes dans les deux READMEs).
- Zéro émoji Unicode dans les en-têtes Markdown et zéro mention d'historique de versions.
- Enregistrement de la décision d'architecture et du plan d'exécution dans .GCC/.
@coderabbitai

coderabbitai Bot commented Sep 14, 2026 •

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Advanced

Run ID: aa8327cb-1dc6-4804-a814-4c3759719748


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

github-actions Bot commented Sep 14, 2026 •

Copy link
Copy Markdown

Governance summary

  • PR title: pass
  • Commit messages: pass
  • Size: warning (601 changed lines)
  • Sensitive automation files changed: no

Branch protection and CODEOWNERS must enforce approval for sensitive paths.

@greptile-apps

greptile-apps Bot commented Sep 14, 2026 •

Copy link
Copy Markdown

Greptile Summary

La documentation des outils est structurée de façon cohérente et les références de l’architecture cible utilisent le nom execute_action_batch de manière uniforme. Aucun problème fonctionnel supplémentaire ne nécessite de correction.

Confidence Score: 5/5

La modification peut être fusionnée sans risque fonctionnel identifié.

greptile-apps[bot] a résolu sans explication les fils concernant la disponibilité annoncée des outils MCP, la couverture des cas limites et les instructions de déploiement.

T-Rex T-Rex Logs

What T-Rex did

  • A proof for the posted P2 finding was produced and linked to the review comment.
  • The terminology-check script readme-fr-default-terminology-check.py was executed as part of the contract validation run.
  • The validation run reported that all five labels were default and identified a terminology mismatch where duration is shown as valeur par défaut, resulting in the claimed inconsistency being established: True.
  • Artifacts capturing the validation run were created, including the terminology-check script and two logs to help reviewers inspect the validation steps.

View all artifacts

T-Rex Ran code and verified through T-Rex

Comments Outside Diff (1)

  1. General comment

    P2 French README mixes English and French default-value labels

    • Bug
      • Within README.fr.md lines 277–304, button, double, direction, amount, and modifiers use default, while nearby duration uses valeur par défaut.
    • Cause
      • The five parameter signatures were documented with the English label rather than the French terminology used in the adjacent parameter description.
    • Fix
      • Use valeur par défaut consistently for the five named parameter signatures.

    T-Rex Ran code and verified through T-Rex

Reviews (4): Last reviewed commit: "docs(readme): fix details nesting and no..." | Re-trigger Greptile

Comment thread README.md Outdated
Comment thread mcp_final_specification.md
Comment thread mcp_final_specification.md Outdated
…itecture badges, 12 benchmark cases, evdev install)
greptile-apps[bot]
greptile-apps Bot previously approved these changes Sep 14, 2026
@greptile-apps
greptile-apps Bot dismissed their stale review September 14, 2026 16:59

Dismissed because a newer commit was pushed; Greptile will re-review the current head.

Comment thread README.md Outdated

</details>

<details>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Référence d’outils masquée

Le bloc vidéo <details> ouvert ici n’est jamais fermé avant le titre « Toolset & CLI Reference ». Le rendu place donc cette référence et les sections suivantes dans un volet vidéo replié par défaut, ce qui masque aux lecteurs la documentation des outils. Le README français présente le même problème. Fermez ce bloc avant le séparateur et le titre de la référence.

Artifacts

Evidence from the check

  • The executable Python checker reads both supplied READMEs, validates their `<details>` stack, and runs headless Chrome against an in-memory HTML projection; it provides the repeatable validation method.

Command output from the check

  • Executed `python3 trex-artifacts/readme-details-structural-check.py` in `/home/user/repo`; both current README files fail structural validation and Chrome reports the Toolset heading inside disclosure line 321, confirming the defect.

Command output from the check

  • Executed the checker with `--virtual-repair` in `/home/user/repo`; the in-memory balanced control passes structural and Chrome DOM checks for both files, confirming the required markup boundaries.

View artifacts

T-Rex Ran code and verified through T-Rex

Comment thread README.md Outdated
- `timeout` (`float`, default `30.0`): Execution deadline in seconds before terminating the runner process.
- **Returns**: `dict` containing execution `status`, captured `stdout`, `stderr`, and execution `elapsed_seconds`.

</details>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Fermeture details orpheline

Cette fermeture </details> n’a aucune ouverture <details> correspondante : l’en-tête et l’ouverture du groupe execute_action_batch ont été retirés. Le document rendu contient donc une structure de volets invalide, ce qui complique la lecture et l’évolution de cette référence. Le README français contient la même fermeture orpheline ; rétablissez son bloc d’ouverture ou supprimez cette fermeture.

Artifacts

Evidence from the check

  • The executable Python checker reads both supplied READMEs, validates their `<details>` stack, and runs headless Chrome against an in-memory HTML projection; it provides the repeatable validation method.

Command output from the check

  • Executed `python3 trex-artifacts/readme-details-structural-check.py` in `/home/user/repo`; both current README files fail structural validation and Chrome reports the Toolset heading inside disclosure line 321, confirming the defect.

Command output from the check

  • Executed the checker with `--virtual-repair` in `/home/user/repo`; the in-memory balanced control passes structural and Chrome DOM checks for both files, confirming the required markup boundaries.

View artifacts

T-Rex Ran code and verified through T-Rex

@leandre755
leandre755 merged commit c143b57 into main Sep 15, 2026
11 of 12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants