@nowline/cli 0.8.6 → 0.9.0

package/dist/mcp-install/server-command.d.ts

@@ -0,0 +1,26 @@
+import type { HostEnv } from './host.js';
+export type ServerKind = 'self' | 'npx';
+/** The stdio launch line every harness config stores. */
+export interface ServerEntry {
+    command: string;
+    args: string[];
+}
+export interface ResolvedServer {
+    entry: ServerEntry;
+    /** Notices for stderr (dropped under `-q`). */
+    warnings: string[];
+}
+/**
+ * Decides what `--mcp-install` registers.
+ *
+ * `self` points at the installed `nowline`. The path is absolute because GUI
+ * harnesses (Claude Desktop, Cursor, VS Code launched from the Dock) don't
+ * inherit the shell PATH, and it is the stable PATH entry rather than the
+ * realpath, so a Homebrew symlink keeps working across `brew upgrade` instead
+ * of pinning `Cellar/nowline/<version>/`.
+ *
+ * `npx` registers `npx -y @nowline/mcp`, which tracks npm independently of
+ * the CLI but needs Node visible to the harness.
+ */
+export declare function resolveServer(kind: ServerKind, root: string | undefined, host: HostEnv): ResolvedServer;
+//# sourceMappingURL=server-command.d.ts.map

package/dist/mcp-install/server-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-command.d.ts","sourceRoot":"","sources":["../../src/mcp-install/server-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAExC,yDAAyD;AACzD,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CACzB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,OAAO,GACd,cAAc,CAyChB"}

package/dist/mcp-install/server-command.js

@@ -0,0 +1,52 @@
+import * as path from 'node:path';
+/**
+ * Decides what `--mcp-install` registers.
+ *
+ * `self` points at the installed `nowline`. The path is absolute because GUI
+ * harnesses (Claude Desktop, Cursor, VS Code launched from the Dock) don't
+ * inherit the shell PATH, and it is the stable PATH entry rather than the
+ * realpath, so a Homebrew symlink keeps working across `brew upgrade` instead
+ * of pinning `Cellar/nowline/<version>/`.
+ *
+ * `npx` registers `npx -y @nowline/mcp`, which tracks npm independently of
+ * the CLI but needs Node visible to the harness.
+ */
+export function resolveServer(kind, root, host) {
+    const rootArgs = root !== undefined ? ['--root', path.resolve(host.cwd, root)] : [];
+    if (kind === 'npx') {
+        // Windows GUI apps can't spawn `npx.cmd` without a shell.
+        if (host.platform === 'win32') {
+            return {
+                entry: { command: 'cmd', args: ['/c', 'npx', '-y', '@nowline/mcp', ...rootArgs] },
+                warnings: [],
+            };
+        }
+        return {
+            entry: { command: 'npx', args: ['-y', '@nowline/mcp', ...rootArgs] },
+            warnings: [],
+        };
+    }
+    if (host.isCompiledBinary) {
+        const binary = host.realpath(host.execPath);
+        const onPath = host
+            .findAllOnPath('nowline')
+            .find((candidate) => host.realpath(candidate) === binary);
+        const command = onPath ?? host.execPath;
+        const warnings = [];
+        if (onPath === undefined && /[\\/]Cellar[\\/]/.test(command)) {
+            warnings.push(`warning: registered ${command}, which changes on \`brew upgrade\`; put Homebrew's bin on PATH and re-run --mcp-install.`);
+        }
+        return { entry: { command, args: ['--mcp', ...rootArgs] }, warnings };
+    }
+    // Running under Node (npm install or a checkout): the `nowline` shim is a
+    // `#!/usr/bin/env node` script a GUI harness may not be able to run, so
+    // register the absolute Node and the script it runs.
+    const script = host.realpath(host.argv1 ?? '');
+    return {
+        entry: { command: host.execPath, args: [script, '--mcp', ...rootArgs] },
+        warnings: [
+            `warning: registered ${host.execPath}; re-run --mcp-install if you remove or switch this Node version.`,
+        ],
+    };
+}
+//# sourceMappingURL=server-command.js.map

