Edição de Patch

Spec §20.3 / §21.3.2: code-migration / tune-collab não pode enviar um diff confiável quando o agente reescreve arquivos inteiros em uma única passada — o revisor não consegue auditar a mudança. Este átomo impõe "um passo por vez, a menor edição localizada possível".

Entradas

• plan/steps.json de rewrite-plan.
• O valor atual de iterations (o contador por estágio do daemon).
• code/index.json para as importações conhecidas + vizinhos do arquivo.

Saída

O átomo muta arquivos dentro do diretório de trabalho do projeto via a ferramenta file-edit. Após cada iteração, ele escreve um recibo por passo:

project-cwd/
└── plan/
    ├── steps.json (status updated: 'pending' → 'completed' | 'skipped')
    └── receipts/
        └── step-<id>.json    # { files: ['...'], diffSummary, rationale, completedAt }

Convergência

O átomo é concluído quando cada passo em plan/steps.json está em um estado terminal (completed / skipped) OU iterations >= OD_MAX_DEVLOOP_ITERATIONS. Uso:

{
  "id": "patch-edit-loop",
  "atoms": ["patch-edit"],
  "repeat": true,
  "until": "plan.steps.terminal === plan.steps.total || iterations >= 8"
}

Antí-padrões que o fragmento de prompt proíbe

• Reescrever um arquivo inteiro quando o passo de plano de reescrita é localizado.
• Tocar em um arquivo fora do files[] do passo.
• Tocar em um arquivo de nível shell quando o risk do passo não é 'high' ou o usuário não confirmou.
• Pular um passo sem um recibo + uma string de justificativa.

Status

Implementado pelo executor do daemon em apps/daemon/src/plugins/atoms/patch-edit.ts. Ele valida a propriedade e o risco do passo, aplica diffs unificados com escritas atômicas e registra recibos e progresso.