resolveDocsRoot
expérimentaldepuis 0.1.0@legba-core/mcp-docs
resolveDocsRoot
Ce que ça fait
Retrouve docs/ à la racine du monorepo legba-core, en remontant depuis startDir (comme resolveRepoRoot).
Signature
function resolveDocsRoot(startDir: string): string
Paramètres
| Nom | Type | Requis | Défaut | Description |
|---|---|---|---|---|
startDir | string | oui | — | Dossier de départ, typiquement celui du fichier en cours d’exécution (import.meta.url) |
Retour
Le chemin absolu de docs/ à la racine du monorepo.
Erreurs
| Code | Quand | Comment corriger |
|---|---|---|
| (exception générique) | Aucun pnpm-workspace.yaml trouvé en remontant depuis startDir | N’appeler cette fonction que depuis un fichier situé à l’intérieur du monorepo legba-core |
Exemple minimal
import { resolveDocsRoot } from "@legba-core/mcp-docs";
const docsRoot = resolveDocsRoot(process.cwd());
Exemple complet
import { dirname } from "node:path";
import { fileURLToPath } from "node:url";
import { createFsDocsRepository, resolveDocsRoot } from "@legba-core/mcp-docs";
const here = dirname(fileURLToPath(import.meta.url));
const docsRoot = resolveDocsRoot(here);
const repo = createFsDocsRepository(docsRoot);
console.log(repo.listApiDocs().length);
Pièges
- Rend
docs/, pas la racine du monorepo — passer ce résultat directement àcreateFsDocsRepository, jamais à un chemin qui attend la racine. - Mêmes limites que
resolveRepoRoot: ne fonctionne que depuis l’intérieur du monorepolegba-core.