Doc: Equipe de IA (doc/clipador/EQUIPE-IA.md) e contrato por papel em doc/ia.md

- EQUIPE-IA.md: papéis e configuração (judge.roles, migração), juiz de contexto e as regras
  de decisão pelo código, linha do tempo JSON + mosaico, medição (ai_calls, owner_label,
  GET /v1/judge/report) e o medido no corte 291 (analista −45%, varredura −38%, editor −20%;
  ≈ −29% por hora já com o juiz; 1 chamada real do juiz no Codex: 9.624 tokens de entrada).
- doc/ia.md: reserva por papel, codex exec --json e leitura de uso por CLI.
- README do Clipador: rotas /v1/judge e /v1/judge/report.
- judge.describe: uma checagem por provedor para todas as cadeias (o painel lê o status a
  cada poucos segundos); sem analista, o editor recebe as imagens no modo escolhido.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Mateuus
2026-11-18 04:44:56 -03:00
co-authored by Claude Opus 5.5
parent 26c9afa13a
commit 76b722c499
5 changed files with 213 additions and 16 deletions
+14 -11
View File
@@ -1233,13 +1233,13 @@ class Judge:
elif self.roles["analyst"]["model"] and provider != self.roles["analyst"]["provider"]:
self.roles["analyst"]["model"] = ""
def roles_view(self) -> dict:
"""Papéis para o painel: a configuração + instruções padrão (só leitura) e a cadeia de reserva de cada um."""
def roles_view(self, skip: dict[str, str | None] | None = None) -> dict:
"""Papéis para o painel: a configuração + o modelo efetivo e a cadeia de reserva de cada um."""
out = {}
for name in roles_module.ROLES:
conf = dict(self.roles[name])
conf["resolvedModel"] = self.role_model(name)
conf["chain"] = self.fallback_chain(conf["provider"]) if self.enabled else []
conf["chain"] = self.fallback_chain(conf["provider"], skip) if self.enabled else []
out[name] = conf
return out
@@ -1299,11 +1299,12 @@ class Judge:
return "modo chave de API sem chave no cofre"
return None
def fallback_chain(self, primary: str | None = None) -> list[str]:
def fallback_chain(self, primary: str | None = None, skip: dict[str, str | None] | None = None) -> list[str]:
"""Ordem em que `ask` tenta as IAs: a do papel (`primary`; padrão = a do editor) primeiro, depois a `order`
do painel, só as ligadas, com CLI e (no modo chave) com chave; as em pausa são puladas e as perto do limite
de uso vão para o fim. Reserva desligada: só a escolhida.
Se TODAS as prontas estiverem em pausa, elas voltam como último recurso (melhor tentar do que parar)."""
Se TODAS as prontas estiverem em pausa, elas voltam como último recurso (melhor tentar do que parar).
`skip` = `_skip_reason` já calculado por provedor (o `describe` monta a cadeia de cada papel de uma vez)."""
if not self.enabled:
return []
primary = primary if primary in AI_ENABLED else self.provider
@@ -1311,7 +1312,8 @@ class Judge:
candidates = [primary]
if settings["fallback"]["enabled"]:
candidates += [p for p in settings["order"] if p != primary and p in AI_ENABLED]
ready = [p for p in candidates if self._skip_reason(p, settings) is None]
ready = [p for p in candidates
if (skip[p] if skip is not None and p in skip else self._skip_reason(p, settings)) is None]
if not settings["fallback"]["enabled"]:
return ready
paused = self.pauses()
@@ -1323,7 +1325,9 @@ class Judge:
def describe(self) -> dict:
cmd = self.command() if self.enabled else None
settings = self.ai.settings()
primary_skip = self._skip_reason(self.provider, settings) if self.enabled else None
# Uma checagem por provedor (CLI no PATH, ligada, chave) para todas as cadeias: o painel lê isto a cada poucos s.
skip = {p: self._skip_reason(p, settings) for p in AI_ENABLED}
primary_skip = skip.get(self.provider) if self.enabled else None
return {"provider": self.provider, "model": self.model if self.enabled else None,
"analystModel": self.role_model("analyst") if self.enabled else None,
"available": bool(cmd) if self.enabled else None, "path": cmd[-1] if cmd else None,
@@ -1332,13 +1336,12 @@ class Judge:
"authMode": settings["providers"].get(self.provider, {}).get("authMode") if self.enabled else None,
"fallback": {"enabled": settings["fallback"]["enabled"],
"cooldownMin": settings["fallback"]["cooldownMin"],
"chain": self.fallback_chain()},
"chain": self.fallback_chain(skip=skip)},
"pauses": [{"provider": p, "until": datetime.fromtimestamp(until, timezone.utc).isoformat(timespec="seconds"),
"reason": reason} for p, (until, reason) in sorted(self.pauses().items())],
# Equipe de IA: cada papel com a sua IA (doc/clipador/EQUIPE-IA.md).
"roles": self.roles_view(),
"providers": {p: {"ready": self._skip_reason(p, settings) is None,
"reason": self._skip_reason(p, settings),
"roles": self.roles_view(skip),
"providers": {p: {"ready": skip[p] is None, "reason": skip[p],
"enabled": bool((settings["providers"].get(p) or {}).get("enabled"))}
for p in AI_ENABLED}}
+2 -2
View File
@@ -940,8 +940,8 @@ class Engine:
# Linha do tempo JSON (novo) ou transcrição + chat + frames soltos (antigo, `timelineJson` desligado).
use_timeline = bool(self.intel.opts.get("timelineJson", True))
analyst_on = self.judge.role_enabled("analyst")
image_mode = (self.judge.roles["analyst"].get("images", "mosaic") if analyst_on else "frames") \
if use_timeline else "frames"
# Imagens como escolhido no analista (sem analista, o editor recebe as mesmas); formato antigo = soltos.
image_mode = self.judge.roles["analyst"].get("images", "mosaic") if use_timeline else "frames"
# Quadros espalhados de um pouco antes do candidato até o fim da reação: o analista vê a sequência.
# 6 quadros; 8 quando o trecho passa de 80 s (cortes de 60–90 s), para não ficar > 20 s entre quadros.
f_lo = max(lo, clip["start_s"] - 20)