docs(supplies): actualiza AGENTS.md y Swagger del catálogo de insumos

[nopestack]

Closes #227

Resumen

La sección supplies de AGENTS.md describía el modelo anterior a la
epica #228 (un taxonomy compartido con Category/CategoryDefinition/
SupplyLine únicamente). Tras el merge reciente de #395, #396, #397,
#398, #399, #400, #405 y #408 el contexto es mucho más rico. Este PR
actualiza la documentación para reflejar el código real (leído
directamente, sin dar por buena la descripción original del issue):

• Categoría: pasó de enum cerrado a CategorySlug data-driven
  validado; el enum sobrevive como semilla de slugs núcleo
  (CORE_CATEGORY_SLUGS), protegidos frente a archivado
  (CategoryProtectedError → 409).
• Supply (master-data): código XXX-NNNN, variantes vía
  variantOfId + attributes, alias con resolución por
  nombre/traducciones/código, i18n base(es)+traducciones con
  fallback, nature (fungible/reusable/human), externalCodes
  (interop UNSPSC/HXL/…), merge de duplicados.
• Metamodelo de atributos (AttributeDefinition): campos tipados
  por familia de categoría con herencia (resolveEffectiveSchema) y
  validación/coacción (validateAttributes).
• Tenencia: scopeId global (null) + extensión aditiva por tenant;
  aclarado que los endpoints HTTP actuales sólo operan en scope global.
• Gobernanza: catalogue:manage (sólo platform_admin hoy), slugs
  núcleo protegidos, proyección pública vs. admin.
• Containers (palet/caja/lote, Empaquetado rastreable (Container palet/caja/lote) en supplies, reusando SupplyLine #140): ya implementados (no sólo
  "diseñado para"), documentados con su propio gate de autorización
  (coordinador de la emergencia, no catalogue:manage).

También se corrigió que apps/api/src/contexts/supplies es un host
hexagonal (casos de uso + Drizzle + HTTP) sobre el dominio real, que
vive en @globalemergency/warehouse-core (kernel/catalog/
containers), y que no usa @globalemergency/warehouse-postgres
para esta porción (esa persistencia hoy sólo cubre inventory/wms).

Swagger /docs

Se revisaron todos los controladores/DTOs de supplies (admin y
público). La mayoría ya tenía @ApiProperty/ejemplos completos de los
PRs recientes; los huecos reales eran las respuestas de error que
faltaban en los endpoints admin y público de insumos (404/400/409),
alineadas con lo que realmente lanza SuppliesDomainExceptionFilter.
Se regeneró apps/api/openapi.json y
packages/api-client/src/schema.ts (pnpm gen:api).

Alcance: sólo documentación y anotaciones Swagger — sin cambios de
lógica de dominio ni de docs/features/*.md (congelado).

Test plan

• pnpm install --frozen-lockfile
• pnpm --filter api build
• pnpm --filter api exec eslint "{src,apps,libs,test}/**/*.ts" --max-warnings=0
• pnpm --filter api exec prettier --check "src/**/*.ts" "test/**/*.ts"
• pnpm --filter api test (252 suites, 1632 tests, todo verde)
• pnpm --filter @reliefhub/api-client build && pnpm --filter web build
• pnpm gen:api (openapi.json y schema.ts regenerados y commiteados)

[vercel]

@nopestack is attempting to deploy a commit to the GlobalEmergency Team on Vercel.

A member of the Team first needs to authorize it.