From 6589b9dc0584fc102f27415fc4a694372dddff5d Mon Sep 17 00:00:00 2001
From: Mossa <cgmossa@gmail.com>
Date: Fri, 27 Feb 2026 08:28:23 +0100
Subject: [PATCH 1/2] wp: spec for `dvs add`

---
 spec/add.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 spec/add.md

diff --git a/spec/add.md b/spec/add.md
new file mode 100644
index 0000000..434f017
--- /dev/null
+++ b/spec/add.md
@@ -0,0 +1,32 @@
+# `dvs add`
+
+Goal: Add files to an initialized dvs project.
+
+## CLI
+
+```sh
+dvs add [FILES] [OPTIONS]
+
+Files:
+    List of files to add
+
+Options:
+    -m, --message  Message attributed to the add event
+    --glob         Glob expression of the files to add, e.g. (`/phaseA/**/*.csv`)
+    --json Command output as JSON format
+    -h, --help
+
+```
+
+## R
+
+Signature:
+
+```r
+dvs_add <- function(
+  files = character(), # either files or glob are required
+  message, # not required, can be missing, `NULL`, "", and character() (empty)
+  glob = character(), # either files or glob are required
+  parallel = TRUE # enable parallel
+)
+```

From 2df9ada40ea0ddf94998eb19d39e2935f8694cda Mon Sep 17 00:00:00 2001
From: Mossa <cgmossa@gmail.com>
Date: Fri, 27 Feb 2026 13:25:32 +0100
Subject: [PATCH 2/2] updated `dvs add` path semantics

---
 spec/add.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/spec/add.md b/spec/add.md
index 434f017..59f0bf6 100644
--- a/spec/add.md
+++ b/spec/add.md
@@ -5,7 +5,7 @@ Goal: Add files to an initialized dvs project.
 ## CLI
 
 ```sh
-dvs add [FILES] [OPTIONS]
+dvs add <FILES> [OPTIONS]
 
 Files:
     List of files to add
@@ -18,6 +18,8 @@ Options:
 
 ```
 
+`dvs add` will not accept directories as input. However, if all files following a glob expression is to be added, the end-user can use `--glob`/`glob=` in the cli and R package resp.
+
 ## R
 
 Signature: