Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

fix(aidd-context): the memory README links 404 on Windows

Abierto Apto para principiantes
  • ¿Algo no está bien?
#986 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

@VincentMenard76 ya está trabajando en esto.

Desde el 9/10/2026.

  • #987 de @VincentMenard76 — abierto

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
72/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
javascript, nodejs
Área
tooling

Línea de trabajo

Empieza con memoryRelative() y memoryPath() en plugins/aidd-context/hooks/update_memory.js. memoryPath() usa path.join, que produce barras invertidas en win32, así que la eliminación del prefijo nunca coincide. Normaliza ambos lados a / y comprueba que el bloque files lista rutas relativas al README. Está terminado cuando pasa una prueba de regresión que ejecuta el hook real y lee el README escrito, y scripts/check-markdown-links.js no informa de enlaces rotos allí.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Description

On Windows, the memory hook rewrites the table of contents of aidd_docs/memory/README.md with links that keep the aidd_docs/memory/ prefix. Read from inside aidd_docs/memory/, every one of them points nowhere.

memoryRelative() strips ${memoryPath(path)}/ from a path it first normalises to /. memoryPath() uses path.join, which answers aidd_docs\memory on win32, so the prefix never matches and is never removed.

Affected file(s)

  • plugins/aidd-context/hooks/update_memory.js (memoryRelative)

Expected behaviour

The files block lists each memory file relative to the README: - [architecture.md](architecture.md), - [internal/decisions/x.md](internal/decisions/x.md).

Observed behaviour

On Windows, after any session start: - [aidd_docs/memory/architecture.md](aidd_docs/memory/architecture.md). node scripts/check-markdown-links.js then reports every link in that file as broken (12 here). The hook stages the file itself, so the broken README rides along into the next commit unnoticed.

Proposed solution

Normalise both sides of the comparison to / in memoryRelative, and add a regression test that runs the real hook and reads the README it writes.

Context / Technical constraints

  • cli-ci.yml's Windows job runs the scripts suite, but only when its changes filter marks the change relevant, and that filter does not match plugins/aidd-context/**. A later change to update_memory.js alone would skip the Windows job, so the regression test would only bite on a Windows workstation. Linux CI passes either way.

Environment
AI tool Claude Code
OS Windows 11 Pro (10.0.26100)
node 24.12.0

QA

  1. On Windows, in a project whose aidd_docs/memory/README.md carries <!-- files:start --> / <!-- files:end -->, start a session (or run node plugins/aidd-context/hooks/update_memory.js claude).
  2. The files block lists architecture.md, not aidd_docs/memory/architecture.md.
  3. node scripts/check-markdown-links.js reports no broken link in that README.
Lenguaje dominante
TypeScript
Estrellas
481
Forks
45
Merge medio
19 h 7 min
PR fusionados (30 d)
60

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de ai-driven-dev/framework

Todos los issues de ai-driven-dev/framework

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.