notabene doctor | État en lecture seule au format JSON : config/store/port + dossiers de doc détectés — --json |
notabene init | Écrit notabene.config.mjs + crée le store (sans effet s’il existe déjà) ; --detect auto-détecte les dossiers de doc. Écrit aussi le point d’entrée agent : <store>/protocol.md + un bloc borné dans AGENTS.md — désactivables via --no-protocol / --no-agents-md. Idempotent : relancez-le pour rafraîchir les deux |
notabene dev | Démarre le serveur de revue sur les docs de ce repo (rechargement à chaud) ; --detach le lance en démon d’arrière-plan. Avec la dépendance de dev optionnelle pagefind, sa recherche devient plein texte aussi |
notabene status | Le serveur détaché tourne-t-il ? (pid, port, URL) — --json |
notabene stop | Arrête le serveur détaché |
notabene build | Construit le site (Node standalone ; docs prérendues, pas d’API d’écriture dans l’artefact) |
notabene build --public | Site statique en lecture seule pour hébergement public — voir le guide. [--site URL] [--base /sub] [--out DIR]. Avec la dépendance de dev optionnelle pagefind, l’artefact gagne une recherche plein texte statique |
notabene preview | Sert le site construit |
notabene lint | Valide les liens inter-docs contre les routes émises par le dernier build (suggestions « did you mean » ; --json). Après build --public, attrape aussi les liens de pages publiques vers du contenu privé. Exit 1 = liens cassés, 2 = pas encore de build |
notabene pdf | Exporte un PDF via Chromium headless (sommaire de signets + numéros de page) ; --scope doc|space:K|folder:K/P|page:K/I, --locale, --out, --chrome. Nécessite la peer dep optionnelle puppeteer (ou puppeteer-core + --chrome) |
notabene migrate | Convertit le store vers la disposition un-fichier-par-commentaire (estampille schemaVersion 3) |
notabene comments ls | Liste les commentaires — --open --json --page <p> (pour agents/scripts) |
notabene comments done | Marque des commentaires traités : done <id…> [--note <texte>] [--journal <entryId>]. Le statut vient de review (auto → resolved, approve → addressed) — --status force, --force agit sur un commentaire en attente (hold). Écriture atomique ; tous les autres champs préservés |
notabene comments reopen | Renvoie des commentaires à open : reopen <id…> [--reply <texte>] [--author <nom>] — la raison devient une réponse du thread que l’agent lira à la passe suivante (le pendant CLI du rejet sur /review) |
notabene comments verify | Audite le store : statuts, liens commentaire↔journal dans les deux sens, disposition des fichiers, doublons, pages disparues. --json ; exit 1 si erreurs, 2 sans store. À lancer après une passe d’agent, ou en CI |
notabene journal add | Ajoute une entrée de journal JSON lue depuis stdin (écriture atomique ; --json renvoie { id } pour chaîner côté agent) |
notabene protocol | Imprime le protocole agent sur stdout — --path affiche son chemin, --write rafraîchit <store>/protocol.md |
notabene