evolith_tracker/.github/workflows/docs.yml at main · beyondnetcode/evolith_tracker · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
name: Documentation Validation

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

permissions:
  contents: read

jobs:
  validate:
    name: Validate documentation
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: "20"

      - name: Validate docs
        run: node .harness/scripts/validate-docs.mjs

      - name: Check bilingual parity
        run: node .harness/scripts/check-bilingual-parity.mjs

      # `check-bilingual-parity` compara que el par EXISTA y que las cabeceras cuadren.
      # Ninguna de las dos cosas ve el IDIOMA, asi que un fichero copiado, reetiquetado
      # «English (this document)» y dejado en castellano lo pasa — que es exactamente el
      # estado que describen GAP-011 y GAP-017, y por eso ambas filas seguian siendo
      # ciertas con la paridad en verde. Medido el 2026-08-01: 9 de 151, incluidos
      # DECISIONS.md y MASTER_INDEX.md.
      #
      # Va como TRINQUETE: los nueve estan declarados con su motivo en
      # `untranslated-allowlist.json`, asi que hoy pasa; el decimo falla.
      - name: English-labelled documents actually read as English
        run: node .harness/scripts/check-translation-language.mjs

      - name: Validate root cleanliness
        run: node .harness/scripts/validate-root-cleanliness.mjs

      # GT-617 — los inventarios documentales se DERIVAN del código, no se mantienen a mano.
      # Falla el build a proposito: la insignia de ADRs, el mapa de schemas y el listado de
      # robots llevaban meses desfasados (30 vs 54 decisiones, 10 vs 8 schemas, 3 vs 12
      # robots) y nadie lo noto, porque nada los contrastaba con la fuente. Corre en segundos
      # y no necesita ni base de datos ni SDK.
      - name: Documentation inventory must match the code
        run: node .harness/scripts/doc-inventory.mjs --check

      - name: Check orphan bilingual files
        # El escalar plano de `run:` no puede contener ": " — rompia el parseo del workflow y
        # por eso este fichero nunca llego a ejecutarse (374 ejecuciones, 0 exitosas). Bloque
        # literal para que el texto quede fuera del analisis YAML.
        run: |
          node .harness/scripts/check-orphan-bilingual.mjs 2>/dev/null || echo "Skipped - script not available"

      - name: Generate coverage dashboard
        run: node .harness/scripts/coverage-dashboard.mjs

      - name: Upload coverage report
        uses: actions/upload-artifact@v4
        if: always()
        with:
          name: coverage-report
          path: COVERAGE_REPORT.md
          retention-days: 30

      - name: Report bilingual coverage
        run: node .harness/scripts/bilingual-coverage.mjs