package/dist/mcp-install/server-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-command.js","sourceRoot":"","sources":["../../src/mcp-install/server-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAiBlC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CACzB,IAAgB,EAChB,IAAwB,EACxB,IAAa;IAEb,MAAM,QAAQ,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACjB,0DAA0D;QAC1D,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC5B,OAAO;gBACH,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC,EAAE;gBACjF,QAAQ,EAAE,EAAE;aACf,CAAC;QACN,CAAC;QACD,OAAO;YACH,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC,EAAE;YACpE,QAAQ,EAAE,EAAE;SACf,CAAC;IACN,CAAC;IAED,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAI;aACd,aAAa,CAAC,SAAS,CAAC;aACxB,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC;QACxC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,MAAM,KAAK,SAAS,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3D,QAAQ,CAAC,IAAI,CACT,uBAAuB,OAAO,2FAA2F,CAC5H,CAAC;QACN,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC;IAC1E,CAAC;IAED,0EAA0E;IAC1E,wEAAwE;IACxE,qDAAqD;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC/C,OAAO;QACH,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,EAAE;QACvE,QAAQ,EAAE;YACN,uBAAuB,IAAI,CAAC,QAAQ,mEAAmE;SAC1G;KACJ,CAAC;AACN,CAAC"}

package/man/fr/nowline.1

@@ -1,6 +1,11 @@
 .\" Traduction française neutre. Les divergences régionales (fr-CA, fr-FR)
 .\" prennent la forme de surcouches dans packages/cli/man/<locale>/nowline.1
 .\" lorsqu'elles existent. Voir specs/localization.md.
+.\"
+.\" Empreinte de la page anglaise relue pour cette traduction. Après avoir
+.\" reporté une modification de la page anglaise, remplacez-la par la ligne
+.\" qu'affiche packages/cli/test/man/translation-parity.test.ts.
+.\" translated-from: nowline.1 sha256:3fc6d77fadcf4ba2add7f127da8cff257262ed010f253a1b0a0e7801b56f0d4f
 .Dd $Mdocdate$
 .Dt NOWLINE 1
 .Os
@@ -13,6 +18,7 @@
 .Op Fl o Ar chemin
 .Op Fl t Ar thème
 .Op Fl -now Ar date
+.Op Fl -timezone Ar fuseau
 .Op Ar options
 .Ar entrée
 .Nm
@@ -24,6 +30,17 @@
 .Fl -init
 .Op Ar nom
 .Nm
+.Fl -mcp
+.Op Fl -root Ar rép
+.Nm
+.Fl -mcp-install
+.Op Ar client
+.Op Ar options
+.Nm
+.Fl -mcp-uninstall
+.Op Ar client
+.Op Ar options
+.Nm
 .Fl -dry-run
 .Op Ar options
 .Ar entrée
@@ -137,6 +154,9 @@ rendu réussi.
 L'option
 .Fl o Ar chemin
 écrit également le résultat sur le disque à chaque reconstruction.
+Il accepte les mêmes options de rendu qu'un rendu simple (thème,
+largeur, liens, mode strict, etc.) et affiche ce qu'afficherait un
+rendu simple du fichier avec les mêmes options.
 .It Fl -init Op Ar nom
 Crée un fichier
 .Pa .nowline
@@ -149,6 +169,37 @@ est ajouté automatiquement s'il manque.
 Le nom par défaut est
 .Sy roadmap .
 Les fichiers existants sont écrasés sans confirmation.
