@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.
Files changed (83) hide show
  1. package/.claude-plugin/marketplace.json +14 -0
  2. package/LICENSE +21 -0
  3. package/README.md +243 -2
  4. package/bin/harness.js +21 -0
  5. package/install +108 -0
  6. package/package.json +27 -4
  7. package/plugin/.claude-plugin/plugin.json +9 -0
  8. package/plugin/agents/implementador.md +55 -0
  9. package/plugin/agents/orquestrador.md +59 -0
  10. package/plugin/agents/qualidade.md +44 -0
  11. package/plugin/agents/revisor-ambiente.md +86 -0
  12. package/plugin/agents/revisor-bugs.md +153 -0
  13. package/plugin/agents/revisor-spec.md +49 -0
  14. package/plugin/agents/revisor.md +96 -0
  15. package/plugin/agents/seguranca.md +62 -0
  16. package/plugin/bin/sync +322 -0
  17. package/plugin/map.json +387 -0
  18. package/plugin/payload/agents-clean +77 -0
  19. package/plugin/payload/approve +34 -0
  20. package/plugin/payload/arch_check.py +94 -0
  21. package/plugin/payload/compose_check.py +186 -0
  22. package/plugin/payload/conf-apply +22 -0
  23. package/plugin/payload/destroy +21 -0
  24. package/plugin/payload/dev +24 -0
  25. package/plugin/payload/down +20 -0
  26. package/plugin/payload/entrega/despacho.md +186 -0
  27. package/plugin/payload/entrega/fechamento.md +179 -0
  28. package/plugin/payload/entrega/tickets.md +154 -0
  29. package/plugin/payload/env-common.sh +64 -0
  30. package/plugin/payload/fetch +10 -0
  31. package/plugin/payload/gate-check +159 -0
  32. package/plugin/payload/git-hooks/commit-msg +32 -0
  33. package/plugin/payload/git-hooks/pre-commit +19 -0
  34. package/plugin/payload/git-hooks/pre-push +15 -0
  35. package/plugin/payload/hooks/__pycache__/common.cpython-313.pyc +0 -0
  36. package/plugin/payload/hooks/__pycache__/gate_stamp.cpython-313.pyc +0 -0
  37. package/plugin/payload/hooks/common.py +274 -0
  38. package/plugin/payload/hooks/dispatch_guard.py +290 -0
  39. package/plugin/payload/hooks/gate_stamp.py +242 -0
  40. package/plugin/payload/hooks/managed_guard.py +95 -0
  41. package/plugin/payload/hooks/service_guard.py +178 -0
  42. package/plugin/payload/hooks/session_context.py +68 -0
  43. package/plugin/payload/hooks/subagent_context.py +49 -0
  44. package/plugin/payload/integrate +110 -0
  45. package/plugin/payload/learn +7 -0
  46. package/plugin/payload/learn.py +282 -0
  47. package/plugin/payload/manifest_check.py +68 -0
  48. package/plugin/payload/memory +7 -0
  49. package/plugin/payload/memory.py +521 -0
  50. package/plugin/payload/pendings +7 -0
  51. package/plugin/payload/ports-free +55 -0
  52. package/plugin/payload/pr +52 -0
  53. package/plugin/payload/prepare +10 -0
  54. package/plugin/payload/push +44 -0
  55. package/plugin/payload/setup-worktree +61 -0
  56. package/plugin/payload/skills-add +20 -0
  57. package/plugin/payload/skills-search +6 -0
  58. package/plugin/payload/skills-show +6 -0
  59. package/plugin/payload/skills_remote.py +111 -0
  60. package/plugin/payload/subagent-rules.md +14 -0
  61. package/plugin/payload/ticket +67 -0
  62. package/plugin/payload/tickets_check.py +206 -0
  63. package/plugin/payload/up +45 -0
  64. package/plugin/payload/update +45 -0
  65. package/plugin/payload/validate +90 -0
  66. package/plugin/payload/worktree-env +128 -0
  67. package/plugin/skills/aprender/SKILL.md +62 -0
  68. package/plugin/skills/buscar-skills/SKILL.md +73 -0
  69. package/plugin/skills/dream/SKILL.md +92 -0
  70. package/plugin/skills/entregar/SKILL.md +110 -0
  71. package/plugin/skills/entregar/references/spec.md +84 -0
  72. package/plugin/skills/mapear/SKILL.md +85 -0
  73. package/plugin/skills/setup/SKILL.md +66 -0
  74. package/plugin/templates/AGENTS.managed.md +173 -0
  75. package/plugin/templates/AGENTS.project.md +3 -0
  76. package/plugin/templates/CLAUDE.md +10 -0
  77. package/plugin/templates/conductor.toml +16 -0
  78. package/plugin/templates/docs/agents/domain.md +15 -0
  79. package/plugin/templates/docs/agents/issue-tracker.md +23 -0
  80. package/plugin/templates/docs/agents/stack.md +132 -0
  81. package/plugin/templates/harness.conf +61 -0
  82. package/plugin/templates/orca.yaml +10 -0
  83. 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