convez.ai
MCP ServerDesenvolvimento WebAvançado
hiniachi

Meta-Edit MCP Server

hiniachi/meta-edit

21 ferramentas de edição especializadas com obrigações de teste embutidas

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que substitui uma única ferramenta genérica `Edit` por vinte e uma ferramentas especializadas, cada uma codificando obrigações de teste em sua descrição. Cada ferramenta exige campos de `target` (prod/test), `provenance` (fonte epistêmica da mudança) e `execution_state` (contexto da sessão), criando um audit log completo de edições com rastreabilidade e certeza.

Instalação

$npx convez-ai hiniachi/meta-edit

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
100%
Último commit
há 1 mês
Versão
v0.9.2
Issues abertas
5
Contribuidores
4

Casos de uso

  • Agentes de IA com rigor de teste automático em edições de código
  • Auditoria completa de mudanças com proveniência e contexto de execução
  • Categorização forçada de tipos de edição (cosmética, boundary, estado, API, etc) antes da ação

Veredito

Abordagem sofisticada que traduz disciplina de qualidade (estilo SQLite) para camada de schema de ferramentas. Ideal para pipelines onde agentes precisam rastreabilidade epistêmica e obrigações de teste forçadas no momento da invocação — não é para casos simples de edição.

README

A tradução para o português deste README ainda está na fila.

meta-edit

License: MIT CI GitHub stars Buy Me a Coffee

Languages: English · 日本語 · 简体中文

An MCP server that replaces a coding agent's single Edit tool with twenty-one kind-specific edit tools. Each tool carries — in its own description — the testing obligations for that kind of change. The 16 impl tools additionally carry a required target: "prod" | "test" flag so test edits are visible inside their kind's audit surface. Every declaration also carries a required provenance field (the epistemic source of the edit: user_confirmed / accepted_artifact / direct_observation / inference / speculation) and a required execution_state field (normal / repeating_failure / recovery) so the audit log captures both the certainty and the session context of every edit.

For the long-form explanation, with applications beyond editing, see the project page.

The idea

CLAUDE.md, Skills, system prompts, and review checklists are all texts the model might re-read. They drift out of attention as the conversation grows. By the time the agent calls Edit, those instructions have effectively expired.

One surface is different. The schema and description of the tool the agent is about to call are loaded at every invocation, immediately before the call. They are the only place where an instruction is guaranteed to be in front of the model at the moment of action.

meta-edit puts obligations there. A single generic Edit is too coarse — you cannot write "produce a boundary test when changing < to <=" on it without also misfiring on a typo fix. So we split: Edit becomes twenty-one edits, one per kind of change. The agent must pick a kind before it can edit. Picking the kind is the reasoning step.

The conceptual ancestor is SQLite's testing strategy — boundary values, MC/DC condition coverage, anomaly testing, per-change checklists — translated from C-library quality discipline into application-level edit categories.

The twenty-one tools

edit_cosmetic                 edit_boundary_condition
edit_boolean_condition        edit_state_transition
edit_db_schema                edit_data_migration
edit_api_contract             edit_serialization
edit_error_handling           edit_retry_timeout
edit_concurrency              edit_external_side_effect
edit_cache_invalidation       edit_permission_logic
edit_dependency_config        edit_policy_change
edit_progress
edit_observation
edit_proposal
edit_decision
edit_explanation

Each description specifies: when to use it, when not to use it, which tests must accompany the edit, and when to stop and ask the user. The 16 impl tools (everything except the 5 workflow-axis kinds) carry a required target: "prod" | "test" flag — prod/test pairs land as two declarations of the same tool, both in the same commit.

v0.5.0: the previous edit_test_only_change and edit_refactor_only slots are gone. Test edits flow through the kind-specific impl tool with target: "test". edit_cosmetic replaces edit_refactor_only with a much narrower vocabulary (whitespace / comments / formatter output only); renames, extracts, and dead-code removal route to stop-and-ask instead of a generic refactor catch-all.

What we've observed

When no kind cleanly fits a requested change, the agent stops and asks instead of forcing the change through the nearest tool. We have observed this at ~80% context utilisation — exactly the regime where CLAUDE.md normally loses its grip. The transcript that led to the workflow tool The 5 workflow-axis kinds (edit_progress / edit_observation / edit_proposal / edit_decision / edit_explanation) are on the project page.

Install

Claude Code plugin marketplace

This repo is a single-plugin marketplace.

/plugin marketplace add hiniachi/meta-edit
/plugin install meta-edit@meta-edit

That auto-registers the MCP server (twenty-one edit_* tools) and the two safety hooks (deny-raw-edit, deny-bash-write-bypass). The plugin runs prebuilt JavaScript shipped under dist/; Node 20+ is the only runtime requirement — no Bun, no npm install, no build step.

To pull a newer marketplace version after a release:

git -C ~/.claude/plugins/marketplaces/meta-edit pull origin main
rm -rf ~/.claude/plugins/cache/meta-edit
/plugin install meta-edit@meta-edit
/reload-plugins

npm

npm install -g @hiniachi/meta-edit
meta-edit install-hooks --scope user

Then register the server in your MCP configuration:

{
  "mcpServers": {
    "meta-edit": { "command": "meta-edit", "args": ["serve"] }
  }
}

opencode

npm install -g @hiniachi/meta-edit
meta-edit install-opencode --scope user

Writes the MCP server and the @hiniachi/meta-edit/opencode plugin into opencode.json. Reference snippet: examples/.opencode/opencode.json. Same twenty-one tool descriptions, same audit log, same grant flow as the Claude Code path.

Reference

Full spec (the twenty-one descriptions, declaration + token binding, the protocol)docs/SPEC.md
Edit log schema (issued / consumed / rejected records)docs/SPEC.md §6
Observed failure modes (the v0.2+ backlog)OBSERVED-FAILURES.md
CI sample (run meta-edit summary on PR)examples/.github/workflows/meta-edit-summary.yml
CLI referencemeta-edit --help

Status: 0.3.1 pre-release. Node 20 LTS+, POSIX shell. Bun is dev-only.

Support

Buy Me a Coffee

License

MIT. See LICENSE.

Ver o original no GitHub

Bom para

Relacionados