+.It Fl -mcp
+Lance un serveur Model Context Protocol (MCP) sur l'entrée et la sortie
+standard, qui expose à un agent les outils de validation, de rendu,
+d'export et de fichiers.
+Avec
+.Fl -port Ar n ,
+il sert plutôt du Streamable HTTP local.
+C'est le même serveur que
+.Ql npx @nowline/mcp .
+.It Fl -mcp-install Op Ar client
+Enregistre le serveur MCP auprès d'un agent\ :
+.Sy claude-code , claude-desktop , cursor , vscode , codex , gemini ,
+.Sy antigravity , muse , opencode , copilot , windsurf , zed , amp , goose ,
+ou
+.Sy all .
+Sans
+.Ar client ,
+l'installe dans chaque agent trouvé sur cette machine.
+Les configurations JSON sont modifiées sur place, en conservant les
+commentaires et les autres entrées\ ; Claude Code (portée utilisateur) et
+Codex passent par leur propre commande
+.Ql mcp add \ ;
+Goose reçoit un extrait à coller.
+Relancer la commande est sans risque.
+Avec
+.Fl n ,
+affiche la modification sans rien écrire ni exécuter.
+Voir
+.Sx OPTIONS MCP .
+.It Fl -mcp-uninstall Op Ar client
+Retire le serveur des mêmes configurations.
 .It Fl n , -dry-run
 Exécute la totalité du pipeline (analyse + validation + mise en page +
 format) sans écrire de fichier.
@@ -189,16 +240,63 @@ comme
 .Sh OPTIONS DE PRODUCTION
 .Bl -tag -width Fl
 .It Fl t , -theme Ar nom
-.Sy light | dark .
+.Sy light | dark | grayscale ;
+.Sy greyscale
+est accepté comme alias.
+Par défaut\ :
+.Pa .nowlinerc
+.Sy theme ,
+sinon
+.Sy light .
 .It Fl -now Ar date
 Ancrage
 .Sq Maintenant
