@nowline/cli 0.2.0 → 0.2.2

package/dist/generated/version.d.ts

@@ -1,4 +1,4 @@
-export declare const CLI_VERSION = "0.2.0";
+export declare const CLI_VERSION = "0.2.2";
 export interface CliBuild {
     /** Short git SHA at build time, or empty when not in a git checkout. */
     readonly sha: string;

package/dist/generated/version.js

@@ -1,7 +1,7 @@
 // Auto-generated by scripts/bundle-templates.mjs. Do not edit by hand.
-export const CLI_VERSION = "0.2.0";
+export const CLI_VERSION = "0.2.2";
 export const CLI_BUILD = {
-    "sha": "c51e2a4",
+    "sha": "df3ebcc",
     "isRelease": true,
     "isDirty": false
 };

package/man/fr/nowline.1

@@ -6,7 +6,7 @@
 .Os
 .Sh NOM
 .Nm nowline
-.Nd produire, valider et servir des fichiers de feuille de route .nowline
+.Nd créer des feuilles de route à partir d'un fichier texte lisible .nowline
 .Sh SYNOPSIS
 .Nm
 .Op Fl f Ar format
@@ -33,46 +33,17 @@
 .Op Fl h | Fl -help
 .Sh DESCRIPTION
 .Nm
-analyse un fichier de feuille de route
+est une CLI qui traite des fichiers
 .Pa .nowline
-(ou sa forme JSON AST) et écrit le résultat produit dans un fichier ou
-sur la sortie standard.
-La production est le mode par défaut\ ; les autres modes sont
-sélectionnés par des indicateurs mutuellement exclusifs plutôt que par
-des sous-commandes
-.Pq sans verbe, comme mmdc, dot, d2, prettier et tsc .
+simples et lisibles qui définissent une feuille de route, et non un
+diagramme de Gantt.
+L'artefact principal est un SVG, mais elle génère aussi de nombreux
+autres artefacts dont PNG, PDF, HTML, Markdown+Mermaid, XLSX,
+MS Project XML.
 .Pp
-Le pipeline de production est
-.Sy analyse
-\(->
-.Sy validation
-\(->
-.Sy mise en page
-\(->
-.Sy exportateur spécifique au format .
-La sortie est déterministe octet pour octet pour une entrée,
-.Fl -theme
-et
-.Fl -now
-donnés.
-.Pp
-Un seul binaire
-.Nm
-fournit tous les formats d'export\ : SVG, PNG, PDF, HTML,
-Markdown+Mermaid, XLSX, MS Project XML, et l'aller-retour AST
-.Pq json , nowline .
-.Pp
-.Ar entrée
-est obligatoire pour le mode de production par défaut, pour
-.Fl -serve
-et pour
-.Fl -dry-run .
-Indiquez
-.Sq -
-pour lire l'entrée standard.
-Sans argument,
-.Nm
-affiche l'aide et termine avec le code 0.
+Cette page documente la CLI.
+Pour le format de fichier, voir
+.Xr nowline 5 .
 .Sh ENTRÉE
 Le format d'entrée est détecté à partir de l'extension du fichier\ :
 .Pa .nowline
@@ -84,6 +55,74 @@ L'entrée standard est traitée par défaut comme
 Utilisez
 .Fl -input-format
 pour les noms de fichiers inhabituels.
+.Sh LANGAGE
+Un fichier
+.Pa .nowline
+est une esquisse à indentation significative.
+L'indentation canonique est de deux espaces\ ; les tabulations sont
+acceptées mais ne doivent pas être mélangées avec des espaces dans un
+même fichier.
+Les chaînes sont entre guillemets doubles\ ; les propriétés sont des
+paires
+.Sy key:value .
+Les commentaires utilisent
+.Sq //
+ou
+.Sq /* */ .
+.Pp
+Mots-clés principaux\ :
+.Bl -tag -width "person, team" -compact
+.It Sy roadmap
+La déclaration de feuille de route de plus haut niveau\ ; une seule
+par fichier.
+.It Sy swimlane
+Une voie horizontale de travail (équipe, domaine, flux).
+.It Sy item
+Une unité de travail, indentée sous un
+.Sy swimlane .
+.It Sy parallel
+Un bloc dont les enfants s'exécutent en simultané.
+.It Sy group
+Un regroupement logique d'éléments, rendus ensemble.
+.It Sy anchor
+Une date nommée sur la chronologie.
+.It Sy milestone
+Un repère ponctuel qui dépend d'un travail.
+.It Sy person , team
+Vocabulaire d'organisation référencé par
+.Sy owner: .
+.It Sy label
+Étiquette réutilisable référencée par
+.Sy labels: .
+.El
+.Pp
+Chaque entité suit une forme universelle\ :
+.Bd -literal -offset indent
+keyword [id] ["title"] [key:value ...]
+.Ed
+.Pp
+Au moins un identifiant
+.Ar id
+ou un titre
+.Qq Ar title
+est requis \(em l'analyseur les distingue par les guillemets.
+.Pp
+Exemple minimal\ :
+.Bd -literal -offset indent
+nowline v1
+roadmap r "Demo" start:2026-01-06
+swimlane platform
+  item research "Research" duration:3w
+  item build "Build" duration:2w
+.Ed
+.Pp
+Voir
+.Xr nowline 5
+.Pq Sy man 5 nowline
+pour la grammaire complète, toutes les propriétés, les règles de
+validation et les déclarations
+.Sy include
+/ config / style.
 .Sh INDICATEURS DE MODE
 Les indicateurs de mode ci-dessous sont mutuellement exclusifs.
 .Bl -tag -width Fl
@@ -421,4 +460,4 @@ les jalons libres
 et le modèle de localisation
 .Pq Pa specs/localization.md .
 .Sh AUTEURS
-.An Lolay Aq Mt packages@lolay.com
+.An Les Auteurs de Nowline Aq Mt maintainers@nowline.io

package/man/fr/nowline.5

@@ -20,7 +20,7 @@
 Un fichier
 .Pa .nowline
 est une esquisse à indentation significative qui définit une feuille
-de route.
+de route, et non un diagramme de Gantt.
 Le fichier lui-même est le produit\ ; tout autre artefact (SVG, PNG,
 PDF, HTML, Markdown+Mermaid, XLSX, MS Project XML) est une vue
 produite à partir de lui par
@@ -1861,4 +1861,4 @@ le modèle de localisation
 et les jalons libres
 .Pq Pa specs/milestones.md .
 .Sh AUTEURS
-.An Lolay Aq Mt packages@lolay.com
+.An Les Auteurs de Nowline Aq Mt maintainers@nowline.io

package/man/nowline.1

@@ -3,7 +3,7 @@
 .Os
 .Sh NAME
 .Nm nowline
-.Nd render, validate, and serve .nowline roadmap files
+.Nd create roadmaps using a human readable text file .nowline
 .Sh SYNOPSIS
 .Nm
 .Op Fl f Ar format
@@ -30,44 +30,16 @@
 .Op Fl h | Fl -help
 .Sh DESCRIPTION
 .Nm
-parses a
+is a CLI that processes simple human readable
 .Pa .nowline
-roadmap file (or its JSON AST form) and writes the rendered output to a
-file or to standard output.
-Rendering is the default; other modes are selected by mutually-exclusive
-mode flags rather than subcommands
-.Pq verbless, matching mmdc, dot, d2, prettier, and tsc .
+files that define a roadmap, not a Gantt chart.
+The primary artifact is an SVG, but it also generates many other
+artifacts including PNG, PDF, HTML, Markdown+Mermaid, XLSX, MS Project
+XML.
 .Pp
-The render pipeline is
-.Sy parse
-\(->
-.Sy validate
-\(->
-.Sy layout
-\(->
-.Sy format-specific exporter .
-Output is byte-for-byte deterministic for a given input,
-.Fl -theme ,
-and
-.Fl -now .
-.Pp
-A single
-.Nm
-binary ships every export format: SVG, PNG, PDF, HTML,
-Markdown+Mermaid, XLSX, MS Project XML, plus AST round-trip
-.Pq json , nowline .
-.Pp
-.Ar input
-is required for the default render mode,
-.Fl -serve ,
-and
-.Fl -dry-run .
-Pass
-.Sq -
-to read from standard input.
-With zero arguments,
-.Nm
-prints help and exits 0.
+This page documents the CLI.
+For the file format, see
+.Xr nowline 5 .
 .Sh INPUT
 The input format is detected from the file extension:
 .Pa .nowline
@@ -93,61 +65,28 @@ Comments use
 or
 .Sq /* */ .
 .Pp
-File structure has up to four sections in strict order:
-.Bl -enum -offset indent -compact
-.It
-.Sy nowline v1
-directive (optional, must be the first non-comment line; accepts
-.Sy locale:<bcp47> ) .
-.It
-.Sy include
-declarations (optional).
-.It
-.Sy config
-section (optional): styles, defaults, scale, calendar, symbols.
-.It
-.Sy roadmap
-section (required): the content.
-.El
-.Pp
-Keyword summary:
-.Bl -tag -width "person/team" -compact
-.It Sy nowline
-DSL version directive (currently
-.Sy v1 ) .
-.It Sy include
-Pull in another
-.Pa .nowline
-file;
-.Sy config:
-and
-.Sy roadmap:
-modes
-.Pq Sy merge | ignore | isolate
-control merge behavior.
-.It Sy config , roadmap
-Section markers; one
-.Sy roadmap
-per file.
-.It Sy style , symbol , default , scale , calendar
-Config keywords (presentation, defaults, axis, day arithmetic).
+Core keywords:
+.Bl -tag -width "person, team" -compact
+.It Sy roadmap
+The top-level roadmap declaration; one per file.
+.It Sy swimlane
+A horizontal lane of work (team, area, stream).
+.It Sy item
+A unit of work, indented under a swimlane.
+.It Sy parallel
+A block whose children run concurrently.
+.It Sy group
+A logical bundle of items, rendered together.
+.It Sy anchor
+A named date on the timeline.
+.It Sy milestone
+A point-in-time marker that depends on work.
 .It Sy person , team
 Org vocabulary referenced by
 .Sy owner: .
-.It Sy anchor , milestone
-Named dates and achievement markers on the timeline.
-.It Sy label , size , status
-Reusable vocabulary referenced by
-.Sy labels: , size: , status: .
-.It Sy swimlane
-Groups items by team / area / stream.
-.It Sy item
-Work item, indented under a swimlane (or parallel / group).
-.It Sy parallel , group
-Parallel block and sequential bundle; nestable.
-.It Sy footnote
-Annotation attached to one or more entities via
-.Sy on: .
+.It Sy label
+Reusable tag referenced by
+.Sy labels: .
 .El
 .Pp
 Every entity follows a universal shape:
@@ -160,30 +99,22 @@ At least one of
 or
 .Qq Ar title
 is required \(em the parser distinguishes them by quoting.
-Lists use bracket notation
-.Pq Sy labels:[a, b] ;
-a trailing
-.Sq \e
-continues a line.
 .Pp
 Minimal example:
 .Bd -literal -offset indent
 nowline v1
-
 roadmap r "Demo" start:2026-01-06
-
-size m effort:1w
-
 swimlane platform
-  item auth "Auth refactor" size:m
+  item research "Research" duration:3w
+  item build "Build" duration:2w
 .Ed
 .Pp
 See
 .Xr nowline 5
 .Pq Sy man 5 nowline
-for the full grammar, every property, validation rules, and the
+for the full grammar, every property, validation rules, and
 .Sy include
-collision model.
+/ config / style declarations.
 .Sh MODE FLAGS
 The mode flags below are mutually exclusive.
 .Bl -tag -width Fl
@@ -514,4 +445,4 @@ the CLI surface
 and OSS milestones
 .Pq Pa specs/milestones.md .
 .Sh AUTHORS
-.An Lolay Aq Mt packages@lolay.com
+.An The Nowline Authors Aq Mt maintainers@nowline.io

package/man/nowline.5

@@ -7,8 +7,9 @@
 .Sh DESCRIPTION
 A
 .Pa .nowline
-file is an indentation-significant outline that defines a roadmap.
-The file itself is the product; every other artefact (SVG, PNG, PDF,
+file is an indentation-significant outline that defines a roadmap, not
+a Gantt chart.
+The file itself is the product; every other artifact (SVG, PNG, PDF,
 HTML, Markdown+Mermaid, XLSX, MS Project XML) is a view of it produced
 by
 .Xr nowline 1 .
@@ -670,7 +671,7 @@ plus a small title chiclet.
 A
 .Sy group
 with no styling is purely structural \(em it only governs
-sequencing and inner row growth, with no visible artefact.
+sequencing and inner row growth, with no visible artifact.
 .Ss anchor \(em named date on the timeline
 .Bd -literal -offset indent
 anchor kickoff date:2026-01-06
@@ -1781,4 +1782,4 @@ the localization model
 and OSS milestones
 .Pq Pa specs/milestones.md .
 .Sh AUTHORS
-.An Lolay Aq Mt packages@lolay.com
+.An The Nowline Authors Aq Mt maintainers@nowline.io

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nowline/cli",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Nowline command-line interface — validate, convert, init",
   "license": "Apache-2.0",
   "type": "module",
@@ -33,17 +33,17 @@
     "consola": "^3.4.0",
     "js-yaml": "^4.1.0",
     "langium": "~4.2.2",
-    "@nowline/config": "0.2.0",
-    "@nowline/core": "0.2.0",
-    "@nowline/export-core": "0.2.0",
-    "@nowline/export-html": "0.2.0",
-    "@nowline/export-mermaid": "0.2.0",
-    "@nowline/export-msproj": "0.2.0",
-    "@nowline/export-png": "0.2.0",
-    "@nowline/layout": "0.2.0",
-    "@nowline/export-pdf": "0.2.0",
-    "@nowline/renderer": "0.2.0",
-    "@nowline/export-xlsx": "0.2.0"
+    "@nowline/config": "0.2.2",
+    "@nowline/export-core": "0.2.2",
+    "@nowline/export-html": "0.2.2",
+    "@nowline/export-mermaid": "0.2.2",
+    "@nowline/core": "0.2.2",
+    "@nowline/export-msproj": "0.2.2",
+    "@nowline/export-png": "0.2.2",
+    "@nowline/export-xlsx": "0.2.2",
+    "@nowline/layout": "0.2.2",
+    "@nowline/renderer": "0.2.2",
+    "@nowline/export-pdf": "0.2.2"
   },
   "devDependencies": {
     "@types/babel__code-frame": "^7.0.6",

package/src/generated/version.ts

@@ -1,6 +1,6 @@
 // Auto-generated by scripts/bundle-templates.mjs. Do not edit by hand.
 
-export const CLI_VERSION = "0.2.0";
+export const CLI_VERSION = "0.2.2";
 
 export interface CliBuild {
     /** Short git SHA at build time, or empty when not in a git checkout. */
@@ -12,7 +12,7 @@ export interface CliBuild {
 }
 
 export const CLI_BUILD: CliBuild = {
-    "sha": "c51e2a4",
+    "sha": "df3ebcc",
     "isRelease": true,
     "isDirty": false
 };