Return structuredContent with an outputSchema from status tools
Mantenedores costumam responder em até 1 dia
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 3/5
- Tempo estimado
- 1-2 dias
- Facilidade para iniciantes
- 60/100
- Tipo de issue
- Funcionalidade
- Clareza
- Claramente especificada
- Status de atividade
- Ativa
- Stack de tecnologia
- docker, node.js, typescript
Direção de pesquisa
Open mcp-server/src/tools/serviceHealth.ts first — the zod docker-ps schema already exists and is flattened to text around lines 206-233; compare with healthCheck.ts:95-110 and the forNodes helper in mcp-server/src/utils/fan-out.ts:18, which only returns text. Read CLAUDE.md and CONTRIBUTING.md for the registerTool convention, then declare outputSchema per tool and return structuredContent alongside the unchanged text. Run cd mcp-server && npm install && npm test plus npm run typecheck; done means the listed tools validate structured results while text output stays byte-identical.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
Summary
No tool declares outputSchema or returns structuredContent, although several already parse into typed data and then flatten it to text.
Where
mcp-server/src/tools/serviceHealth.ts:206-233mcp-server/src/tools/healthCheck.ts:95-110mcp-server/src/utils/fan-out.ts:18
Details
serviceHealth parses docker ps JSON with a zod schema; healthCheck builds CheckResult[]; forNodes returns only text.
Impact
Clients and agents that chain tools (fleet dashboards, "which nodes have unhealthy containers") must re-parse prose.
Suggested fix
Start with serviceHealth, healthCheck, piStatus, nodeList and backupStatus: declare outputSchema in registerTool and return both the current text and structuredContent. Let forNodes accept a structured per-node result and return { nodes: [{ name, host, ok, data | error }] }.
Open question: keep text output identical for prompts and skills?
Acceptance criteria
- Listed tools return validated structuredContent
- Text output unchanged
Getting started
- Relevant files:
mcp-server/src/tools/serviceHealth.ts,mcp-server/src/tools/healthCheck.ts,mcp-server/src/utils/fan-out.ts - How to run tests:
cd mcp-server && npm install && npm test(andnpm run typecheck); structure tests:pip install -r requirements-test.txt && pytest tests/ -v - Conventions: see
CLAUDE.mdandCONTRIBUTING.md
Filed by repo-audit/full-audit at 636fefb. Severity: medium. Effort: M. audit-key: enhancement|mcp-server/src/utils/fan-out.ts|structuredContent
- Linguagem predominante
- TypeScript
- Estrelas
- 0
- Forks
- 4
- Merge médio
- 10h 16min
- PRs com merge (30d)
- 2
Preparar o ambiente
- Sem Dockerfile nem arquivo Docker Compose
- Tem um 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/Home-Lab-Developer-Tools
-
speedtestResults ignores count: /api/speedtest/latest returns one resultTalvez já em andamento @laozhej assumiu há 2 dias. Abertabug severity: low
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 80/100
TMHSDigital/Home-Lab-Developer-Tools#160 ·
Mantenedores costumam responder em até 1 dia
-
Integration tests import tool modules inside tests and can time out under loadTalvez já em andamento @laozhej assumiu há 2 dias. Abertagood first issue severity: low testing
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 25/100
TMHSDigital/Home-Lab-Developer-Tools#174 ·
Mantenedores costumam responder em até 1 dia
-
Grafana dashboard import to complete the export/import round tripTalvez já em andamento @laozhej assumiu hoje. Abertaenhancement severity: low
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 68/100
TMHSDigital/Home-Lab-Developer-Tools#171 ·
Mantenedores costumam responder em até 1 dia
-
help wanted severity: low testing
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 55/100
TMHSDigital/Home-Lab-Developer-Tools#164 · 1 comentário ·
Mantenedores costumam responder em até 1 dia
-
enhancement severity: medium
Dificuldade 3/5 1-2 dias Facilidade para iniciantes 72/100
TMHSDigital/Home-Lab-Developer-Tools#159 ·
Mantenedores costumam responder em até 1 dia
Todas as issues de TMHSDigital/Home-Lab-Developer-Tools
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