feat(install)!: one setup command - hooks are the plugin's job, mcp-config prints only #231

Merged

hexajon merged 1 commit from issue-172-install-consolidation into main

2026-07-17 18:14:16 +00:00

hexajon commented

2026-07-17 18:14:00 +00:00

(Migrated from codeberg.org)

Summary

BREAKING (released surface): the binary hook-delivery channel is removed and all client wiring consolidates under madtea install. madtea install --hooks/mcp-config --hooks/--remove-hooks are gone along with the hook materialization and settings-merge machinery - the plugin (marketplace add + install) is the one way to get the guardrail hooks, and install prints that recommendation where the offer used to fire. mcp-config --install no longer wires anything for ANY client: it survives one release cycle as a hidden flag that always refuses with the replacement commands, and mcp-config becomes a pure snippet printer.

madtea install is the single setup command: the bare run keeps today's behavior (binary + completions + Claude Code MCP registration when detected, consent flags untouched); --skip-binary/--skip-completions/--skip-mcp re-run any single feature; the new --mcp-client codex|gemini|antigravity (repeatable/comma) wires the other agents through the same single implementations mcp-config previously used (exported Wire helpers - one implementation, two names gone). Explicitly-requested client wiring reports an aggregate nonzero error on partial failure; the best-effort bare-run registration stays best-effort. Docs consolidated accordingly, including a pre-existing wrong antigravity config path fixed to match the code.

Closes #172

## Summary BREAKING (released surface): the binary hook-delivery channel is removed and all client wiring consolidates under `madtea install`. `madtea install --hooks`/`mcp-config --hooks`/`--remove-hooks` are gone along with the hook materialization and settings-merge machinery - the plugin (marketplace add + install) is the one way to get the guardrail hooks, and install prints that recommendation where the offer used to fire. `mcp-config --install` no longer wires anything for ANY client: it survives one release cycle as a hidden flag that always refuses with the replacement commands, and mcp-config becomes a pure snippet printer. `madtea install` is the single setup command: the bare run keeps today's behavior (binary + completions + Claude Code MCP registration when detected, consent flags untouched); --skip-binary/--skip-completions/--skip-mcp re-run any single feature; the new --mcp-client codex|gemini|antigravity (repeatable/comma) wires the other agents through the same single implementations mcp-config previously used (exported Wire helpers - one implementation, two names gone). Explicitly-requested client wiring reports an aggregate nonzero error on partial failure; the best-effort bare-run registration stays best-effort. Docs consolidated accordingly, including a pre-existing wrong antigravity config path fixed to match the code. Closes #172