fix(scripts): exclude generated AIDD cache from Markdown link checks
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Aptitud para principiantes
- 76/100
- Tipo de issue
- Error
- Claridad
- Bien especificado
- Estado de actividad
- Activo
- Stack tecnológico
- javascript, markdown, node.js
- Área
- developer-experience, tooling
Línea de trabajo
Empieza en scripts/check-markdown-links.js y encuentra dónde se definen las raíces de escaneo predeterminadas y los patrones de ignore; el flag --ignore .aidd del informe muestra que ya existe un mecanismo de exclusión. Reproduce con el snippet de dos pasos (crea .aidd/cache/markdown-link-repro.md, luego ejecuta el script con y sin --ignore .aidd) para confirmar que la ruta predeterminada es la única diferencia. Después comprueba qué Git hooks o comandos de validación invocan el script para que compartan la misma exclusión predeterminada, y añade una prueba de regresión que cubra tanto el archivo de caché excluido como un enlace roto real en Markdown versionado.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Description
The repository-wide Markdown link validator scans generated artifacts under .aidd/cache/. Those files are ignored by Git and are not source Markdown, but broken links inside them still make validation fail.
The issue was reproduced on upstream/next at 829a5db6. It is independent of PR #992.
Steps to reproduce
- Create a generated Markdown artifact:
mkdir -p .aidd/cache
printf '# Generated cache artifact\n\n[Broken cache link](./missing-target.md)\n' \
> .aidd/cache/markdown-link-repro.md
- Run the repository-wide validator:
node scripts/check-markdown-links.js
- Compare with an explicit cache exclusion:
node scripts/check-markdown-links.js --ignore .aidd
Actual behavior
The default Markdown link validation reports broken links from generated .aidd/cache/ content, even though the directory is excluded from Git.
In the affected development environment, 464 broken links in generated cache files caused the Markdown validation and associated Git hooks to fail.
These failures are unrelated to changes in the tracked source files.
Expected behavior
The repository-wide Markdown link validator should exclude generated AIDD cache artifacts by default.
Broken links in tracked source Markdown should continue to be detected and reported normally.
Proposed fix
- Exclude generated
.aidd/cache/artifacts from the default Markdown link scan. - Preserve validation of tracked Markdown documentation, skills, actions, and references.
- Ensure the relevant Git hooks and validation commands use the same exclusion policy.
- Add regression coverage demonstrating that broken links in generated cache artifacts do not fail repository validation, while genuine broken links in source Markdown still fail.
Additional context
The problem was identified while validating PR #992 but is reproducible independently on next.
Temporarily moving .aidd/cache/ outside the repository allows validation to complete without changing the tracked source files. This is a workaround, not a permanent solution.
The issue should be addressed separately from Kilo-native generation.
Related: #992.
- Lenguaje dominante
- TypeScript
- Estrellas
- 481
- Forks
- 45
- Merge medio
- 1 d 4 h
- PR fusionados (30 d)
- 100
Preparar el entorno
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de ai-driven-dev/framework
-
fix(cli): doctor warns that claude no longer declares aidd-framework right after a clean setupAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 74/100
ai-driven-dev/framework#1118 ·
Los mantenedores suelen responder en 1 día
-
docs(framework): explain how a contributor without push access opens a pull requestPosiblemente ocupada @sadhana-s-codez la tomó hace 3 días. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
ai-driven-dev/framework#1117 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 88/100
ai-driven-dev/framework#1002 ·
Los mantenedores suelen responder en 1 día
-
feat(aidd-dev/test): enforce test effectiveness and test-double disciplinePosiblemente ocupada Un pull request vinculado a esta issue está abierto o ya se fusionó. Abierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
ai-driven-dev/framework#952 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
refactor(aidd-orchestrator): the check zone says when to stop, and reviews its axes in one roundAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
ai-driven-dev/framework#887 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
Todos los issues de ai-driven-dev/framework
Issues similares
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 76/100
Northeastern-Electric-Racing/FinishLine#4660 ·
Los mantenedores suelen responder en 2 días
-
BeOS .json missingAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
mihaip/infinite-mac#475 ·
-
Let TypeScript accept an initial object in ReactiveDictPosiblemente ocupada @yograj-vijay-yadav la tomó hoy. Abiertobug good first issue help wanted workshop
Dificultad 2/5 1-3 horas Aptitud para principiantes 92/100
meteor/meteor#14919 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 83/100
marmelab/atomic-crm#401 ·
Los mantenedores suelen responder en 1 día
-
account: profile
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
Los mantenedores suelen responder en 5 días