From 466ed6b65f13d6b52c8e9ad805ff20b9d272456a Mon Sep 17 00:00:00 2001
From: Nicolas Cantu <nicolas.cantu@pm.me>
Date: Fri, 3 Apr 2026 22:45:43 +0200
Subject: [PATCH] chore(gitmodules): document service paths, add langextract
 upstream submodule
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Comment block mapping services to submodule paths (carbonyl/chandra/pageindex/langextract upstream)
- Note agent-regex-search-api and claw-harness-api as in-repo only
- Add services/langextract-api/upstream → google/langextract (shallow)
- Document submodule and optional pip install -e in service-langextract.md
---
 .gitmodules                       | 24 ++++++++++++++++++++----
 docs/repo/service-langextract.md  |  2 ++
 services/langextract-api/upstream |  1 +
 3 files changed, 23 insertions(+), 4 deletions(-)
 create mode 160000 services/langextract-api/upstream

diff --git a/.gitmodules b/.gitmodules
index 35067ca..50b5bbc 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,12 +1,28 @@
+# Correspondance chemins services ↔ sous-modules Git :
+#
+# — Amonts tiers (sous-module dans services/<service>/upstream/) :
+#     services/carbonyl/upstream        → fathyb/carbonyl
+#     services/chandra/upstream         → datalab-to/chandra
+#     services/pageindex/upstream       → VectifyAI/PageIndex
+#     services/langextract-api/upstream → google/langextract
+#
+# — Code versionné dans ce dépôt uniquement (pas de sous-module sur la racine du service) :
+#     services/agent-regex-search-api
+#     services/claw-harness-api         (claw-code amont : clone séparé, voir docs/repo/service-claw-harness.md)
+
 [submodule "services/carbonyl/upstream"]
 	path = services/carbonyl/upstream
 	url = https://github.com/fathyb/carbonyl.git
 	shallow = true
-[submodule "services/pageindex/upstream"]
-	path = services/pageindex/upstream
-	url = https://github.com/VectifyAI/PageIndex.git
-	shallow = true
 [submodule "services/chandra/upstream"]
 	path = services/chandra/upstream
 	url = https://github.com/datalab-to/chandra.git
 	shallow = true
+[submodule "services/pageindex/upstream"]
+	path = services/pageindex/upstream
+	url = https://github.com/VectifyAI/PageIndex.git
+	shallow = true
+[submodule "services/langextract-api/upstream"]
+	path = services/langextract-api/upstream
+	url = https://github.com/google/langextract.git
+	shallow = true
diff --git a/docs/repo/service-langextract.md b/docs/repo/service-langextract.md
index 2afc7dd..b72582d 100644
--- a/docs/repo/service-langextract.md
+++ b/docs/repo/service-langextract.md
@@ -2,6 +2,8 @@
 
 API HTTP locale sur **`127.0.0.1`** autour de [google/langextract](https://github.com/google/langextract) : extractions structurées depuis du texte, avec ancrage caractères optionnel.
 
+Le dépôt amont est aussi référencé comme **sous-module Git** : `services/langextract-api/upstream` (voir `.gitmodules` à la racine du monorepo). Après `git clone`, exécuter `git submodule update --init --recursive services/langextract-api/upstream` si le dossier est vide. Par défaut l’API installe la librairie via **PyPI** (`requirements.txt`). Pour utiliser la révision du sous-module : `pip install -e ./upstream` dans le venv et retirer la ligne `langextract` du fichier `requirements.txt` pour cette installation.
+
 ## Variables
 
 | Variable | Obligatoire | Description |
diff --git a/services/langextract-api/upstream b/services/langextract-api/upstream
new file mode 160000
index 0000000..9b57b1b
--- /dev/null
+++ b/services/langextract-api/upstream
@@ -0,0 +1 @@
+Subproject commit 9b57b1b63b3a09bc1a64deeb29d4865d533049ff