missing-onready --fix writes @onready @export, and misses @onready above a comment
Mantenedores costumam responder em até 2 dias
@mafujahmedridoy22-commits já está trabalhando nisso.
Desde 14/11/2026.
Avaliação
- Dificuldade
- 2/5
- Tempo estimado
- 1-3 horas
- Facilidade para iniciantes
- 88/100
- Tipo de issue
- Bug
- Clareza
- Claramente especificada
- Status de atividade
- Ativa
- Stack de tecnologia
- typescript
- Domínio
- tooling
Direção de pesquisa
Comece por src/lint/rules/missing-onready.ts e examine hasOnready e a lógica de detecção e correção; depois, leia os casos relacionados em test/fixes.test.ts e test/rules.test.ts. Execute npm run build && npm test conforme listado na issue. O trabalho estará concluído quando comentários entre @onready e var forem tratados, declarações exportadas não receberem correção e permanecerem idênticas byte a byte, e declarações simples continuarem sendo corrigidas.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
Summary
The machine-applicable fix for missing-onready writes wrong code in two cases. gdcorrect lint --fix writes it to user files.
- On an exported member,
@export var x: Node = $Xbecomes@onready @export var x: Node = $X. Godot warns on@onreadycombined with@export(ONREADY_WITH_EXPORT). The initializer then runs after the inspector value is applied and overwrites it, so the designer's assignment is silently lost. A test currently asserts this rewrite as correct. - When a comment sits between a standalone
@onreadyline and thevar, the rule does not see the annotation. It reports a false positive, and--fixadds a second@onready.
Where
src/lint/rules/missing-onready.ts:29(hasOnready: thepreviousNamedSiblingwalk stops at the firstcommentnode)src/lint/rules/missing-onready.ts:42-55(finding and fix are emitted regardless of@export*annotations)test/fixes.test.ts:24-29(expects@onready @export var other: Node = $Other)
Details
@onready
# the player sprite
var a: Node = $A # flagged; --fix -> "@onready var a ..." (second @onready)
@export var c: Node = $C # --fix -> "@onready @export var c ..."
Tree-sitter comments are named nodes, so s.type === "annotation" || s.type === "annotations" ends the loop at the comment.
Impact
--fix is described as applying only machine-applicable fixes. Here it changes runtime behaviour (exported values overwritten at _ready) or produces a redundant annotation, in files the user did not review.
Steps to reproduce
- Put either snippet above in a project script.
- Run
gdcorrect lint <project> --fix, then inspect the file.
Suggested fix
- In
hasOnready, skipcommentsiblings while walking backwards. - When the declaration carries any
@export*annotation, attach nofix. Either keep the finding with a message suggesting an exportedNodePathor no initializer, or skip it. - Update
test/fixes.test.tsto expect no fix for exported members.
Acceptance criteria
-
@onready/ comment /var a = $Ais not flagged. -
@export var n: Node = $Nand@export_*variants have nofix, and--fixleaves those lines byte-identical. - Plain
var n: Node = $Nis still fixed.
Getting started
- Relevant files:
src/lint/rules/missing-onready.ts,test/fixes.test.ts,test/rules.test.ts - How to run tests:
npm run build && npm test
Filed by repo-audit/full-audit at e836036. Severity: medium. Effort: S. audit-key: bug|src/lint/rules/missing-onready.ts|missingOnready.fix
- Linguagem predominante
- TypeScript
- Estrelas
- 0
- Forks
- 6
- Merge médio
- 1d 21h
- PRs com merge (30d)
- 8
Preparar o ambiente
- Sem Dockerfile nem arquivo Docker Compose
- Sem modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de TMHSDigital/godot-correctness-mcp
-
enhancement good first issue severity: medium
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 85/100
TMHSDigital/godot-correctness-mcp#123 ·
Mantenedores costumam responder em até 2 dias
-
dependencies good first issue severity: low
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
TMHSDigital/godot-correctness-mcp#116 ·
Mantenedores costumam responder em até 2 dias
-
bug good first issue severity: low
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 88/100
TMHSDigital/godot-correctness-mcp#107 ·
Mantenedores costumam responder em até 2 dias
-
bug good first issue severity: low
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 85/100
TMHSDigital/godot-correctness-mcp#106 ·
Mantenedores costumam responder em até 2 dias
-
bug good first issue severity: medium
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 84/100
TMHSDigital/godot-correctness-mcp#105 ·
Mantenedores costumam responder em até 2 dias
Todas as issues de TMHSDigital/godot-correctness-mcp
Issues semelhantes
-
clawsweeper:needs-maintainer-review clawsweeper:needs-product-decision clawsweeper:no-new-fix-pr clawsweeper:source-repro impact:ux-friction issue-rating: 🦞 diamond lobster P3
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100
openclaw/openclaw#203385 · 1 comentário · 1 reação ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
nwverse/persona#12800 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 80/100
Mantenedores costumam responder em até 1 dia
-
[MCP]: page snapshots in .playwright-mcp/ are not git-ignored (.playwright-cli/ is, since #42318)Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 62/100
microsoft/playwright#44289 ·
Mantenedores costumam responder em até 1 dia
-
good first issue
Dificuldade 2/5 Meio dia Facilidade para iniciantes 65/100
Mantenedores costumam responder em até 1 dia