agentleFS
SimonKreis-RichardSimonKreis-Richard/oracle-fusion-agentic-toolkit/.claude/skills/smoke-check/SKILL.md

smoke-check

Skill0 starsChanged 51 days agoMITView on GitHub

Vérifier de bout en bout qu'une modification n'a pas cassé le plugin. Exécute réellement les scripts et le serveur MCP, contrôle le contrat entre le gabarit de brief et l'agrégateur, et revérifie les invariants dont l'absence de donnée client dans l'arbre versionné. À lancer après toute modification de logique, de gabarit de sortie ou de skill, car le projet n'a aucune suite de tests et tsc ne prouve que la compilation.

  • Reads credentials
  • Deletes or force-pushes

11 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Smoke-check du plugin

Pourquoi : il n'y a ni tests, ni linter. npm run build prouve que ça compile, pas que ça marche. Cette procédure est le seul contrôle de bout en bout. Elle ne touche jamais Jira en écriture et n'a besoin d'un jeton qu'à l'étape 6, qui est optionnelle.

Toutes les commandes se lancent depuis la racine du dépôt.

1. Build d'abord, obligatoire

npm run build

Doit sortir en code 0. Construit dist/ et mcp/dist/. Les étapes suivantes exécutent dist/, pas scripts/ : sans rebuild, tu testes l'ancien code. C'est l'erreur la plus fréquente ici.

2. L'agrégateur tourne et compte juste

npm run actions

Attendu, une ligne de la forme :

Wrote DO-NOW.md, MESSAGES.md and INDEX.md from 7 brief(s): 13 step(s), 7 message(s), ARCHIVE.md from 3 finished ticket(s)

Le dossier d'engagement vit hors du dépôt. Récupérer son chemin une fois, et l'utiliser pour tous les contrôles qui suivent :

E=$(node -e "import('./dist/engagement.js').then(m=>console.log(m.resolveEngagementDir(process.cwd())))")

