monitor-website
RESUME.md est la source de vérité pour grahama.co/resume : gen_resume.py le parse en site/resume.json et copie les exports PDF, DOCX et Markdown dans site/public/, de sorte que la page, /resume.pdf, /resume.docx et /resume.md soient le contenu d'un seul commit. La vérification de somme de contrôle ci-dessous détecte un CV modifié dont la surface n'a jamais été régénérée.
Le site public (site/, servi sur https://grahama.co) reflète deux surfaces organisées dans README.md : les cartes de projets "Fun Stuff I'm Working On" et le tableau d'inventaire "At a Glance". Le README est la source de vérité ; le site lit site/content.json. Cette compétence les maintient honnêtes.
Commandes
# Lecture seule : dérive README vs content.json + santé du site en direct. Sortie 1 en cas de dérive.
./run.sh audit --json
# Lecture seule : échoue si BRAND.md / DESIGN.md sont des intentions vagues au lieu de contrats concrets de marque et de conception.
./run.sh design-contract-check --json
# Ignore les sondes https://grahama.co en direct (hors ligne / avant DNS)
./run.sh audit --no-live --json
# Régénère site/content.json depuis le README (statistiques toujours ; ajout/suppression de projets par slug — les blurbs existants sont conservés, les nouveaux projets prennent le blurb de la carte README). Ne commit NI ne push.
./run.sh apply
# Apply, puis prouve que le site se construit toujours et passe la porte qid.
./run.sh apply --build
# Régénère les surfaces générées (inventory.json, artifacts.json, generated/battle-lineage.json, research-map.json) depuis l'état actuel du dépôt, vérifie qid + build ; --commit/--push sont explicites.
# battle-lineage.json est dérivé du fixture en direct battle-004 et échoue fermé si ce fixture dérive de sa forme attendue.
# research-map.json regroupe les projets dans une taxonomie DÉCLARÉE de domaines de recherche (domaines maintenus dans gen_research_map.py, pas inférés par LLM) et compte les compétences correspondantes par domaine — la mini-carte de la page d'accueil est générée, pas rédigée.
# Le texte (questions/blurbs/sections) n'est JAMAIS touché par refresh.
./run.sh refresh
./run.sh refresh --commit --push
# Une seule cascade de collaboration locale pour les mises à jour de Graham + projet-agent. C'est la commande à exécuter après avoir modifié README.md ou RESUME.md.
#
# Sources :
# README.md -> site/content.json et surfaces générées du site public
# RESUME.md -> CV PDF, DOCX, Markdown, site/resume.json, llms.txt
# RESUME.md -> JSON éditable ops-linkedin.profile_entry.v1
#
# LinkedIn n'est qu'un transfert local : execution_claim reste NOT_EXECUTED et aucun accès navigateur ou plateforme LinkedIn n'a lieu ici.
./run.sh update --plan --linkedin-sync-plan --accept-linkedin-account-risk --json
./run.sh update --linkedin-sync-plan --accept-linkedin-account-risk --build
# Alias stables pour les humains qui considèrent ceci comme le moniteur grahama.co plutôt que le moniteur de site générique.
./run.sh grahamaco-update --plan
./run.sh monitor-grahamaco --plan
# Gèle des unités de revue de section/état de page et sert une URL de capacité en boucle locale.
./run.sh review-site prepare --url http://127.0.0.1:3003/ --out /tmp/grahama-review --json
./run.sh review-site verify --run-dir /tmp/grahama-review --json
./run.sh review-site serve --run-dir /tmp/grahama-review --bind 127.0.0.1 --port 43117 --json
./run.sh review-site stop --run-dir /tmp/grahama-review --json
# Vérifie le transport du reviewer G11 prioritaire à l'URL sans consommer de siège d'évaluateur.
./run.sh design-review preflight --provider webgpt --review-url '<capability-url>' --expected-fingerprint '<sha256>' --json
./run.sh design-review submit --provider webgpt --review-url '<capability-url>' --expected-fingerprint '<sha256>' --prompt prompt.md --out /tmp/rater --json
./run.sh design-review verify --rater-dir /tmp/rater --json
Un service nocturne désactivé par défaut est enregistré dans agents/website-maintainer/services.yaml (convention du dépôt : les entrées cron sont livrées désactivées ; activer seulement lorsque l'environnement du planificateur est prêt).
Contrat
- Lecture seule par défaut.
auditne mute jamais.applyécrit seulementsite/content.json; le commit, le push et le déploiement Pages restent des actions explicites de l'appelant (push sur main déclenche.github/workflows/site-deploy.yml). - La prose n'est pas écrasée. Les blurbs du site peuvent être plus riches que les légendes des cartes README ;
applypréserve les blurbs existants pour les projets qui restent, et seule l'appartenance (slugs/hrefs) et les statistiques sont synchronisées. - Preuve : le rapport JSON d'audit liste chaque élément de dérive ; après qu'une modification appliquée atterrit sur main, le reçu est une exécution verte de
site-deployplus une lecture curl des valeurs modifiées sur https://grahama.co. - Porte d'interaction : tout changement visible dans l'interface de
grahama.coougrahama.co/resumedoit exécuter la découverte et la relecture detest-interactionssur la surface modifiée avant commit/push. Le manifeste doit provenir du DOM en direct, et les contrôles de lancement de protocole tels que l'email de la navigation supérieure doivent être testés comme comportement en page ou explicitement classés comme liens externes à attente seule. Les contrôles de contact par email sur ces surfaces sont par défaut des boutons de copie dans le presse-papier ; les liens brutsmailto:sont une régression sauf si une tâche nécessite explicitement un comportement de lancement de client de messagerie natif. - Cascade à source unique :
updateest le chemin de collaboration projet-agent/Graham. Il exécute les exportateurs de CV existants avant le générateur de site, puis délègue le JSON de profil LinkedIn et la planification de synchronisation de profil optionnelle àops-linkedin. Il n'applique pas de modifications LinkedIn ni ne revendique de vérification de plateforme. - URLs de revue :
review-sitesépare l'intégrité déterministecandidate_fingerprintdu routage d'exécutionaccess_nonce. Il consomme le manifeste du corpus de sections, copie les rendus canoniques dans le bundle de revue, sert par défaut en boucle locale seulement, et ne traite jamais l'URL opaque comme une authentification pour du matériel privé, réglementé ou ITAR. - Reçus de reviewer :
design-reviewmaintient séparés les états de transport, d'inspection et d'évaluateur. Une pré-vérification peut prouver l'accès à l'URL/empreinte/unité/image canonique, mais ne consomme jamais un siège d'évaluateur. Un évaluateur n'est utilisable que lorsque la sortie brute du fournisseur est préservée et correspond à l'empreinte attendue, aux identifiants d'unité et au canari de revue.
Ce que vérifie l'audit
| Vérification | Source | Dérive quand |
|---|---|---|
| stats.skills / sanity / agents | Tableau "At a Glance" du README | les nombres diffèrent de content.json |
| appartenance aux projets | Noms <strong> des cartes README + hrefs | slug présent d'un seul côté, ou href modifié |
| site en direct | https://grahama.co, /sitemap.xml | non-200, ou page d'accueil manquant un data-qid de navigation |
| surface du CV | RESUME.md vs site/resume.json | commit stampé != HEAD, ou sourceSha256 enregistré != le vrai condensé de RESUME.md |
| CV en direct | /resume, /resume.pdf, /resume.docx, /resume.md | non-200, ou le fichier servi n'est pas la page/PDF/DOCX/Markdown attendu |
Intention de marque/conception — curiosité plutôt que catégorie
Avant de proposer ou d'appliquer des modifications de conception ou de positionnement de grahama.co, lisez :
site/BRAND.mdsite/DESIGN.mdskills/monitor-website/local/docs/BRAND.mdskills/monitor-website/local/docs/DESIGN.md
Exécutez ensuite skills/monitor-website/run.sh design-contract-check --json. Un DESIGN.md superficiel ou basé sur l'ambiance est un contrat échoué, pas une première version acceptable.
Le site est conçu pour être découvert, divertissant, honnête, sur mesure et indubitablement Graham. Ne le normalisez pas en une proposition de valeur de services IA, technologie de défense, Palantir-like, Straive-like, ou R&D générique. Traitez l'inhabituel comme intentionnel sauf si les preuves actuelles montrent un défaut factuel, d'accessibilité, de provenance ou de chemin cassé.
Maintenance de la conception — contrat visuel sur mesure (#1337)
La maintenance de la conception/identité visuelle de grahama.co se compose avec best-practices-bespoke-design et best-practices-font. Le monde visuel du site est verrouillé dans site/design-world.yml (source de vérité machine) + site/DESIGN_WORLD.md (lisible) : un postulat narratif, trois invariants non colorimétriques, la grammaire complète des rôles, et les résidus interdits de template IA structurel.
Une refonte visuelle ne peut jamais être signalée comme prête sur la base d'une simple confiance textuelle. Pour les travaux de réparation locaux normaux, exécutez le pipeline de rendu déterministe :
skills/monitor-website/run.sh design-render-check --json
Il valide le contrat source, le verrou source, les interdictions vérifiables de manière déterministe, le reçu de type, la géométrie de recadrage de section réactive, et le reçu de rendu artisanal. Ce pipeline peut retourner PASS, mais il ne prouve explicitement pas l'état PRÊT formel de conception sur mesure, la distinctivité aveugle, la résistance au changement de concurrent, l'achèvement de l'accessibilité, ou la performance sur le terrain.
Exécutez le pipeline de certification formelle uniquement lorsque la tâche actuelle est une porte finale de conception sur mesure :
skills/monitor-website/run.sh design-certify --json
design-certify inclut le reçu de l'évaluateur aveugle G11 et sort avec un code non nul sauf si chaque porte est PASS. Les sorties manquantes de l'évaluateur sont NOT_TESTED, pas un échec de rendu du site. design-world-check reste un alias de compatibilité pour le vérificateur formel ; préférez les deux commandes explicites ci-dessus.
Contrat de voix (#1298)
La voix humaine à la première personne de grahama.co est verrouillée dans site/VOICE.md (contrat) + site/voice-anchors.yml (lignes de signature). Les tâches automatisées peuvent valider, synchroniser les métadonnées factuelles et publier les notes approuvées, mais ne peuvent pas réécrire la prose du site sauf si un fichier source rédigé par un humain a changé. Lecture seule, déterministe :
skills/monitor-website/run.sh copy-audit --json
Il signale les nous/notre/nos à la première personne, les superlatifs de startup IA, les espaces réservés/lorem, et toute ligne de signature qui a disparu du texte. Les étiquettes de preuve restent dérivées de métadonnées structurées — la prose ne peut pas les renforcer.