Instantly reset Git history to a single fresh commit.
Single tool 'nuke_history' has a basic description but critically lacks parameter descriptions and proper schema documentation. The input schema shows only a 'message' parameter with type and description, but no output schema is documented. The tool performs a destructive operation (rewrites git history) with no confirmation mechanism, error recovery guidance, or idempotency guarantees. No tool annotations (destructiveHint) despite being explicitly marked as DESTRUCTIVE. Naming is verb-based but generic; description is 95 chars (within range but minimal). This server would not pass production code review.
Core programmatic API. Returns a structured dictionary for AIs/MCP servers.
No output schema documented. Tool returns a dict with 'success', 'error', 'branch', 'root_commit' fields, but LLM has no way to know what to expect or how to chain downstream calls.
Destructive operation lacks confirmation mechanism. Tool rewrites entire git history irreversibly with no dry-run, preview, or multi-step confirmation. Agents will invoke this without understanding consequences.
No tool annotations. Tool is marked DESTRUCTIVE but has no destructiveHint annotation in schema. LLMs cannot detect risk level from metadata.
Error handling provides no recovery guidance. Generic exception messages ('error': str(e)) give LLM no actionable next steps. E.g., 'Not a git repository' should suggest checking pwd or initializing git.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 36 | 2026-07-28+ | v2 |
Parameter 'message' description is minimal (47 chars). Does not explain format constraints, defaults, or what happens if omitted. LLM cannot infer whether empty string is valid or if special characters are allowed.