Nicolas Cantu
ac96434351
**Motivations:** - Single canonical documentation tree under docs/; reduce drift between README copies. **Evolutions:** - Add docs/repo/ with operational guides (cron, systemd, projects, logs, docv, ia_dev, services, scripts, extension). - Replace scattered README.md files with pointers to docs/repo/*.md. - Refresh docs/README.md index and cross-links across docs/, .cursor rules/agents. - Bump ia_dev submodule to matching doc pointer commits.
41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# repos-devtools-server (`services/repos-devtools-server/`)
|
||
|
||
API HTTP locale sur **`127.0.0.1`** pour des opérations Git sous **`REPOS_DEVTOOLS_ROOT`** (défaut souvent `/home/ncantu/code` — à adapter sur chaque poste).
|
||
|
||
Après un **`POST /repos-clone`** réussi, si le dépôt n’a pas **`.4nkaiignore`**, le serveur copie **`templates/4nkaiignore.default`** à la racine du clone. La réponse inclut **`fourNkAiIgnoreTemplateWrote`**.
|
||
|
||
## Variables d’environnement
|
||
|
||
| Variable | Obligatoire | Description |
|
||
|----------|-------------|-------------|
|
||
| `REPOS_DEVTOOLS_TOKEN` | oui | `Authorization: Bearer <token>` sur chaque requête. |
|
||
| `REPOS_DEVTOOLS_ROOT` | non | Racine des clones. |
|
||
| `REPOS_DEVTOOLS_HOST` | non | Adresse d’écoute (défaut `127.0.0.1`). |
|
||
| `REPOS_DEVTOOLS_PORT` | non | Port (défaut `37140`). |
|
||
|
||
## Endpoints
|
||
|
||
- `POST /repos-clone` — JSON `{ "url": "<git>", "branch": "test" }` (`branch` optionnel).
|
||
- `GET /repos-list`
|
||
- `POST /repos-load` — JSON `{ "name": "<folder>" }`
|
||
|
||
## Exécution
|
||
|
||
```bash
|
||
cd services/repos-devtools-server
|
||
npm install
|
||
npm run build
|
||
export REPOS_DEVTOOLS_TOKEN='…'
|
||
npm start
|
||
```
|
||
|
||
Unité systemd utilisateur possible : `systemctl --user daemon-reload && systemctl --user restart repos-devtools-server.service` après installation d’une unité locale.
|
||
|
||
## Templates
|
||
|
||
Maintenir **`templates/4nkaiignore.default`** aligné avec `extensions/anythingllm-workspaces/templates/4nkaiignore.default`.
|
||
|
||
## Spécification HTTP
|
||
|
||
[API/repos-devtools-server.md](../API/repos-devtools-server.md)
|