Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

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

Aperta Adatta ai principianti
  • Qualcosa non va?
#986 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@VincentMenard76 ci sta già lavorando.

Dal 9/10/2026.

  • #987 di @VincentMenard76 — aperta

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
72/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
javascript, nodejs
Ambito
tooling

Direzione di ricerca

Inizia da memoryRelative() e memoryPath() in plugins/aidd-context/hooks/update_memory.js. memoryPath() usa path.join, che produce backslash su win32, quindi la rimozione del prefisso non corrisponde mai. Normalizza entrambi i lati su / e verifica che il blocco files elenchi percorsi relativi al README. È completato quando un test di regressione che esegue l'hook reale e legge il README scritto passa, e scripts/check-markdown-links.js non segnala link non validi lì.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.
Lingua principale
TypeScript
Stelle
481
Fork
45
Merge medio
18h 3m
PR unite (30g)
48

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di ai-driven-dev/framework

Tutte le issue di ai-driven-dev/framework

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.