github / github/spec-kit

[Bug]: markdownlint CI job lints 0 files — glob quoting makes lint.yml a no-op

Aperta Adatta ai principianti
#4,527 1 commento 0 reazioni 0 assegnatari Vedi su GitHub
needs-triage triage-nice-to-have
Lingua principale
Python
Stelle
137k
Fork
12.3k
Merge medio
2g 12h
PR unite (30g)
159

Descrizione

### Bug Description

The markdownlint job in .github/workflows/lint.yml lints zero files on every run, so it reports success unconditionally. Markdown formatting has not been enforced in CI since 2026-02-10.

### Steps to Reproduce

1. Open Lint workflow run 34513299255 for commit c173bf19a6654e3b05386ec3599349a55282b897 and inspect the markdownlint job. It reports Linting: 0 files and Summary: 0 issues in 0 files.
2. Reproduce locally with: npx --yes markdownlint-cli2@0.23.2 "'**/*.md'" "!extensions/**/*.md".
3. Remove the single quotes; the command then matches files and reports the existing violations.

### Expected Behavior

The job should lint the tracked Markdown files it is intended to cover (**/*.md except extensions/**/*.md) and fail when they contain lint errors.

### Actual Behavior

The job matches no files and always passes.

### Specify CLI Version

Not applicable — CI workflow defect at main @ c173bf19a6654e3b05386ec3599349a55282b897

### AI Agent

Alquimia AI

### Operating System

Windows 11 host; behavior confirmed in the live ubuntu-latest runner log

### Python Version

Not applicable — workflow defect

### Error Logs

```shell
markdownlint-cli2 v0.23.2 (markdownlint v0.41.1)
Finding: '**/*.md' !extensions/**/*.md
Linting: 0 files
Summary: 0 issues in 0 files
```

### Additional Context

Root cause: the YAML block scalar in .github/workflows/lint.yml preserves the single quotes around **/*.md, so markdownlint-cli2 receives a quoted glob that matches nothing. The issue was introduced by commit f14a47e. Running the intended scope against tracked files reports 277 issues across 32 files. Removing the quotes would make CI meaningful but red, so maintainer direction is needed for the intended scope and cleanup plan.

AI Assistance Disclosure: AI assistance was used for repository inspection, reproduction, evidence gathering, and drafting this report. The finding was checked against the frozen commit, live CI log, local reproduction output, and all-state issue/PR searches; no code changes were made for this report. Related issue #1030 does not report this exact defect.

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Inspect .github/workflows/lint.yml and reproduce the markdownlint-cli2 command from the issue, comparing the quoted and unquoted glob behavior. Confirm that the intended tracked Markdown scope is matched and that CI reports existing lint violations rather than passing with zero files; the cleanup plan for those violations needs maintainer direction.

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

Valutazione

Stack tecnologico
github-actions
Ambito
ci-cd, documentation
Tipo di issue
Bug
Difficoltà
2/5
Tempo stimato
1-3 ore
Stato di attività
Attiva
Chiarezza
Abbastanza chiara
Idoneità per principianti
72/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.