fix(scripts): exclude generated AIDD cache from Markdown link checks
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 2/5
- Temps estimé
- 1-3 heures
- Accessibilité débutants
- 76/100
- Type d'issue
- Bug
- Clarté
- Clairement spécifiée
- Activité
- Active
- Stack technique
- javascript, markdown, node.js
- Domaine
- developer-experience, tooling
Piste de recherche
Commence dans scripts/check-markdown-links.js et trouve où sont définis les racines de scan et les motifs d’ignore par défaut ; le flag --ignore .aidd dans le rapport montre qu’un mécanisme d’exclusion existe déjà. Reproduis avec l’extrait en deux étapes (crée .aidd/cache/markdown-link-repro.md, puis exécute le script avec et sans --ignore .aidd) pour confirmer que le chemin par défaut est la seule différence. Vérifie ensuite quels Git hooks ou commandes de validation invoquent le script afin qu’ils partagent la même exclusion par défaut, et ajoute un test de régression couvrant à la fois le fichier de cache exclu et un véritable lien cassé dans du Markdown versionné.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
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.
- Langage dominant
- TypeScript
- Étoiles
- 481
- Forks
- 45
- Merge moyen
- 1 j 6 h
- PR mergées (30 j)
- 103
Préparer son environnement
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de ai-driven-dev/framework
-
fix(cli): doctor warns that claude no longer declares aidd-framework right after a clean setupOuverte
Difficulté 2/5 1-3 heures Accessibilité débutants 74/100
ai-driven-dev/framework#1118 ·
Les mainteneurs répondent en général sous 1 jour
-
docs(framework): explain how a contributor without push access opens a pull requestPeut-être pris @sadhana-s-codez l’a pris il y a 2 jours. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 76/100
ai-driven-dev/framework#1117 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 88/100
ai-driven-dev/framework#1002 ·
Les mainteneurs répondent en général sous 1 jour
-
feat(aidd-dev/test): enforce test effectiveness and test-double disciplinePeut-être pris Une pull request liée à cette issue est ouverte ou déjà fusionnée. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 82/100
ai-driven-dev/framework#952 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
refactor(aidd-orchestrator): the check zone says when to stop, and reviews its axes in one roundOuverte
Difficulté 2/5 1-3 heures Accessibilité débutants 76/100
ai-driven-dev/framework#887 · 2 commentaires ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de ai-driven-dev/framework
Issues similaires
-
Replace discontinued crypto-js in the themePeut-être pris @aelmanaa l’a pris aujourd’hui. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 85/100
PaloAltoNetworks/docusaurus-openapi-docs#1689 ·
Les mainteneurs répondent en général sous 2 jours
-
Difficulté 2/5 1-3 heures Accessibilité débutants 70/100
solana-foundation/solana-web3.js#4015 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
formatSearchQuery drops the :present modifier, so `email:present=true` is sent as `email=true`Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 85/100
Les mainteneurs répondent en général sous 1 jour
-
documentation
Difficulté 1/5 1-3 heures Accessibilité débutants 90/100
ivopogace/opencode-courier#422 ·
Les mainteneurs répondent en général sous 1 jour
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
chapel-lang/chapel-vscode#158 ·
Les mainteneurs répondent en général sous 1 jour