@nowline/cli 0.8.6 → 0.10.0

package/dist/mcp-install/json-config.js

@@ -0,0 +1,139 @@
+import { chmodSync, mkdirSync, readFileSync, realpathSync, renameSync, statSync, writeFileSync, } from 'node:fs';
+import * as path from 'node:path';
+import { applyEdits, modify, parse, printParseErrorCode, } from 'jsonc-parser';
+export class JsonConfigError extends Error {
+}
+/**
+ * Inserts or replaces the server entry in a JSON / JSONC document, editing
+ * the text rather than re-serializing it, so comments, key order, and the
+ * file's own indentation survive. `existing` undefined means the file is
+ * missing.
+ */
+export function upsertEntry(existing, target, entry) {
+    const isNew = existing === undefined || existing.trim() === '';
+    const text = isNew ? `${JSON.stringify(target.seed ?? {}, null, 2)}\n` : existing;
+    const doc = parseDocument(text, target.path);
+    const { keyPath, value } = target.place(entry, doc);
+    const current = valueAt(doc, keyPath);
+    if (!isNew && deepEqual(current, value))
+        return { change: 'unchanged', keyPath, value };
+    return {
+        change: isNew ? 'created' : current === undefined ? 'added' : 'updated',
+        text: applyEdits(text, insertionEdits(text, keyPath, value)),
+        keyPath,
+        value,
+    };
+}
+/** Removes the server entry, leaving every other key and comment in place. */
+export function removeEntry(existing, target, entry) {
+    if (existing === undefined || existing.trim() === '') {
+        return { change: 'absent', keyPath: [] };
+    }
+    const doc = parseDocument(existing, target.path);
+    const { keyPath } = target.place(entry, doc);
+    if (valueAt(doc, keyPath) === undefined)
+        return { change: 'absent', keyPath };
+    // Unformatted: a pure deletion, so neighbouring entries keep their layout.
+    const edits = modify(existing, keyPath, undefined, {});
+    return { change: 'removed', text: applyEdits(existing, edits), keyPath };
+}
+export function readConfigFile(filePath) {
+    try {
+        return readFileSync(filePath, 'utf-8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return undefined;
+        throw err;
+    }
+}
+/**
+ * Atomic write (temp file + rename) so a crash never leaves a harness with a
+ * half-written config. Writes through a symlink (dotfile managers) and keeps
+ * the existing file mode.
+ */
+export function writeConfigFile(filePath, text) {
+    let destination = filePath;
+    let mode;
+    try {
+        destination = realpathSync(filePath);
+        mode = statSync(destination).mode & 0o777;
+    }
+    catch {
+        mkdirSync(path.dirname(filePath), { recursive: true });
+    }
+    const temp = `${destination}.nowline-${process.pid}.tmp`;
+    writeFileSync(temp, text, 'utf-8');
+    if (mode !== undefined)
+        chmodSync(temp, mode);
+    renameSync(temp, destination);
+}
+/**
+ * jsonc-parser's formatter re-flows the whole line it edits, and appending a
+ * key to a non-empty object edits the previous sibling's line, so a user's
+ * compact `"other": { "command": "x" }` would come back expanded. For that
+ * case, take the unformatted edit and indent the new property ourselves.
+ * Every other case (replacing our own entry, creating a missing parent)
+ * only touches lines we own, so the library's formatting is fine.
+ */
+function insertionEdits(text, keyPath, value) {
+    const formatting = detectFormatting(text);
+    const raw = modify(text, keyPath, value, {});
+    const edit = raw[0];
+    if (raw.length !== 1 || edit.length !== 0 || !edit.content.startsWith(',')) {
+        return modify(text, keyPath, value, { formattingOptions: formatting });
+    }
+    const unit = formatting.insertSpaces ? ' '.repeat(formatting.tabSize ?? 2) : '\t';
+    const lineStart = text.lastIndexOf('\n', edit.offset - 1) + 1;
+    const lineIndent = /^[ \t]*/.exec(text.slice(lineStart))?.[0] ?? '';
+    const property = JSON.stringify(JSON.parse(`{${edit.content.slice(1)}}`), null, unit)
+        .split('\n')
+        .slice(1, -1)
+        .map((line) => lineIndent + line.slice(unit.length));
+    const eol = formatting.eol ?? '\n';
+    return [{ ...edit, content: `,${eol}${property.join(eol)}` }];
+}
+function parseDocument(text, filePath) {
+    const errors = [];
+    const doc = parse(text, errors, { allowTrailingComma: true, disallowComments: false });
+    if (errors.length > 0) {
+        const first = errors[0];
+        throw new JsonConfigError(`cannot parse ${filePath}: ${printParseErrorCode(first.error)} at offset ${first.offset}; fix or move the file and re-run.`);
+    }
+    if (!isRecord(doc)) {
+        throw new JsonConfigError(`cannot update ${filePath}: the top level is not a JSON object.`);
+    }
+    return doc;
+}
+function valueAt(doc, keyPath) {
+    let node = doc;
+    for (const key of keyPath) {
+        if (!isRecord(node))
+            return undefined;
+        node = node[key];
+    }
+    return node;
+}
+function detectFormatting(text) {
+    const eol = text.includes('\r\n') ? '\r\n' : '\n';
+    const indent = /^([ \t]+)\S/m.exec(text)?.[1];
+    if (indent?.startsWith('\t'))
+        return { insertSpaces: false, tabSize: 1, eol };
+    return { insertSpaces: true, tabSize: indent?.length ?? 2, eol };
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        return a.length === b.length && a.every((item, i) => deepEqual(item, b[i]));
+    }
+    if (isRecord(a) && isRecord(b)) {
+        const keys = Object.keys(a);
+        return (keys.length === Object.keys(b).length && keys.every((key) => deepEqual(a[key], b[key])));
+    }
+    return false;
+}
+//# sourceMappingURL=json-config.js.map

package/dist/mcp-install/json-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-config.js","sourceRoot":"","sources":["../../src/mcp-install/json-config.ts"],"names":[],"mappings":"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"}

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:032668f06f1c5fa404d9e94021ed15b045372a5d155f3eac56cec4daffaf6630
 .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,38 @@ 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.
+Sans cette option, le serveur utilise les racines que le client annonce
+via MCP (les chemins relatifs sont résolus par rapport à la première), ou
+le répertoire courant si le client n'en annonce aucune.
+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 +477,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 +529,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 +643,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 +671,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