@fullchico/harness 0.0.0-stage → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +14 -0
- package/LICENSE +21 -0
- package/README.md +243 -2
- package/bin/harness.js +21 -0
- package/install +108 -0
- package/package.json +27 -4
- package/plugin/.claude-plugin/plugin.json +9 -0
- package/plugin/agents/implementador.md +55 -0
- package/plugin/agents/orquestrador.md +59 -0
- package/plugin/agents/qualidade.md +44 -0
- package/plugin/agents/revisor-ambiente.md +86 -0
- package/plugin/agents/revisor-bugs.md +153 -0
- package/plugin/agents/revisor-spec.md +49 -0
- package/plugin/agents/revisor.md +96 -0
- package/plugin/agents/seguranca.md +62 -0
- package/plugin/bin/sync +322 -0
- package/plugin/map.json +387 -0
- package/plugin/payload/agents-clean +77 -0
- package/plugin/payload/approve +34 -0
- package/plugin/payload/arch_check.py +94 -0
- package/plugin/payload/compose_check.py +186 -0
- package/plugin/payload/conf-apply +22 -0
- package/plugin/payload/destroy +21 -0
- package/plugin/payload/dev +24 -0
- package/plugin/payload/down +20 -0
- package/plugin/payload/entrega/despacho.md +186 -0
- package/plugin/payload/entrega/fechamento.md +179 -0
- package/plugin/payload/entrega/tickets.md +154 -0
- package/plugin/payload/env-common.sh +64 -0
- package/plugin/payload/fetch +10 -0
- package/plugin/payload/gate-check +159 -0
- package/plugin/payload/git-hooks/commit-msg +32 -0
- package/plugin/payload/git-hooks/pre-commit +19 -0
- package/plugin/payload/git-hooks/pre-push +15 -0
- package/plugin/payload/hooks/__pycache__/common.cpython-313.pyc +0 -0
- package/plugin/payload/hooks/__pycache__/gate_stamp.cpython-313.pyc +0 -0
- package/plugin/payload/hooks/common.py +274 -0
- package/plugin/payload/hooks/dispatch_guard.py +290 -0
- package/plugin/payload/hooks/gate_stamp.py +242 -0
- package/plugin/payload/hooks/managed_guard.py +95 -0
- package/plugin/payload/hooks/service_guard.py +178 -0
- package/plugin/payload/hooks/session_context.py +68 -0
- package/plugin/payload/hooks/subagent_context.py +49 -0
- package/plugin/payload/integrate +110 -0
- package/plugin/payload/learn +7 -0
- package/plugin/payload/learn.py +282 -0
- package/plugin/payload/manifest_check.py +68 -0
- package/plugin/payload/memory +7 -0
- package/plugin/payload/memory.py +521 -0
- package/plugin/payload/pendings +7 -0
- package/plugin/payload/ports-free +55 -0
- package/plugin/payload/pr +52 -0
- package/plugin/payload/prepare +10 -0
- package/plugin/payload/push +44 -0
- package/plugin/payload/setup-worktree +61 -0
- package/plugin/payload/skills-add +20 -0
- package/plugin/payload/skills-search +6 -0
- package/plugin/payload/skills-show +6 -0
- package/plugin/payload/skills_remote.py +111 -0
- package/plugin/payload/subagent-rules.md +14 -0
- package/plugin/payload/ticket +67 -0
- package/plugin/payload/tickets_check.py +206 -0
- package/plugin/payload/up +45 -0
- package/plugin/payload/update +45 -0
- package/plugin/payload/validate +90 -0
- package/plugin/payload/worktree-env +128 -0
- package/plugin/skills/aprender/SKILL.md +62 -0
- package/plugin/skills/buscar-skills/SKILL.md +73 -0
- package/plugin/skills/dream/SKILL.md +92 -0
- package/plugin/skills/entregar/SKILL.md +110 -0
- package/plugin/skills/entregar/references/spec.md +84 -0
- package/plugin/skills/mapear/SKILL.md +85 -0
- package/plugin/skills/setup/SKILL.md +66 -0
- package/plugin/templates/AGENTS.managed.md +173 -0
- package/plugin/templates/AGENTS.project.md +3 -0
- package/plugin/templates/CLAUDE.md +10 -0
- package/plugin/templates/conductor.toml +16 -0
- package/plugin/templates/docs/agents/domain.md +15 -0
- package/plugin/templates/docs/agents/issue-tracker.md +23 -0
- package/plugin/templates/docs/agents/stack.md +132 -0
- package/plugin/templates/harness.conf +61 -0
- package/plugin/templates/orca.yaml +10 -0
- package/plugin/templates/settings.json +210 -0
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
# Fatiar a spec em tickets
|
|
2
|
+
|
|
3
|
+
## Antes de fatiar
|
|
4
|
+
|
|
5
|
+
**O `harness.conf`.** Se o projeto ainda não tem `PROJECT` nele, grave agora, com o que a spec
|
|
6
|
+
diz: escreva o conteúdo em `.harness-run/harness.conf` e rode exatamente `.harness/conf-apply`,
|
|
7
|
+
sozinho, sem `&&` nem `;`. O comando confere a proposta e grava o arquivo, sem perguntar ao
|
|
8
|
+
dono. Faça o commit do `harness.conf`. É antes de fatiar porque `CONTRACT_PATHS` muda o que o
|
|
9
|
+
validador do grafo aceita.
|
|
10
|
+
|
|
11
|
+
**Entrega retomada.** Se a pasta `issues/` da spec já existe, não fatie de novo: valide o grafo
|
|
12
|
+
e continue da fronteira.
|
|
13
|
+
|
|
14
|
+
## O que é um ticket
|
|
15
|
+
|
|
16
|
+
Um ticket entrega um comportamento que funciona e se testa sozinho, dentro de uma pasta que é
|
|
17
|
+
só dele: um módulo do back, ou uma fatia do front. Não é uma camada técnica do sistema inteiro
|
|
18
|
+
("criar todas as tabelas", "fazer todas as telas").
|
|
19
|
+
|
|
20
|
+
- Cada ticket cabe numa sessão de um implementador.
|
|
21
|
+
- O primeiro ticket é o de contrato: o que front e back trocam, o que um módulo oferece a
|
|
22
|
+
outro (as portas entre módulos, com quem as implementa), o que é comum, as dependências, o
|
|
23
|
+
compose do ambiente e o que liga os módulos ao aplicativo. Antes de fechá-lo, confira a spec:
|
|
24
|
+
cada porta que um módulo consome está definida nele. Porta que falta aqui reabre este ticket
|
|
25
|
+
no meio da entrega. Ele bloqueia todos os outros e
|
|
26
|
+
não tem teste que dependa do ambiente, porque é ele que o traz.
|
|
27
|
+
- Quando a base é grande, divida-a em dois tickets, um bloqueando o outro: primeiro o
|
|
28
|
+
**contrato** (o que se troca e o que é comum: tipos, portas, convenções, esquema do banco),
|
|
29
|
+
depois a **fundação** (o que faz o projeto rodar: dependências, ambiente, ferramentas,
|
|
30
|
+
estrutura de testes, ligação dos módulos). Os dois possuem caminhos de `CONTRACT_PATHS`, e
|
|
31
|
+
todos os outros tickets esperam os dois. Um ticket só, com tudo, é o que mais volta da revisão.
|
|
32
|
+
- O ticket de contrato fixa também o que todos os módulos fazem igual, para não sair um de cada
|
|
33
|
+
jeito: a resposta para identificador inválido, para corpo malformado e para erro não
|
|
34
|
+
previsto; o formato do erro; como se ordena e se pagina. E toda constante de regra que back
|
|
35
|
+
e front usam (uma janela de dias, um tamanho de grade) fica nele, uma vez.
|
|
36
|
+
- O ticket de contrato também entrega as duas provas de que o resto pode confiar:
|
|
37
|
+
a checagem de fronteira (`VALIDATE_ARCH`), com um caso de teste que viola cada regra e
|
|
38
|
+
precisa ser recusado (a direção entre domínio, use case e adaptador, e as camadas do
|
|
39
|
+
front). A importação entre módulos do back não é com ela: o harness já recusa, por
|
|
40
|
+
`MODULE_ROOTS`, tudo que não for o próprio módulo, o que é comum, pacote, ou a entrada
|
|
41
|
+
pública (`index`) de outro módulo; e um teste de contrato, que falha se front e back divergirem em rota, método,
|
|
42
|
+
status ou formato. Entrega ainda um teste que sobe a aplicação inteira, com todos os módulos
|
|
43
|
+
ligados: é ele que acusa uma porta que não bate dos dois lados.
|
|
44
|
+
- Com o contrato fechado, o módulo do back e a fatia do front do mesmo recurso são tickets
|
|
45
|
+
separados e rodam juntos: cada lado testa contra o contrato.
|
|
46
|
+
- Os testes de navegador não esperam o fim. A base (o ticket de contrato, ou o de fundação)
|
|
47
|
+
entrega a configuração deles e um teste de fumaça: o aplicativo sobe e a página inicial
|
|
48
|
+
responde. Daí em diante cada ticket de tela entrega, na pasta dele, um teste de navegador
|
|
49
|
+
do caminho principal daquela tela.
|
|
50
|
+
- O último ticket é o de ponta a ponta: transforma os critérios de aceite da spec em testes que
|
|
51
|
+
atravessam várias telas e exercitam o sistema inteiro, numa pasta só dele, e é bloqueado
|
|
52
|
+
por todos os outros. Os testes
|
|
53
|
+
sobem o aplicativo sozinhos e entram só na checagem de merge (`VALIDATE_MERGE`), nunca na de
|
|
54
|
+
cada ticket. É ele
|
|
55
|
+
que protege o que já funciona quando alguém mexer em outra parte. O navegador roda num
|
|
56
|
+
contêiner do ambiente (o serviço entra no compose pelo ticket de contrato), porque dentro
|
|
57
|
+
do sandbox ele não abre; os testes se conectam a ele pelo endereço do `.env`.
|
|
58
|
+
- Dois tickets que não se bloqueiam serão feitos ao mesmo tempo. Se precisam do mesmo arquivo,
|
|
59
|
+
um bloqueia o outro.
|
|
60
|
+
|
|
61
|
+
## Formato
|
|
62
|
+
|
|
63
|
+
Um arquivo por ticket, em `docs/specs/<slug>/issues/<NN>-<nome>.md`, numerados a partir
|
|
64
|
+
de `01`. Nas primeiras linhas, `Status:`, `Blocked by:` e `Owns:`. Os valores de `Status` são
|
|
65
|
+
`open`, `claimed` e `done`. `Blocked by:` traz os números dos tickets que precisam estar
|
|
66
|
+
concluídos antes, separados por vírgula, ou fica vazio. `Owns:` traz as pastas ou arquivos
|
|
67
|
+
que são só deste ticket, separados por vírgula.
|
|
68
|
+
|
|
69
|
+
## Um dono por arquivo, contrato primeiro
|
|
70
|
+
|
|
71
|
+
Use a skill `parallel-feature-development` para decidir a posse. Nela, "team-lead" é você, e
|
|
72
|
+
os implementadores não trocam mensagens: quem precisa de algo que não é seu relata a lacuna.
|
|
73
|
+
|
|
74
|
+
- **Posse.** A unidade é o módulo no back e a fatia no front: uma pasta. Dois tickets que
|
|
75
|
+
podem rodar ao mesmo tempo nunca possuem o mesmo caminho. O validador recusa, e na
|
|
76
|
+
integração a branch que mexer fora da posse é recusada.
|
|
77
|
+
- **O que é comum tem um ticket só.** O contrato entre front e back, os tipos e regras usados
|
|
78
|
+
por mais de um módulo, as peças de interface de uso geral, os manifestos de dependência e o
|
|
79
|
+
schema do banco pertencem ao ticket de contrato (ou de fundação). É ele que adiciona
|
|
80
|
+
dependência nova. Com `CONTRACT_PATHS` no `harness.conf`, o validador exige que todos os
|
|
81
|
+
outros tickets esperem por ele.
|
|
82
|
+
- **Com o contrato fechado, back e front do mesmo recurso rodam juntos:** cada lado testa
|
|
83
|
+
contra o contrato, sem esperar o outro existir.
|
|
84
|
+
- **Nada de arquivo central editado por vários.** Cada módulo monta as próprias dependências
|
|
85
|
+
dentro da pasta dele. O que liga os módulos ao aplicativo, o índice geral e o schema único
|
|
86
|
+
são do ticket de contrato, ou então são descobertos por convenção.
|
|
87
|
+
- **Da skill, não use:** posse por camada, substituto escrito por um implementador para
|
|
88
|
+
destravar outro, e junção feita à mão. Aqui a posse é por pasta e quem junta é o
|
|
89
|
+
`.harness/integrate`.
|
|
90
|
+
|
|
91
|
+
```ticket 01-contrato-da-foto.md
|
|
92
|
+
# Contrato da troca de foto
|
|
93
|
+
|
|
94
|
+
Status: open
|
|
95
|
+
Blocked by:
|
|
96
|
+
Owns: packages/contracts, package.json, pnpm-lock.yaml, pnpm-workspace.yaml, docker-compose.dev.yml, apps/api/package.json, apps/api/src/main.ts, apps/api/src/shared, apps/web/package.json, apps/web/app, apps/web/src/shared
|
|
97
|
+
|
|
98
|
+
## O que entregar
|
|
99
|
+
|
|
100
|
+
Os tipos do envio de foto e da resposta, e os erros definidos na spec, no pacote que front e
|
|
101
|
+
back importam. Com ele vêm as dependências, o compose do ambiente e o que liga os módulos
|
|
102
|
+
ao aplicativo: tudo o que mais de um ticket usa.
|
|
103
|
+
|
|
104
|
+
## Como validar
|
|
105
|
+
|
|
106
|
+
A checagem de tipos passa nos dois lados.
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
```ticket 02-guardar-foto.md
|
|
110
|
+
# Guardar a foto enviada
|
|
111
|
+
|
|
112
|
+
Status: open
|
|
113
|
+
Blocked by: 01
|
|
114
|
+
Owns: apps/api/src/modules/files
|
|
115
|
+
|
|
116
|
+
## O que entregar
|
|
117
|
+
|
|
118
|
+
O envio de uma imagem válida grava o arquivo e devolve o endereço dele. Imagem maior que
|
|
119
|
+
o limite ou de tipo não aceito é recusada com o erro do contrato.
|
|
120
|
+
|
|
121
|
+
## Como validar
|
|
122
|
+
|
|
123
|
+
Pelo use case de guardar foto: uma imagem válida, uma grande demais e uma de tipo errado.
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
```ticket 03-mostrar-foto-no-perfil.md
|
|
127
|
+
# Mostrar a foto nova no perfil
|
|
128
|
+
|
|
129
|
+
Status: open
|
|
130
|
+
Blocked by: 01
|
|
131
|
+
Owns: apps/web/src/pages/profile
|
|
132
|
+
|
|
133
|
+
## O que entregar
|
|
134
|
+
|
|
135
|
+
Depois de trocar a foto, o perfil mostra a nova, sem recarregar a página.
|
|
136
|
+
|
|
137
|
+
## Como validar
|
|
138
|
+
|
|
139
|
+
Pela tela de perfil, com as respostas do contrato simuladas.
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
Os tickets 02 e 03 rodam juntos: possuem pastas diferentes e esperam só o contrato.
|
|
143
|
+
|
|
144
|
+
## Antes de seguir
|
|
145
|
+
|
|
146
|
+
```bash
|
|
147
|
+
python3 -I .harness/tickets_check.py docs/specs/<slug>
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
Tem de responder `ok: N tickets`. Ciclo, referência a ticket que não existe, cabeçalho
|
|
151
|
+
faltando, posse sobreposta entre tickets paralelos e ticket que não espera o contrato são
|
|
152
|
+
recusados, com o ticket apontado. Corrija e rode de novo.
|
|
153
|
+
|
|
154
|
+
Faça o commit: `docs(spec): slice <slug> into tickets`.
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# Trecho comum dos scripts de ambiente. Lido com `.`, não executado.
|
|
2
|
+
# Define HERE, ROOT e as funções abaixo. Não grava nada em .harness/.
|
|
3
|
+
#
|
|
4
|
+
# Todo Python chamado pelos scripts do harness usa `python3 -I` (modo isolado). Vários
|
|
5
|
+
# deles rodam fora do sandbox com a raiz do projeto como pasta atual, e sem o -I um
|
|
6
|
+
# json.py plantado ali pelo agente seria importado no lugar do módulo de verdade.
|
|
7
|
+
|
|
8
|
+
HERE="$(cd "$(dirname "$0")" && pwd -P)"
|
|
9
|
+
ROOT="$(cd "$HERE/.." && pwd -P)"
|
|
10
|
+
|
|
11
|
+
die() { echo "$(basename "$0"): $*" >&2; exit 1; }
|
|
12
|
+
|
|
13
|
+
conf_get() { # chave do harness.conf, vazio se não houver
|
|
14
|
+
python3 -I - "$HERE/hooks" "$ROOT/harness.conf" "$1" <<'PY'
|
|
15
|
+
import sys
|
|
16
|
+
sys.dont_write_bytecode = True
|
|
17
|
+
sys.path.insert(0, sys.argv[1])
|
|
18
|
+
import common
|
|
19
|
+
print(common.read_conf(sys.argv[2]).get(sys.argv[3], ""))
|
|
20
|
+
PY
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
env_get() { # chave do .env do worktree, vazio se não houver
|
|
24
|
+
[ -f "$ROOT/.env" ] || return 0
|
|
25
|
+
sed -n "s/^$1=//p" "$ROOT/.env" | sed -n 1p
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
load_env() { # exporta o .env do worktree para os comandos do projeto
|
|
29
|
+
[ -f "$ROOT/.env" ] || return 0
|
|
30
|
+
local line key
|
|
31
|
+
while IFS= read -r line || [ -n "$line" ]; do
|
|
32
|
+
case "$line" in ''|'#'*) continue ;; esac
|
|
33
|
+
key="${line%%=*}"
|
|
34
|
+
case "$key" in *[!A-Za-z0-9_]*|'') continue ;; esac
|
|
35
|
+
export "$key=${line#*=}"
|
|
36
|
+
done < "$ROOT/.env"
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
need_compose() { # confere o que os comandos de Docker precisam e define COMPOSE_FILE
|
|
40
|
+
COMPOSE_FILE="$(conf_get COMPOSE_FILE)"
|
|
41
|
+
[ -n "$COMPOSE_FILE" ] || die "falta COMPOSE_FILE no harness.conf (o arquivo de compose do ambiente de desenvolvimento)."
|
|
42
|
+
[ -f "$ROOT/$COMPOSE_FILE" ] || die "o arquivo de compose $COMPOSE_FILE não existe neste worktree."
|
|
43
|
+
command -v docker >/dev/null 2>&1 || die "docker não encontrado no PATH. Instale ou inicie o Docker."
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
compose() { # docker compose do projeto desta feature
|
|
47
|
+
docker compose --env-file "$ROOT/.env" -p "$(env_get COMPOSE_PROJECT_NAME)" -f "$ROOT/$COMPOSE_FILE" "$@"
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
env_record() { # arquivo que registra o dono do ambiente desta feature
|
|
51
|
+
local state
|
|
52
|
+
state="$(cd "$ROOT" && python3 -I "$HERE/hooks/common.py" state-dir)" || die "não achei o estado do harness."
|
|
53
|
+
echo "$state/envs/$(env_get HARNESS_ENV_CONTEXT).json"
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
dev_pid() { # PID do app em segundo plano, se ainda estiver vivo
|
|
57
|
+
local pid
|
|
58
|
+
[ -f "$ROOT/.harness-run/dev.pid" ] || return 1
|
|
59
|
+
pid="$(cat "$ROOT/.harness-run/dev.pid")"
|
|
60
|
+
# Só número positivo: `kill -1` alcançaria todos os processos do usuário.
|
|
61
|
+
case "$pid" in ""|0|*[!0-9]*) return 1 ;; esac
|
|
62
|
+
[ -n "$pid" ] && kill -0 "$pid" 2>/dev/null || return 1
|
|
63
|
+
echo "$pid"
|
|
64
|
+
}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Atualiza as referências do remoto. Dentro do sandbox a rede para o servidor de git
|
|
3
|
+
# é negada; este script roda fora dele. Depois, merge ou rebase são comandos comuns.
|
|
4
|
+
set -uo pipefail
|
|
5
|
+
. "$(dirname "$0")/env-common.sh"
|
|
6
|
+
for VAR in $(env | sed -n 's/^\(GIT_[A-Za-z0-9_]*\)=.*/\1/p'); do unset "$VAR"; done
|
|
7
|
+
|
|
8
|
+
[ "$#" -eq 0 ] || { echo "uso: fetch" >&2; exit 2; }
|
|
9
|
+
cd "$ROOT" || exit 1
|
|
10
|
+
git fetch --prune origin || die "não consegui buscar do remoto origin."
|
|
@@ -0,0 +1,159 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# O portão de push: quatro vereditos sobre o commit do topo (segurança, revisão, caça a bugs, qualidade) e a trava de spec.
|
|
3
|
+
#
|
|
4
|
+
# Uso: gate-check <url do remoto> com as linhas de ref no stdin, no formato do git:
|
|
5
|
+
# <ref local> <sha local> <ref remoto> <sha remoto>
|
|
6
|
+
# Sai 0 se tudo o que vai ser enviado está aprovado; sai 1 com os motivos em stderr.
|
|
7
|
+
#
|
|
8
|
+
# Chamado por .harness/push, que é o caminho do agente até o remoto, e pelo hook
|
|
9
|
+
# pre-push, que cobre o push feito à mão pelo dono. Não executa código do projeto.
|
|
10
|
+
#
|
|
11
|
+
# O que a branch acrescenta é medido contra o remoto de verdade, consultado agora,
|
|
12
|
+
# e não contra as referências locais, que qualquer comando consegue mover.
|
|
13
|
+
set -uo pipefail
|
|
14
|
+
|
|
15
|
+
REMOTE_URL="${1:-}"
|
|
16
|
+
H="$(cd "$(dirname "$0")" && pwd -P)"
|
|
17
|
+
STATE="$(python3 -I "$H/hooks/common.py" state-dir)" || { echo "push negado: não achei o estado do harness." >&2; exit 1; }
|
|
18
|
+
ZERO=0000000000000000000000000000000000000000
|
|
19
|
+
SPEC_GLOB='docs/specs/*/spec.md'
|
|
20
|
+
[ -f "$H/map.env" ] && . "$H/map.env"
|
|
21
|
+
|
|
22
|
+
if [ -z "$REMOTE_URL" ]; then
|
|
23
|
+
# Projeto sem remoto: a base é a branch padrão local, a mesma que os revisores usaram.
|
|
24
|
+
LOCAL_BASE="$(python3 -I "$H/hooks/common.py" branch-base "$(git rev-parse HEAD)" 2>/dev/null)" || LOCAL_BASE=""
|
|
25
|
+
LS="${LOCAL_BASE:+$LOCAL_BASE HEAD}"
|
|
26
|
+
elif ! LS="$(git ls-remote --symref "$REMOTE_URL" HEAD 'refs/heads/*' 2>/dev/null)"; then
|
|
27
|
+
echo "push negado: não consegui consultar o remoto ($REMOTE_URL) para medir o que a branch acrescenta." >&2
|
|
28
|
+
exit 1
|
|
29
|
+
fi
|
|
30
|
+
# Commit para o qual o HEAD do remoto aponta (vazio em remoto recém-criado) e os topos das branches de lá.
|
|
31
|
+
REMOTE_HEAD="$(awk '$2 == "HEAD" && $1 != "ref:" { sha = $1 } END { print sha }' <<EOT
|
|
32
|
+
$LS
|
|
33
|
+
EOT
|
|
34
|
+
)"
|
|
35
|
+
REMOTE_TIPS="$(awk '$1 != "ref:" && $2 ~ /^refs\/heads\// { print $1 }' <<EOT
|
|
36
|
+
$LS
|
|
37
|
+
EOT
|
|
38
|
+
)"
|
|
39
|
+
|
|
40
|
+
approved() { # portão, sha, base
|
|
41
|
+
local file="$STATE/approvals/$1/$2.json"
|
|
42
|
+
[ -f "$file" ] || return 1
|
|
43
|
+
python3 -I - "$file" "$1" "$2" "$3" <<'PY'
|
|
44
|
+
import json, sys
|
|
45
|
+
try:
|
|
46
|
+
with open(sys.argv[1], encoding="utf-8") as f:
|
|
47
|
+
d = json.load(f)
|
|
48
|
+
except (OSError, ValueError):
|
|
49
|
+
sys.exit(1)
|
|
50
|
+
ok = d.get("status") == "PASS" and d.get("gate") == sys.argv[2] and d.get("sha") == sys.argv[3]
|
|
51
|
+
# A aprovação de um revisor vale para o intervalo que ele leu: a base tem de ser a
|
|
52
|
+
# mesma que o remoto informa. O carimbo do dono vale para o commit.
|
|
53
|
+
# Remoto ainda sem nenhum commit: não há base de lá para comparar, e o que sobe é o histórico inteiro.
|
|
54
|
+
ok = ok and (d.get("by") == "owner" or not sys.argv[4] or (d.get("base") and d.get("base") == sys.argv[4]))
|
|
55
|
+
sys.exit(0 if ok else 1)
|
|
56
|
+
PY
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
on_remote() { # o commit já faz parte de alguma branch do remoto?
|
|
60
|
+
local tip
|
|
61
|
+
while IFS= read -r tip; do
|
|
62
|
+
[ -n "$tip" ] || continue
|
|
63
|
+
git merge-base --is-ancestor "$1" "$tip" 2>/dev/null && return 0
|
|
64
|
+
done <<EOT
|
|
65
|
+
$REMOTE_TIPS
|
|
66
|
+
EOT
|
|
67
|
+
return 1
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
FAIL=0
|
|
71
|
+
while read -r LOCAL_REF LOCAL_SHA REMOTE_REF REMOTE_SHA; do
|
|
72
|
+
[ -n "${LOCAL_SHA:-}" ] || continue
|
|
73
|
+
[ "$LOCAL_SHA" = "$ZERO" ] && continue
|
|
74
|
+
# Tag anotada aponta para um objeto de tag: o que se revisa é o commit dela.
|
|
75
|
+
TIP="$(git rev-parse -q --verify "$LOCAL_SHA^{commit}" 2>/dev/null)" || continue
|
|
76
|
+
|
|
77
|
+
# Tag passa sem revisão só quando o commit já está numa branch do remoto (release
|
|
78
|
+
# de algo mesclado). Tag sobre commit novo é um push de código como outro qualquer.
|
|
79
|
+
case "$LOCAL_REF" in
|
|
80
|
+
refs/tags/*) on_remote "$TIP" && continue ;;
|
|
81
|
+
esac
|
|
82
|
+
|
|
83
|
+
BASE=""
|
|
84
|
+
if [ -n "$REMOTE_HEAD" ]; then
|
|
85
|
+
if ! git cat-file -e "$REMOTE_HEAD^{commit}" 2>/dev/null; then
|
|
86
|
+
echo "push negado: a branch padrão do remoto andou e este clone ainda não baixou os commits novos. Rode .harness/fetch e envie de novo; as aprovações continuam valendo." >&2
|
|
87
|
+
FAIL=1
|
|
88
|
+
continue
|
|
89
|
+
fi
|
|
90
|
+
if ! BASE="$(git merge-base "$TIP" "$REMOTE_HEAD" 2>/dev/null)" || [ -z "$BASE" ]; then
|
|
91
|
+
echo "push negado: esta branch não tem histórico em comum com a branch padrão do remoto." >&2
|
|
92
|
+
FAIL=1
|
|
93
|
+
continue
|
|
94
|
+
fi
|
|
95
|
+
fi
|
|
96
|
+
|
|
97
|
+
for GATE in seguranca revisao; do
|
|
98
|
+
if ! approved "$GATE" "$TIP" "$BASE"; then
|
|
99
|
+
echo "push negado: falta a aprovação de $GATE para o commit $TIP." >&2
|
|
100
|
+
echo " Ela nasce do veredito do revisor sobre a branch inteira, desde a branch padrão do remoto;" >&2
|
|
101
|
+
echo " commit novo, ou revisão de só uma parte, pede revisão nova." >&2
|
|
102
|
+
FAIL=1
|
|
103
|
+
fi
|
|
104
|
+
done
|
|
105
|
+
# A caça a bugs final: o passe entre módulos sobre a branch inteira, nesse commit.
|
|
106
|
+
if ! approved bugs "$TIP" ""; then
|
|
107
|
+
echo "push negado: falta a aprovação de bugs para o commit $TIP." >&2
|
|
108
|
+
echo " Ela nasce do veredito do agente harness:revisor-bugs sobre a branch inteira, nesse commit." >&2
|
|
109
|
+
FAIL=1
|
|
110
|
+
fi
|
|
111
|
+
# A qualidade é do commit, não de um intervalo: a checagem completa do projeto rodou nele.
|
|
112
|
+
if ! approved qualidade "$TIP" ""; then
|
|
113
|
+
echo "push negado: falta a aprovação de qualidade para o commit $TIP." >&2
|
|
114
|
+
echo " Ela nasce do veredito do agente harness:qualidade, que roda a checagem completa do projeto" >&2
|
|
115
|
+
echo " (testes, fronteiras, ponta a ponta) nesse commit. Commit novo pede checagem nova." >&2
|
|
116
|
+
FAIL=1
|
|
117
|
+
fi
|
|
118
|
+
|
|
119
|
+
if [ -n "$BASE" ]; then
|
|
120
|
+
SUBJECTS="$(git log --format=%s "$BASE..$TIP")"
|
|
121
|
+
# Só o que a branch acrescenta ou altera: apagar uma spec não é trazer uma.
|
|
122
|
+
NAMES="$(git diff --name-only --diff-filter=AM "$BASE" "$TIP")"
|
|
123
|
+
else
|
|
124
|
+
SUBJECTS="$(git log --format=%s "$TIP")"
|
|
125
|
+
NAMES="$(git ls-tree -r --name-only "$TIP")"
|
|
126
|
+
fi
|
|
127
|
+
# Sem pipe para o grep -q: com pipefail, o grep sair cedo derruba o comando
|
|
128
|
+
# anterior e a trava deixaria de valer de forma intermitente.
|
|
129
|
+
if grep -Eq '^feat(\(.+\))?!?:' <<EOT
|
|
130
|
+
$SUBJECTS
|
|
131
|
+
EOT
|
|
132
|
+
then
|
|
133
|
+
FOUND=0
|
|
134
|
+
while IFS= read -r NAME; do
|
|
135
|
+
# shellcheck disable=SC2254
|
|
136
|
+
case "$NAME" in $SPEC_GLOB) FOUND=1 ;; esac
|
|
137
|
+
done <<EOT
|
|
138
|
+
$NAMES
|
|
139
|
+
EOT
|
|
140
|
+
if [ "$FOUND" -eq 0 ]; then
|
|
141
|
+
echo "push negado: a branch tem commit feat e nenhuma spec em $SPEC_GLOB." >&2
|
|
142
|
+
echo " Toda feat entra com a spec da mudança no mesmo conjunto de commits." >&2
|
|
143
|
+
FAIL=1
|
|
144
|
+
fi
|
|
145
|
+
fi
|
|
146
|
+
done
|
|
147
|
+
|
|
148
|
+
# Achado simples não bloqueou o ticket; em troca, não sai sem ser conferido.
|
|
149
|
+
OPEN="$(python3 -I "$H/hooks/common.py" pendings 2>/dev/null)"
|
|
150
|
+
if [ -n "$OPEN" ]; then
|
|
151
|
+
echo "push negado: há pendências do caçador de bugs que ninguém conferiu:" >&2
|
|
152
|
+
echo "$OPEN" | sed 's/^/ /' >&2
|
|
153
|
+
echo " Corrija cada uma com o teste indicado e peça o passe final ao harness:revisor-bugs:" >&2
|
|
154
|
+
echo " é ele que fecha, com a linha RESOLVIDA: <id>." >&2
|
|
155
|
+
FAIL=1
|
|
156
|
+
fi
|
|
157
|
+
|
|
158
|
+
[ "$FAIL" -eq 0 ] || exit 1
|
|
159
|
+
exit 0
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Formato do commit: `tipo(escopo): descrição`, até 80 caracteres, sem assinatura de IA.
|
|
3
|
+
set -uo pipefail
|
|
4
|
+
|
|
5
|
+
FILE="${1:-}"
|
|
6
|
+
[ -f "$FILE" ] || { echo "commit-msg: arquivo da mensagem ausente" >&2; exit 1; }
|
|
7
|
+
|
|
8
|
+
FIRST="$(grep -v '^#' "$FILE" | sed -n 1p || true)"
|
|
9
|
+
|
|
10
|
+
case "$FIRST" in
|
|
11
|
+
"Merge "*|"Revert "*) exit 0 ;;
|
|
12
|
+
esac
|
|
13
|
+
|
|
14
|
+
PATTERN='^(feat|fix|chore|docs|refactor|test)(\([a-z0-9._/-]+\))?!?: .+'
|
|
15
|
+
if ! [[ "$FIRST" =~ $PATTERN ]]; then
|
|
16
|
+
echo "commit recusado: o assunto precisa seguir tipo(escopo): descrição" >&2
|
|
17
|
+
echo " tipos: feat, fix, chore, docs, refactor, test. Exemplo: fix(api): keep notes multiline" >&2
|
|
18
|
+
exit 1
|
|
19
|
+
fi
|
|
20
|
+
if [ "${#FIRST}" -gt 80 ]; then
|
|
21
|
+
echo "commit recusado: assunto com ${#FIRST} caracteres; o limite é 80. O contexto vai no corpo." >&2
|
|
22
|
+
exit 1
|
|
23
|
+
fi
|
|
24
|
+
BODY="$(grep -v '^#' "$FILE" || true)"
|
|
25
|
+
if grep -Eiq '^co-authored-by:.*(claude|anthropic|openai|gpt|codex|copilot|gemini)|^[^[:alnum:]]*generated with|🤖' <<EOT
|
|
26
|
+
$BODY
|
|
27
|
+
EOT
|
|
28
|
+
then
|
|
29
|
+
echo "commit recusado: sem co-autoria nem assinatura de IA. A autoria é de quem está no git config." >&2
|
|
30
|
+
exit 1
|
|
31
|
+
fi
|
|
32
|
+
exit 0
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Um ticket só passa a `Status: done` num commit em que a checagem do projeto passa.
|
|
3
|
+
# Fechar ticket sem ter visto os testes rodarem deixa de ser possível por descuido.
|
|
4
|
+
set -uo pipefail
|
|
5
|
+
|
|
6
|
+
ROOT="$(git rev-parse --show-toplevel)"
|
|
7
|
+
H="$ROOT/.harness"
|
|
8
|
+
TICKETS_GLOB='docs/specs/*/issues/*.md'
|
|
9
|
+
[ -f "$H/map.env" ] && . "$H/map.env"
|
|
10
|
+
|
|
11
|
+
git diff --cached -U0 -- "$TICKETS_GLOB" | grep -q '^+Status: done' || exit 0
|
|
12
|
+
|
|
13
|
+
echo "Este commit fecha um ticket (Status: done): rodando a checagem do projeto."
|
|
14
|
+
if ! "$H/validate" --profile push </dev/null; then
|
|
15
|
+
echo "commit recusado: um ticket só vira Status: done com a checagem do projeto passando." >&2
|
|
16
|
+
echo " Corrija o que falhou. Se o ambiente da feature não responde, não feche o ticket: relate." >&2
|
|
17
|
+
exit 1
|
|
18
|
+
fi
|
|
19
|
+
exit 0
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Hook de git para o push feito à mão, no terminal. O agente não chega ao remoto por
|
|
3
|
+
# aqui: dentro do sandbox a rede para o servidor de git é negada, e o caminho dele é
|
|
4
|
+
# .harness/push. Este hook existe para o dono passar pelo mesmo portão.
|
|
5
|
+
set -uo pipefail
|
|
6
|
+
|
|
7
|
+
ROOT="$(git rev-parse --show-toplevel)"
|
|
8
|
+
H="$ROOT/.harness"
|
|
9
|
+
|
|
10
|
+
"$H/gate-check" "${2:-${1:-}}" || exit 1
|
|
11
|
+
"$H/validate" --profile push </dev/null || {
|
|
12
|
+
echo "push negado: .harness/validate --profile push falhou." >&2
|
|
13
|
+
exit 1
|
|
14
|
+
}
|
|
15
|
+
exit 0
|
|
Binary file
|
|
Binary file
|