Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

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

Geschlossen Anfängerfreundlich
  • Stimmt etwas nicht?
#986 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Anfängerfreundlichkeit
72/100
Issue-Typ
Bug
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
javascript, nodejs
Bereich
tooling

Rechercherichtung

Beginne mit memoryRelative() und memoryPath() in plugins/aidd-context/hooks/update_memory.js. memoryPath() verwendet path.join, das unter win32 Backslashes erzeugt, daher greift das Entfernen des Präfixes nie. Normalisiere beide Seiten auf / und prüfe, ob der files-Block Pfade relativ zur README auflistet. Fertig ist es, wenn ein Regressionstest, der den echten Hook ausführt und die geschriebene README liest, besteht und scripts/check-markdown-links.js dort keine defekten Links meldet.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

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.
Vorherrschende Sprache
TypeScript
Sterne
481
Forks
45
Ø Merge
1 T. 13 Std.
Gemergte PRs (30 T.)
77

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus ai-driven-dev/framework

Alle Issues in ai-driven-dev/framework

Ähnliche Issues

Weitere Issues zu TypeScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.