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

Triple-backtick inline code at line start opens a phantom code fence and hides the rest of the spec

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

I maintainer di solito rispondono entro 2 giorni

@kevin9327 ci sta già lavorando.

Dal 20/10/2026.

  • #2131 di @kevin9327 — aperta

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
82/100
Tipo di issue
Bug
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
node.js, typescript
Ambito
backend

Direzione di ricerca

Inizia con buildCodeFenceMask in src/core/parsers/code-fence.ts e il test unitario di MarkdownParser menzionato nell’issue. Riproduci il caso in cui una riga inizia con codice inline composto da tre backtick, poi verifica che il parsing mantenga entrambi i requisiti. Il lavoro è completato quando il codice inline non maschera le righe successive e il test di regressione passa.

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

Descrizione

What happened

A line in a spec that starts with triple-backtick inline code, e.g. ```openspec validate``` SHALL exit 0, is treated as the opening of a fenced code block. buildCodeFenceMask (src/core/parsers/code-fence.ts) then masks every following line to end of file, so later requirements and scenarios disappear from parsing (validate, show, list, archive).

new MarkdownParser(content).parseSpec('s').requirements.length // 1, the second requirement is gone
What you expected instead

Per CommonMark, a backtick fence's info string cannot contain backticks, so ```npm test``` must pass. is a paragraph with inline code, not a fence. Both requirements should be parsed.

Minimal steps to reproduce
  1. Create openspec/specs/demo/spec.md: 
    # Demo
## Purpose
Purpose text.
## Requirements
### Requirement: First
```openspec validate``` SHALL exit 0 on a valid change.
#### Scenario: ok
- **WHEN** valid
- **THEN** exit 0
### Requirement: Second
The system SHALL keep this requirement.
#### Scenario: kept
- **WHEN** parsed
- **THEN** present
  2. Run openspec show demo --json.
  3. Only First is listed. Second is silently dropped.
OpenSpec version

main @ current HEAD

Coding agent and model

Grok Bot (AI assistant) helped find this; reproduced with a unit test against MarkdownParser.

OS and Node version

Linux, Node 20.19.2

Lingua principale
TypeScript
Stelle
72.3k
Fork
4.9k
Merge medio
2g 2h
PR unite (30g)
80

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

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 Fission-AI/OpenSpec

Tutte le issue di Fission-AI/OpenSpec

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.