docs: imp doctor, imp fix e o manifest do harness no DOCS/README

[elberrd]

Fecha a documentação do que entrou hoje (PRs #21, #22, #23, #24). O código já estava na main; faltava o DOCS/README acompanharem — imp doctor e imp fix existiam só como duas linhas gigantes dentro da tabela do launcher (§14.3), e o imp/.harness-manifest.json não aparecia na seção do harness.

DOCS.md

• §14 vira a escada de manutenção: tabela "a pergunta → o comando" (doctor → fix → --update-runtime → --verify → imp update) e a regra que separa as duas metades — doctor nunca escreve, fix nunca sobrescreve. Título e âncora do índice atualizados.
• §14.4 imp doctor (nova): as 4 seções (engines/subscriptions informativas por decisão, CLIs core, Pi & imp, projeto), o timebox de 4 s do probe de update, a higiene do .mcp.json e a classificação pristine/modified/missing do stamp. Contrato de exit code.
• §14.5 imp fix (nova): o contrato restore-only, o gate do git como undo, o comportamento sem TTY, e a tabela dos 7 fixes (pi-packages, mcp-npx-yes, skills-missing, pi-skill-dupes, runtime-missing, harness-missing, agents-md-block) com o tier de cada um.
• §14.3: as duas linhas quilométricas viram ponteiros para §14.4/§14.5.
• §8 (harness): entra o manifest do stamp — como é construído a partir do clone adaptado (README já virou imp/HARNESS.md, AGENTS.md removido para o merge por marker, template-owned paths descartados), link:<target> para symlink, e por que um arquivo que o merge MANTEVE grava o sha do harness de propósito (é o que impede o imp fix de sobrescrever a versão do aluno). Também o motivo do -y nos MCP via npx: com cache frio o "Ok to proceed?" cai no stdio do MCP e o servidor morre antes do handshake ("Connection closed").
• §19: harness-manifest na lista do src/lib/.

README.md

• Nova seção "Something not working? — the maintenance ladder" com os 4 passos e a explicação do que o fix restaura vs. o que ele só reporta.
• O aviso de alpha agora aponta para o imp doctor como forma de saber quando um projeto ficou para trás.

Verificação

• npm test → 746 passando, 0 falhas.
• npm run lint → limpo.
• Só documentação: nenhum arquivo de código tocado (DOCS.md +136/−3, README.md +20/−1).

🤖 Generated with Claude Code