Contrôles :

  • le nombre de briefs égale ls "$E"/output/tickets/*.md | wc -l ;
  • les fichiers de "$E"/output/ viennent d'être réécrits ;
  • "$E"/output/ACTIONS.md n'existe pas (le script supprime ce vestige) ;
  • aucun ticket de "$E"/worklist.txt n'a disparu de "$E"/output/INDEX.md ;
  • chaque brief de "$E"/output/closed/ a sa ligne dans "$E"/output/ARCHIVE.md, et aucun d'eux n'apparaît dans DO-NOW.md : un ticket archivé qui revient dans la liste des gestes veut dire qu'il est resté aussi dans output/tickets/.

Si le dossier d'engagement est absent, cette étape ne prouve rien : le dépôt est sans mandat. Le dire dans le compte rendu plutôt que de la déclarer réussie.

3. Le contrat brief / agrégateur tient toujours

C'est le point de rupture silencieux du dépôt : skills/hcm-debugging/output-format.md décrit le format, scripts/build_actions.ts le parse, et rien ne relie mécaniquement les deux.

grep -A 20 "REQUIRED_FIELDS" scripts/build_actions.ts
grep -n "^my_move\|^severity\|^status_target\|^root_cause" skills/hcm-debugging/output-format.md

Puis vérifier que l'échec est bruyant : retirer temporairement une ligne de frontmatter d'un brief, relancer npm run actions, et confirmer que le script nomme le fichier et le champ manquant. Remettre la ligne.

Vérifier aussi qu'un ticket my_move: send porteur d'étapes les affiche toujours dans DO-NOW.md, sous « Still yours afterwards ». Cette combinaison a déjà perdu onze étapes en silence.

4. Les invariants

# Jira en lecture seule : aucun verbe d'ecriture
grep -nE "method:\s*[\"']?(POST|PUT|PATCH|DELETE)" scripts/jira_ingest.ts

# Aucun tiret cadratin dans le produit ni dans les sorties generees.
# Ne PAS elargir a .claude/ : ce fichier contient le motif recherche.
grep -rn "—" skills/ "$E"/output/ 2>/dev/null

# Aucun identifiant en dur
grep -rnE "api_token\s*=\s*[\"'][A-Za-z0-9]" scripts/ mcp/src/

Les trois doivent ne rien retourner. La première est l'invariant le plus important du dépôt.

5. Aucune donnée client dans l'arbre versionné

Le contrôle qui transforme la confidentialité en test plutôt qu'en vigilance.

Le dossier d'engagement étant hors du dépôt, la recherche porte sur tout le dépôt, sans exception à retenir. Construire le motif à partir du mandat courant :

grep -rinE "<nom du client>|<PREFIXE>-[0-9]|<noms de personnes>" \
  --exclude-dir=node_modules --exclude-dir=engagement --exclude-dir=dist \
  --exclude-dir=.claude --exclude-dir=.git .

--exclude-dir=engagement reste : une installation sans ENGAGEMENT_DIR retombe sur ce dossier à la racine du dépôt.

Contrôler aussi qu'aucun dossier de mandat n'a été recréé dans le dépôt. Quand ENGAGEMENT_DIR est renseigné, engagement/ ne doit pas exister ici :

ls engagement 2>/dev/null && echo "DEFAUT: donnee client revenue dans le depot"

Les noms à mettre dans le motif sont dans le CONTEXT.md du mandat : le client, les personnes, le préfixe de projet Jira, les comptes de test, les rôles personnalisés.

Toute occurrence est un défaut à corriger avant de continuer. Le dépôt ne doit rien savoir du mandat. Si un exemple a besoin d'une clé de ticket, utiliser PROJ-1234.

Vérifier aussi la structure du plugin :

claude plugin validate .

6. Le serveur MCP répond

C'est le seul chemin vers du texte Oracle citable mot pour mot, donc son démarrage compte. Le serveur parle JSON-RPC sur stdout et logue sur stderr, d'où le 2>/dev/null. Toujours le trio initialize, notifications/initialized, puis l'appel.

printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"1"}}}' \
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
| node mcp/dist/index.js 2>/dev/null | grep -o '"name":"[a-z_]*"'

Attendu : exactement une ligne, "name":"fetch_oracle_page". Depuis l'élagage de la 4.0.0 le serveur n'expose plus rien d'autre. Un outil de plus est une régression, pas une amélioration.

Invariant à revérifier dès qu'on a touché mcp/src/index.ts : aucune écriture sur stdout.

grep -n "console\.log" mcp/src/index.ts

Doit ne rien retourner. Un seul console.log corrompt le protocole pour tous les clients.

Chemin réseau, seulement si on a touché au cache ou à jinaGet. Passe par Jina Reader, un tiers : prévoir timeout 120, jamais moins, sinon on tue la requête en plein vol et on conclut à tort à un échec.

Le cache est en mémoire seule depuis la 4.0.0, donc chaque démarrage part d'un état vide : il n'y a plus rien à purger avant le test.

printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"s","version":"0"}}}' \
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"fetch_oracle_page","arguments":{"url":"https://docs.oracle.com/en/cloud/saas/human-resources/faigh/index.html"}}}' \
| timeout 120 node mcp/dist/index.js 2>&1 >/dev/null | grep "fetch_oracle_page"

Attendu : un cache MISS puis successfully fetched ... (N chars). Un timeout ici est presque toujours un proxy d'entreprise ou r.jina.ai indisponible, pas le code.

7. L'ingestion répond, avec jeton, optionnel

Sans argument, l'aide doit s'afficher :

node dist/jira_ingest.js

Avec un .env valide, ingérer un ticket connu dans un dossier jetable :

node dist/jira_ingest.js <UNE-CLE-REELLE> --out .smoke-tickets --force
rm -rf .smoke-tickets

Attendu : ticket.md, raw.json, un dossier images/ non vide, les commentaires en ordre chronologique strict, et raw.json sans URL self ni bloc d'avatar.

Si aucun jeton n'est disponible, s'arrêter après l'aide et le dire. Ne pas conclure que l'ingestion fonctionne.

7 bis. Les garde-fous de l'accès instance, hors ligne

Aucune fenêtre ni session nécessaire : chaque refus doit tomber avant toute connexion.

FUSION_BASE_URL=https://fa-abcd-prod-saasfaprod1.fa.ocs.oraclecloud.com node dist/fusion.js status
FUSION_BASE_URL=https://fa-abcd-saasfaprod1.fa.ocs.oraclecloud.com node dist/fusion.js status
export FUSION_BASE_URL=https://fa-abcd-dev1-saasfaprod1.fa.ocs.oraclecloud.com
node dist/fusion.js status
node dist/fusion.js rest https://example.com/hcmRestApi/x
node dist/fusion.js rest /fscmUI/faces/FuseWelcome
node dist/fusion.js click "Save and Close"
node dist/fusion.js fill "Password" x

Attendu : les deux premières refusent (production, puis hôte non reconnu) ; la troisième répond closed ou signed in, preuve qu'un pod DEV au suffixe saasfaprod1 passe ; les quatre dernières refusent avec un message qui nomme la règle. Un seul de ces refus qui manque est un défaut bloquant.

grep -nE "method:\s*[\"']?(POST|PUT|PATCH|DELETE)" scripts/fusion.ts

Ne doit rien retourner : rest est en GET seulement.

7 ter. Le moteur de plans de test, contre le faux Oracle

Aucun pod, aucune session, aucune donnée client : un faux Oracle synthétique (smoke/, repris de clockwork) sur http://dev1.localhost:4173, dans une fenêtre invisible, avec un dossier d'engagement temporaire. dev1 suffit à la garde production, qui n'est pas affaiblie. Obligatoire après toute modification de scripts/fusion/, surtout locate.ts, select.ts et runner.ts.

Démarrer le serveur en arrière-plan : node smoke/server.mjs. Puis, dans un même shell :

export MSYS_NO_PATHCONV=1 ENGAGEMENT_DIR="$(cygpath -w "$TMP")\\fusion-smoke" \
  FUSION_BASE_URL=http://dev1.localhost:4173 FUSION_CDP_PORT=9334 FUSION_HEADLESS=true FUSION_RESOLVE_TIMEOUT_MS=3000
B=smoke/blueprints
node dist/fusion.js open
node dist/fusion.js run $B/smoke_create_course.yaml; echo "exit $?"          # attendu 1 : jamais approuve
node dist/fusion.js approve $B/smoke_create_course.yaml
node dist/fusion.js run $B/smoke_create_course.yaml; echo "exit $?"          # attendu 0, 13 etapes
R0=$(node dist/fusion.js runs | grep smoke_create_course | tail -1 | cut -d' ' -f1)
node dist/fusion.js cleanup "$R0"; echo "exit $?"                             # attendu 0, "was deleted"
node dist/fusion.js cleanup "$R0"; echo "exit $?"                             # attendu 1, deja nettoye
node dist/fusion.js approve $B/smoke_wrong_label.yaml
node dist/fusion.js run $B/smoke_wrong_label.yaml; echo "exit $?"            # attendu 3, bloque etape 3
R=$(node dist/fusion.js runs | grep smoke_wrong_label | tail -1 | cut -d' ' -f1)
node dist/fusion.js repair "$R" "Title"; echo "exit $?"                       # attendu 0, fichier reecrit
git checkout -- $B/smoke_wrong_label.yaml                                     # REMETTRE le fichier
node dist/fusion.js approve $B/smoke_oracle_error.yaml
node dist/fusion.js run $B/smoke_oracle_error.yaml; echo "exit $?"           # attendu 4, texte Oracle verbatim
node dist/fusion.js goto / && node dist/fusion.js click Navigator && node dist/fusion.js click "My Client Groups" \
  && node dist/fusion.js click Learning && node dist/fusion.js click Courses
node dist/fusion.js click Details; echo "exit $?"                              # attendu 3, deux candidats nommes
node dist/fusion.js click Details --within "Course B"; echo "exit $?"         # attendu 0
node dist/fusion.js goto /ui/v1/signin; echo "exit $?"                        # attendu 5, session expiree
node dist/fusion.js close

Contrôles :

  • l'étape 11 du run vert est trouvée dans frame "notesframe" (report <run-id>) : la recherche dans les iframes marche ;
  • après repair, le blueprint porte le nouveau libellé et ses commentaires, plus une ligne # repaired <date> ; et run l'accepte encore : une réparation de libellé ne casse pas l'approbation ;
  • modifier une valeur du profil smoke/data/smoke.yaml puis relancer un plan approuvé doit être refusé (exit 1). Remettre la valeur.
  • la reprise, dans le dossier temporaire et jamais dans smoke/ : copier smoke_create_course.yaml dans "$ENGAGEMENT_DIR"/fusion/blueprints/tmpresume.yaml (et smoke/data/smoke.yaml dans fusion/data/), y remplacer la valeur {{category}} par Nonexistent category, approuver, lancer : attendu exit 6 à l'étape 8, avec « never offered ». Une valeur absente de la liste qui passe pour réussie est le défaut que ce contrôle garde. resume <run> sans changement : exit 6 de nouveau, à l'étape 8. Remettre {{category}}, approuver : resume <run> sans --from doit être refusé (le plan a changé), puis resume <run> --from 8 doit finir en exit 0 sans rejouer les étapes 1 à 7.
  • la chaîne et le tirage unique (D26), dans le dossier temporaire : copier le profil avec title: "Smoke {{random_string(5)}}", et le blueprint vert deux fois sous chain_part_1 et chain_part_2 (ligne scenario: changée). Approuver les deux, lancer la partie 1, puis run chain_part_2 --after <run 1>. Attendu : les deux journaux tapent le même « Smoke xxxxx », chacun suivi de son propre run id. Un titre qui change entre les parties est le défaut gardé.
  • les marqueurs PICK et FILL : dans une copie temporaire, mettre une valeur du profil à "FILL, test" : plan doit dire NOT READY et approve refuser (exit 1). Mettre un libellé à PICK the row : plan liste l'étape, et le run s'y arrête en exit 3 sans rien cliquer. repair <run> "Create" finit en exit 0, et le blueprint garde PICK the row (non réécrit).
  • l'approbation par intention (D27), sur la chaîne ci-dessus : suite dit « to approve » ; approve chain_part_1 chain_part_2 --intent ; suite propose run chain_part_1, puis, une fois la partie 1 finie, run chain_part_2 --after <run 1>. Modifier une valeur de la partie 2 : run refusé (exit 1) et suite dit « changed ». rebuild chain_part_2 --reason "<dix caractères ou plus>" : une ligne dans fusion/suite-log.md, puis le run finit en exit 0, son state.json porte rebuilt, son dossier une copie blueprint.yaml, et evidence affiche le bandeau de reconstruction. Refus attendus (exit 1) : un chemin vers Setup and Maintenance dans une reconstruction, une raison trop courte, rebuild d'un plan approuvé sans --intent, et le run d'un scénario approuvé par intention dont le profil porte encore un FILL.
  • le document client : evidence <run vert> <run wrong_label> écrit un HTML et un PDF dans fusion/evidence/ ; « 1 of 2 tests passed », l'étape 3 du second en FAILED avec son libellé prévu (et non « Clear »), les étapes 4 et 5 en « Not run ». evidence sans run id : exit 1.

Arrêter le serveur, puis supprimer le dossier temporaire : rm -rf "$TMP/fusion-smoke". Sous PowerShell, MSYS_NO_PATHCONV est inutile : c'est Git Bash qui réécrit / en chemin Windows.

8. Le câblage, si on a touché aux skills ou déplacé le dossier

npm run wire
ls .claude/skills/hcm-debugging

Le ls doit lister des fichiers. S'il renvoie juste le nom du dossier, les liens sont morts.

Puis ouvrir une nouvelle conversation Claude Code : les skills sont lues une seule fois au démarrage, donc la conversation courante ne verra jamais la modification.

Compte rendu

Rapporter chaque étape avec son résultat réel, y compris ce qui a été sauté et pourquoi. Ne jamais rapporter une étape non exécutée comme réussie.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.