-pour la ligne de temps présent et le calcul des dates, au format
-.Pa AAAA-MM-JJ .
-Par défaut\ : aujourd'hui (date civile UTC du système).
+pour la ligne de temps présent et le calcul des dates.
+Accepte une date nue
+.Pa AAAA-MM-JJ
+(flottante\ ; indépendante du fuseau) ou un instant ISO\~8601 complet tel que
+.Pa 2026-06-04T23:00:00Z
+ou
+.Pa 2026-06-05T06:00:00+07:00
+(un Z ou un décalage \(+-HH:MM intégré l'emporte sur
+.Fl -timezone ) .
+Une date nue ou un instant sans décalage est flottant\ : la partie date
+écrite est utilisée et
+.Fl -timezone
+est ignoré.
+La partie date doit désigner un jour réel du calendrier\ :
+.Pa 2026-02-30
+est une erreur de saisie, et non le 2\~mars.
+Par défaut\ : la date civile du jour dans le fuseau de l'hôte (ou celui de
+.Fl -timezone
+s'il est indiqué).
 Indiquez
 .Fl -now Sq -
 pour supprimer entièrement la ligne de temps présent.
+.It Fl -timezone Ar fuseau
+Fuseau horaire utilisé pour la valeur par défaut «\ aujourd'hui\ »
+fondée sur l'horloge\ ; consulté uniquement lorsque
+.Fl -now
+est omis.
+Formes acceptées\ :
+.Bl -tag -width "America/Los_Angeles" -compact
+.It Sy local
+Fuseau de l'hôte ou du lecteur (par défaut si l'option est absente).
+.It Sy UTC
+UTC.
+.It Sy Z , +00:00
+Raccourci pour un décalage nul (équivaut à
+.Sy UTC ) .
+.It Sy \(+-HH , \(+-HH:MM , \(+-HHMM
+Décalage fixe (ignore l'heure d'été\ ; limitation documentée).
+.It Sy America/Los_Angeles
+Tout nom de fuseau IANA valide.
+.El
+Les abréviations ambiguës telles que
+.Sy PST
+et
+.Sy IST
+sont rejetées avec un message d'erreur explicite.
 .It Fl -locale Ar bcp47
 Étiquette de langue BCP-47 pour les messages CLI de l'opérateur
 (diagnostics de validation sur la sortie d'erreur,
@@ -250,10 +348,35 @@ Facteur d'échelle pour le rendu raster (PNG uniquement\ ; 1 par défaut).
 .It Fl -strict
 Promeut les avertissements (assets, sanitiseur) en erreurs.
 .It Fl w , -width Ar px
-Largeur du canevas en pixels (1280 par défaut).
+Largeur maximale du canevas en pixels.
+Par défaut\ :
+.Pa .nowlinerc
+.Sy width ,
+sinon aucune, et le canevas s'ajuste au contenu.
+Une feuille de route plus large resserre sa frise pour tenir, jusqu'à un pixel
+par jour\ ; les légendes qui débordent de leurs barres peuvent encore élargir le
+canevas.
+.It Fl -non-working Ar mode
+Façon dont un calendrier ouvré affiche ses jours non travaillés sur le
+graphique\ :
+.Sy hide
+les replie (par défaut),
+.Sy show
+les dessine en bandes grisées.
+Prévaut sur la clé
+.Sy default roadmap non-working:
+du fichier\ ; sans option, la clé s'applique, puis
+.Sy hide .
+Toute autre valeur se termine avec le code 2.
+L'ordonnancement est identique dans les deux vues\ : les sorties Mermaid,
+MS Project et XLSX ne changent pas.
 .It Fl -asset-root Ar dossier
 Dossier à partir duquel les ressources logo / image peuvent être
-chargées (par défaut\ : dossier du fichier d'entrée).
+chargées (par défaut\ : la clé
+.Sy assetRoot
+de
+.Pa .nowlinerc ,
+puis le dossier du fichier d'entrée).
 .El
 .Sh OPTIONS SPÉCIFIQUES AU FORMAT
 .Bl -tag -width Fl
@@ -292,12 +415,13 @@ Saute le sondage de polices de la plateforme et force la paire DejaVu
 intégrée.
 La sortie est stable octet par octet entre machines.
 .It Fl -start Ar date
-MS Project\ : date d'ancrage
-.Pq Pa AAAA-MM-JJ
-pour les feuilles de route uniquement relatives.
-Par défaut\ :
-.Fl -now ,
-puis repli déterministe.
+MS Project\ : date de début du projet
+.Pq Pa AAAA-MM-JJ .
+Par défaut\ : le
+.Cm start:
+de la feuille de route, sinon
+.Fl -now
+(aujourd'hui).
 .El
 .Sh OPTIONS DE SERVEUR
 .Bl -tag -width Fl
@@ -312,6 +436,36 @@ pour exposer sur le réseau local).
 .It Fl -open
 Ouvre le navigateur au démarrage.
 .El
+.Sh OPTIONS MCP
+.Bl -tag -width Fl
+.It Fl -root Ar rép
+Répertoire que les outils de fichiers MCP peuvent lire et écrire (par
+défaut\ : le répertoire courant).
+Avec
+.Fl -mcp-install ,
+il est inscrit dans la commande enregistrée sous forme de chemin absolu.
+.It Fl -scope Ar portée
+Où
+.Fl -mcp-install
+écrit\ :
+.Sy user
+(par défaut\ ; la configuration propre à l'utilisateur de l'agent) ou
+.Sy project
+(le fichier de configuration du répertoire courant, à versionner).
+.It Fl -server Ar type
+Ce que
+.Fl -mcp-install
+enregistre\ :
+.Sy self
+(par défaut\ ; ce binaire
+.Nm
+avec
+.Fl -mcp ,
+si bien qu'une installation Homebrew n'exige pas Node.js) ou
+.Sy npx
+.Pq Ql npx -y @nowline/mcp ,
+qui suit npm indépendamment de la CLI.
+.El
 .Sh OPTIONS DE JOURNALISATION
 Les indicateurs de journalisation sont mutuellement exclusifs.
 .Bl -tag -width Fl
@@ -321,7 +475,10 @@ Affiche des diagnostics supplémentaires sur la sortie d'erreur standard
 décisions de repli).
 .It Fl q , -quiet
 Supprime les messages non liés aux erreurs sur la sortie d'erreur
-standard.
+standard : avertissements, notices et avertissements du rapport de
+diagnostics d'une exécution en échec.
+Les erreurs et les diagnostics JSON restent affichés, et le code de
+sortie ne change pas.
 .El
 .Sh OPTIONS STANDARD
 .Bl -tag -width Fl
@@ -370,25 +527,84 @@ pour la matrice de résolution.
 Fichier de configuration JSON ou YAML facultatif.
 Recherché en remontant depuis le dossier du fichier d'entrée\ ; le plus
 proche l'emporte.
-Les indicateurs CLI surclassent les valeurs de configuration.
-Clés reconnues\ :
-.Sy theme , defaultFormat , width , pdfPageSize , pdfOrientation ,
-.Sy pdfMargin , fontSans , fontMono , headlessFonts , locale .
+Chaque clé reconnue sert de valeur par défaut à un indicateur\ :
+l'indicateur l'emporte s'il est fourni, puis la clé, puis la valeur
+par défaut intégrée.
+.Sy theme
+.Pq Fl t ,
+.Sy defaultFormat
+.Pq Fl f ,
+.Sy width
+.Pq Fl w ,
+.Sy pdfPageSize
+.Pq Fl -page-size ,
+.Sy pdfOrientation
+.Pq Fl -orientation ,
+.Sy pdfMargin
+.Pq Fl -margin ,
+.Sy fontSans
+.Pq Fl -font-sans ,
+.Sy fontMono
+.Pq Fl -font-mono ,
+.Sy headlessFonts
+.Pq Fl -headless ,
+.Sy useSystemFonts
+.Pq Fl -use-system-fonts ,
+.Sy assetRoot
+.Pq Fl -asset-root ,
+.Sy locale
+.Pq Fl -locale .
+.Sy defaultFormat
+ne s'applique que si l'extension de
+.Fl o
+n'est pas reconnue\ ;
+.Sy locale
+passe après les variables d'environnement de langue.
+Une clé
+.Sy assetRoot
+relative est résolue par rapport au dossier du
+.Pa .nowlinerc
+qui la contient, alors qu'une valeur relative de
+.Fl -asset-root
+est résolue par rapport au dossier de travail.
+.Fl -serve
+lit
+.Sy theme ,
+.Sy width ,
+.Sy assetRoot
+et
+.Sy locale .
+Une valeur invalide est une erreur d'utilisation qui nomme la clé.
 Les clés inconnues sont ignorées.
+Il n'y a pas de clé de journalisation\ :
+.Sy quiet
+est ignorée, et
+.Fl q
+et
+.Fl v
+ne s'appliquent qu'en ligne de commande.
 .El
 .Sh CODES DE SORTIE
 .Bl -tag -width Ds
 .It 0
 Succès.
 .It 1
-Erreur de validation (analyse en échec, référence invalide, etc.).
+Erreur de validation (analyse en échec, référence invalide, etc.), y
+compris les règles de vagues vérifiées à travers les fichiers inclus,
+comme
+.Sy NL.E0202 .
+Elles sont signalées comme les diagnostics du validateur, au fichier et
+à la ligne qu'elles désignent.
 .It 2
 Erreur d'utilisation (entrée manquante, indicateurs incorrects ou
 mutuellement exclusifs, format non pris en charge, fichier introuvable,
 sortie binaire vers un terminal, entrée illisible).
 .It 3
 Erreur de sortie (impossible d'écrire à la destination, échec du
-pipeline d'export).
+pipeline d'export), y compris une inclusion impossible à résoudre
+(inclusion illisible, circulaire ou en double,
+.Cm start:
+différent).
 .El
 .Sh EXEMPLES
 Produire le SVG par défaut dans le dossier courant\ :
@@ -425,6 +641,14 @@ nowline --init
 nowline --init mon-projet
 .Ed
 .Pp
+Servir les outils MCP, ou les enregistrer auprès de chaque agent
+trouvé\ :
+.Bd -literal -offset indent
+nowline --mcp
+nowline --mcp-install
+nowline --mcp-install cursor --scope project -n
+.Ed
+.Pp
 PDF avec géométrie de page explicite, stable octet pour octet entre
 machines\ :
 .Bd -literal -offset indent
@@ -445,6 +669,9 @@ qu'elle reste française quel que soit l'opérateur qui exécute
 nowline v1 locale:fr-CA
 .Ed
 .Sh VOIR AUSSI
+.Xr nowline 5
+.Pq Sy man 5 nowline
+.Pp
 .Lk https://github.com/lolay/nowline "Code source, suivi des incidents et référence DSL complète"
 .Pp
 Le dossier