feat: index Markdown files

Aperta
#115 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
18/100
Tipo di issue
Funzionalità
Chiarezza
Da chiarire
Stato di attività
Attiva
Stack tecnologico
go, markdown
Ambito
tooling

Direzione di ricerca

Start with internal/indexer/discover_test.go at lines 206 and 235, which assert that README.md is never discovered, and with the language entries in internal/indexer/languages_<lang>.go. The first decision is what a Markdown symbol is (headings, links, code fences) and whether it fits the graph vocabulary; this needs maintainer input before any code. Done means a recorded vocabulary decision, a discover test changed with a stated reason, and an updated capability matrix.

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

Descrizione

area:indexer feature priority:low spec-needed
What problem does this solve?

Documentation in Markdown (READMEs, ADRs, runbooks) is invisible to explore, search and the MCP tools, so an agent cannot reach docs through the graph.

What should it do?

To be decided first: what a Markdown "symbol" is (headings, links, code fences) and whether it belongs in the same graph vocabulary as functions and types. Then add a language entry following internal/indexer/languages_<lang>.go.

Which surface does this affect?

Indexing / extraction

Is this covered by an existing command or tool today?

No. .md is excluded by assertion, not by omission: internal/indexer/discover_test.go:206,235 asserts README.md is never discovered, so this change must narrow or replace that test deliberately. No tree-sitter-markdown grammar is vendored (go.mod). The upstream grammar is split into block and inline parsers, which does not fit the one-grammar-per-language registry. A new CGo dependency also enters the SBOM and the govulncheck set.

Acceptance criteria
  • A recorded vocabulary decision.
  • The discover test changed with a stated reason.
  • The capability matrix updated.

Source (GSD planning files, archived at d384473e): .planning/seeds/SEED-003-markdown-in-the-index.md


🤖 Generated with Claude Code

https://claude.ai/code/session_01UNqdnC3q6U362BvyfxuKCF

Lingua principale
Go
Stelle
0
Fork
0
Merge medio
7h 42m
PR unite (30g)
111

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 seanb4t/codegraph-go

Tutte le issue di seanb4t/codegraph-go

Issue simili

Altre issue su Go

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.