Opt-in local audit log of executed state-changing tool calls
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 3/5
- Temps estimé
- 1-2 jours
- Accessibilité débutants
- 72/100
- Type d'issue
- Fonctionnalité
- Clarté
- Clairement spécifiée
- Activité
- Active
- Stack technique
- node.js, typescript
- Domaine
- observability, security
Piste de recherche
Start by reading mcp-server/src/utils/confirm-param.ts — it is the shared gate all twelve confirmed tools pass through, so the append belongs there rather than in each tool. Look at mcp-server/src/tools/nodeExec.ts:22 for the shape of a gated call and at mcp-server/src/index.ts:130 for the existing (only) logging pattern, then run cd mcp-server && npm install && npm test plus npm run typecheck. Done means: with HOMELAB_AUDIT_LOG set, a confirmed gated call appends one JSON line with timestamp, tool, node, host, masked command, exit status and duration, no secret values, covered by a unit test.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Summary
Twelve tools change remote state behind confirm: true, but nothing records what was executed.
Where
mcp-server/src/tools/nodeExec.ts:22mcp-server/src/index.ts:130(the only logging in src)
Details
After an agent session a user cannot answer "what did the AI run on my Pi, and when", which matters most for nodeExec, backupRestore and composeDown.
Impact
No after-the-fact record of agent actions on the user's hardware.
Suggested fix
Add opt-in HOMELAB_AUDIT_LOG=<path>: every confirmed gated call appends one JSON line (timestamp, tool, node, host, masked command, exit status, duration). Hook it in one place shared by the gated tools. Never log secret values.
Open questions: also log cancelled previews and dry runs? Rotate the file?
Acceptance criteria
- Gated calls append a JSON line when the variable is set
- No secret values in the log
- Unit test
Getting started
- Relevant files:
mcp-server/src/utils/confirm-param.ts,mcp-server/src/tools/nodeExec.ts,mcp-server/src/index.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/confirm-param.ts|audit-log
- Langage dominant
- TypeScript
- Étoiles
- 0
- Forks
- 4
- Merge moyen
- 10 h 16 min
- PR mergées (30 j)
- 2
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Propose un modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de TMHSDigital/Home-Lab-Developer-Tools
-
speedtestResults ignores count: /api/speedtest/latest returns one resultPeut-être pris @laozhej l’a pris il y a 2 jours. Ouvertebug severity: low
Difficulté 2/5 1-3 heures Accessibilité débutants 80/100
TMHSDigital/Home-Lab-Developer-Tools#160 ·
Les mainteneurs répondent en général sous 1 jour
-
Integration tests import tool modules inside tests and can time out under loadPeut-être pris @laozhej l’a pris il y a 2 jours. Ouvertegood first issue severity: low testing
Difficulté 2/5 1-3 heures Accessibilité débutants 25/100
TMHSDigital/Home-Lab-Developer-Tools#174 ·
Les mainteneurs répondent en général sous 1 jour
-
Grafana dashboard import to complete the export/import round tripPeut-être pris @laozhej l’a pris aujourd’hui. Ouverteenhancement severity: low
Difficulté 3/5 1-2 jours Accessibilité débutants 68/100
TMHSDigital/Home-Lab-Developer-Tools#171 ·
Les mainteneurs répondent en général sous 1 jour
-
help wanted severity: low testing
Difficulté 4/5 3-5 jours Accessibilité débutants 55/100
TMHSDigital/Home-Lab-Developer-Tools#164 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
Add AdGuard local DNS rewrite tools (list, add, delete)Peut-être pris @laozhej l’a pris il y a 1 jour. Ouverteenhancement severity: medium
Difficulté 3/5 1-2 jours Accessibilité débutants 72/100
TMHSDigital/Home-Lab-Developer-Tools#157 ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de TMHSDigital/Home-Lab-Developer-Tools
Issues similaires
-
[MCP]: page snapshots in .playwright-mcp/ are not git-ignored (.playwright-cli/ is, since #42318)Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 62/100
microsoft/playwright#44289 ·
Les mainteneurs répondent en général sous 1 jour
-
good first issue
Difficulté 2/5 Une demi-journée Accessibilité débutants 65/100
Les mainteneurs répondent en général sous 1 jour
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
blamechris/chroxy#9272 ·
Les mainteneurs répondent en général sous 1 jour
-
no-repo-link tool-submission
Difficulté 1/5 Moins d'une heure Accessibilité débutants 66/100
BraveOPotato/NoSignups#2458 ·
-
Difficulté 2/5 1-3 heures Accessibilité débutants 70/100
drmrd/vernacular#1061 ·
Les mainteneurs répondent en général sous 1 jour