Webpack + patch-spec

Se você precisa manter webpack: true no nest-cli.json, aplique docs files no build ao invés de em runtime.

Por que isso é necessário

Com "webpack": true no nest-cli.json (o default documentado para monorepos com múltiplos apps), a discovery em runtime do DocfyModule não funciona: webpack empacota tudo num único bundle e nunca popula require.cache com uma entrada por arquivo-fonte original, que é do que essa discovery depende. Isso é arquitetural, não um bug corrigível. Ver strict e webpack.

Pipeline

bash

# 1. Suba a app apenas para obter o /api-json vivo
node dist/main.js &

# 2. Gere um documento OpenAPI já com todos os docs files aplicados
npx nestjs-docfy patch-spec --spec http://localhost:3000/api-json --out openapi.patched.json

# 3. Sirva o documento com patch via DocfyUiModule
#    DocfyUiModule.setup('/docs', app, { staticSpecPath: './openapi.patched.json' });

Chame o DocfyUiModule.setup() antes do SwaggerModule.setup() para que o /api-json estático tenha precedência sobre o vivo.