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

AGENTS.md: the dependency lockstep bullet and the npm test annotation are stale

Chiusa Adatta ai principianti
#4,924 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
1/5
Tempo stimato
1-3 ore
Idoneità per principianti
92/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
typescript
Ambito
documentation

Direzione di ricerca

Inizia dalle sezioni Dependencies e Development setup in AGENTS.md, quindi confrontale con il guard verify:dep-lockstep e gli script di workspace per test e coverage. Aggiorna il punto elenco della dipendenza in modo che indichi la regola «un range ovunque» e nomini il guard, quindi correggi l’annotazione di npm test senza modificare il paragrafo non correlato Before pushing. Verifica se il PR di #4871 ha già modificato una delle due righe.

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

Descrizione

agent guidance documentation v2

Found while writing the knowledge skills (#4872, PR #4921). Two statements in AGENTS.md no longer match the repository, and AGENTS.md says of itself that every rule in it is true of the repository as it stands.

1. Dependencies: the shared-devDependency bullet contradicts the guard

AGENTS.md → Dependencies says:

When you bump a devDependency that several TypeScript workspaces declare (typescript, vitest, @vitest/coverage-v8, @types/node, …), bump it in every workspace that declares it. Their ranges already differ; do not widen the skew.

Since #4864, npm run verify:dep-lockstep (in validate:guards, so in CI) fails when two declarations of a package in SHARED_DEV_DEPENDENCIES (typescript, vitest, @vitest/coverage-v8, prettier, @types/node) carry different ranges. The ranges no longer differ, and "do not widen the skew" understates a rule that is now "one range everywhere it is declared". The local-dev skill describes the guard, so an agent gets a different instruction depending on whether the skill loaded. Copilot raised this on PR #4921 (round 3).

Expected: the bullet states the lockstep rule the guard enforces and names the guard.

2. Development setup: npm test is annotated "with coverage"

The command block says:

npm test -w src/<server>                # one workspace (vitest, with coverage)

Each workspace's test script is vitest run. Coverage is the separate coverage script (vitest run --coverage).

Expected: the annotation drops "with coverage", or the block lists npm run coverage -w src/<server> on its own line.

Not included

The Before pushing paragraph saying CI does not run ruff check is also stale (python.yml runs scripts/validate-py.mjs, which does), but #4871's PR rewrites that section, so it is left to that change.

Branch

Targets v2/main. If #4871's PR is still open when this is picked up, check whether it already touched either line.

Lingua principale
TypeScript
Stelle
91k
Fork
11.8k
Merge medio
6h 47m
PR unite (30g)
74

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 modelcontextprotocol/servers

Tutte le issue di modelcontextprotocol/servers

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.