Repository navigation
Description
Split out of #742 (after #773 landed). The guardian finder/skeptic still runs on Anthropic; the rest of the stack already runs on opencode-go with DeepSeek models, and keeping a separate ANTHROPIC_API_KEY is a second credential and a second bill for no product reason.
What remains
- A provider for opencode-go. It is an OpenAI-compatible gateway —
https://opencode.ai/inference/go/v1, key inOPENCODE_API_KEY— so the closest template issrc/cgis/guardian/providers/openrouter.py(httpx,DEFAULT_REQUEST_TIMEOUT,DEFAULT_MAX_TOKENS, explicit temperature). Addproviders/opencode.pybehindGUARDIAN_PROVIDER=opencode-go, register it inbuild_provider(src/cgis/guardian/runner.py), and keep the base URL configurable (GUARDIAN_OPENCODE_BASE_URL) so a pin to a different gateway needs no code change. - Default model.
deepseek-v4.1-flash(measured cost on opencode-go: 0.15/0.6 per 1M in/out). Its compat record saysmax_tokensfor the budget field andthinkingFormat: deepseek; the reasoning levels are off/minimal/low/medium/high/xhigh/max, so the "depth" knob thatGUARDIAN_ANTHROPIC_EFFORTexposed has to be re-expressed for this provider instead of silently dropped. - Drop the Claude-only special cases in
runner.py:_anthropicrefusesGUARDIAN_TEMPERATUREbecause Claude rejects sampling; the new default provider accepts temperature, so the refusal must become provider-specific rather than global.DEFAULT_ANTHROPIC_MODEL = "claude-haiku-5-5"stops being the default finder. - Workflow.
guardian-reusable.ymldeclaressecrets.ANTHROPIC_API_KEYand passesvars.GUARDIAN_PROVIDER,vars.GUARDIAN_MODEL,vars.GUARDIAN_ANTHROPIC_EFFORT,vars.GUARDIAN_SKEPTIC_MODEL. Swap the secret forOPENCODE_API_KEY(or keep both and letBUILD_PROVIDERauto-detect), and replace the effort var with the new depth var. - Docs and bench. README's "requirements" section, the provider table, and
bench.py/calibrate.pyground truth: a model swap changes the finder's recall and the judge's drift, which guardian(bench): detect LLM-judge drift between runs with a frozen anchor set #752 is already measuring.
What needs a decision (do not silently pick)
#246 requires the skeptic from a vendor other than the finder's. A DeepSeek finder plus a DeepSeek skeptic breaks that assumption. Either accept the same vendor and say so in the run record, or keep the skeptic on gemini/openrouter on purpose.
Why
One credential and one bill instead of two; the same provider the agent stack already uses; and a self-hosted runner no longer needs an Anthropic key to run the review job.
When
After #742 (done: #773 merged as 969f566). Not urgent until the Anthropic key rotates or expires — but the longer it waits, the more Claude-only cases accumulate in runner.py.
Done when
GUARDIAN_PROVIDER=opencode-go GUARDIAN_MODEL=deepseek-v4.1-flashruns a review end to end with noANTHROPIC_API_KEYin the environment;- provider tests mirror
tests/unit/test_guardian_poster.py-style mocking for the new provider (URL, bearer auth,max_tokens, timeout, a 429/4xx raising rather than degrading to "no judgement"); tests/unit/test_guardian_workflow.pypins the secret/vars the reusable workflow passes;- the skeptic-vendor question above is answered in the issue thread and reflected in the run record;
bench.py/calibrate.pynumbers on the new model are recorded in the issue.
🤖 Filed by the dsh-superagent deployment on zae-life (setup smoke: #772, #742→#773).
Activity
zaebee commentedon Nov 5, 2026
@it-start Возьми, пожалуйста, эту задачу в работу. Ниже — уточнённая постановка: я сверил issue с
main(969f566) и с живым каталогом opencode-go (2026-11-05). Полное «Done when» — в теле issue; открытые вопросы ниже уже решены, переспрашивать не нужно.Решения по вопросам из issue (не пересматривать)
build_skeptic_providerуже так выбирает для любого primary != "gemini"). Same-vendor DeepSeek-скептик не добавляем,opencodeв_SKEPTIC_BUILDERSне нужен. В CI и у вызывающих остаётсяGUARDIAN_SKEPTIC=off. Это и есть ответ на вопрос guardian: cross-model skeptic to cut recall-lean noise without killing recall #246; в run record он отражается тем, чтоskeptic_modelне DeepSeek.zaebee/codegraph-brain+ org secretOwnima). Ты секреты не создаёшь, не читаешь и не печатаешь. Живой end-to-end — после мержа, человеком; issue не закрывай.Что сделать
1. Провайдер. Новый
src/cgis/guardian/providers/opencode.pyпо образцуproviders/openrouter.py(httpx,BaseProvider, явные temperature/max_tokens, тот же стиль ошибок).name: ClassVar[str] = "opencode"— не"opencode-go":review_fingerprint.walk_closureвыводит путь модуля из имени провайдера (providers/<name>.py), и дефис дастproviders/opencode-go.py→UnknownProviderErrorна первом же review. Селектор из issue — ниже, вbuild_provider.https://opencode.ai/inference/go/openai/v1, переопределяетсяGUARDIAN_OPENCODE_BASE_URL(пустое → дефолт; хвостовой/срезать; POST на{base}/chat/completions). В issue URL без/openai— живой каталог и доки дают.../go/openai/v1(проверено:curl https://opencode.ai/inference/go/v1/models).deepseek-v4.1-flash(DEFAULT_OPENCODE_MODEL),GUARDIAN_MODELпереопределяет; в отличие от openrouter, дефолт есть.max_tokens(неmax_completion_tokens);DEFAULT_MAX_TOKENSкак у openrouter (8000) или больше,finish_reason == "length"→ исключение, а не обрезанный ответ.reasoning_effortв payload изGUARDIAN_OPENCODE_EFFORT; дефолтlow(какDEFAULT_ANTHROPIC_EFFORT), значение отдавать черезeffort-propertyBaseProvider, чтобы попадало в запись. Живой каталог для этой модели даётlow|high|max(7 уровней из issue — неверно); валидируй дефолт, остальное пропускай, 4xx от гейтвея — громко.GUARDIAN_TEMPERATUREпробрасывать (модельtemperature: true). Отказ оставить только в_anthropic— он уже provider-specific, глобального отказа в коде нет.OpenRouterQuotaError);raise_for_statusна остальном;contentпустой/None при непустомmessage.reasoning_content→ исключение (DeepSeek кладёт reasoning отдельно, ответ берём только изcontent).User-Agent, идентифицирующий клиента (напримерcodegraph-brain-guardian/<version>), иx-opencode-sessionсо стабильным id на run — доки Go просят это для маршрутизации/кэша. Дёшево, добавь.2. Регистрация.
src/cgis/guardian/runner.py: импорт,_build_opencode(OPENCODE_API_KEYобязателен, temperature), ключи вbuilders— оба:"opencode-go"(канонический, из issue) и"opencode"(алиас, чтобыprovider.nameсовпадал с одним из селекторов)._autodetect_provider— опционально (для Done when не нужен); если добавляешь — первым поOPENCODE_API_KEYи обнови текст ошибки с тестами._anthropicиDEFAULT_ANTHROPIC_MODELне удаляй: Anthropic остаётся явным провайдером (#246), просто больше не дефолт в vars.3. Обязательно — fingerprint (в issue этого нет).
src/cgis/guardian/review_fingerprint.py,walk_closure: захардкожен кортеж известных провайдеров("gemini", "mistral", "ollama", "openrouter", "anthropic"). Добавь"opencode", иначе модуль не считается провайдером и приactive={"opencode"}walk упадётUnknownProviderError.SCHEMEне менять. Тест:walk_closure(reader, frozenset({"opencode"}))не падает и содержитsrc/cgis/guardian/providers/opencode.py.4. Workflow.
.github/workflows/guardian-reusable.yml:on.workflow_call.secretsдобавитьOPENCODE_API_KEY: required: false;ANTHROPIC_API_KEYоставить объявленным (внешние вызывающие передают его по имени; удаление сломает их YAML) и проброшенным в env — при незаполненном секрете он пустой, и opencode-go его не требует;OPENCODE_API_KEYиGUARDIAN_OPENCODE_EFFORT;GUARDIAN_ANTHROPIC_EFFORTубрать из env и из шапки-комментария (Anthropic через reusable workflow остаётся на своём дефолтном effort — осознанно);GUARDIAN_PROVIDER,GUARDIAN_MODEL,GUARDIAN_SKEPTIC,GUARDIAN_SKEPTIC_MODELоставить;guardian.ymlэтого репозитория не меняется — тамsecrets: inherit. Внешним вызывающим (owner-api) нужно будет передать новый секрет по имени — это отдельный шаг, не здесь.5. Тесты (минимум):
tests/unit/test_guardian_opencode.pyпо образцуtest_guardian_openrouter.py: URL из base override/default, Bearer,max_tokens, timeout,reasoning_effort, 429 → свой тип, 4xx → raise (не «no judgement»),finish_reason=length→ raise, пустойcontentпри непустомreasoning_content→ raise;tests/unit/test_guardian_runner.py:_build_opencode(ключ обязателен, дефолтная модель, override, base URL, temperature, effort), список вtest_build_provider_unknown_lists_every_provider_there_is, autodetect (если добавил);tests/unit/test_guardian_workflow.py:test_cross_org_callers_can_pass_the_secrets(новый набор), env review-шага (естьOPENCODE_API_KEY/GUARDIAN_OPENCODE_EFFORT, нетGUARDIAN_ANTHROPIC_EFFORT);tests/unit/test_guardian_providers_name.py— по необходимости;tests/unit/test_review_fingerprint_closure.py— тест из п.3;build_provider({"GUARDIAN_PROVIDER": "opencode-go", "OPENCODE_API_KEY": "k"})не требует ни одного другого ключа — это «no ANTHROPIC_API_KEY» на уровне кода.6. Доки.
README.md§Guardian (фраза «Mistral / Gemini / Claude» и пример сGUARDIAN_SKEPTIC=anthropic) — добавь opencode-go/DeepSeek,GUARDIAN_OPENCODE_EFFORT,GUARDIAN_OPENCODE_BASE_URL;PRIVACY.md— в перечень провайдеров добавить OpenCode Go (DeepSeek).Проверки и сдача
make format && make lint && make type-check && make pytest && make doc-coverage— зелёные, это обязательный гейт репозитория.it-start commentedon Nov 5, 2026
Принято: добавляю в Guardian провайдера opencode-go на DeepSeek — провайдер, регистрация, fingerprint, workflow, тесты и доки; затем PR на ревью без мержа.
zaebee commentedon Nov 5, 2026
Уточнение к постановке (workflow и креды): opencode-go по OIDC, без статического секрета.
Opencode даёт обмен GitHub OIDC → short-lived токен инференса. Используем его вместо
secrets.OPENCODE_API_KEY; провайдерный код не меняется (OPENCODE_API_KEYостаётся именем env-переменной, в неё попадает выданный токен). Меняется только workflow..github/workflows/guardian-reusable.ymlreview: вpermissionsдобавитьid-token: write(рядом сcontents: read,pull-requests: write,issues: write).ACCESS_ID_TOKEN_REQUEST_URL/TOKENпусты (шаг запущен безid-token: write), если в ответе нет поля, или если обмен вернул 4xx: не деградировать в пустой ключ, а падать до вызова модели. Тело ошибки можно напечатать (обрезанным), сам токен — нет.https://opencode.ai/console/auth/oauth/token), audience — константа (https://opencode.ai/console).secrets.OPENCODE_API_KEYне добавлять ни вworkflow_call.secrets, ни в env review-шага: step-levelenv:перекрываетGITHUB_ENV, поэтому статический пустой секрет затёр бы выданный токен. В env «Run Guardian Review» переменнуюOPENCODE_API_KEYне передавать вовсе — она придёт только изGITHUB_ENV.vars.OPENCODE_CLIENT_ID— переменная вызывающего (в reusable workflow контекстvarsотносится к caller), поэтому codegraph-brain и owner-api смогут иметь свои client id. Значение в коде/PR не хардкодить; в issue/PR его не печатать.secrets.ANTHROPIC_API_KEYостаётся объявленным и проброшенным, как писали: при незаполненном секрете он пустой, и opencode-go его не требует..github/workflows/guardian.ymlэтого репозитория: вjobs.review.permissionsдобавитьid-token: write. Reusable workflow не может запросить больше прав, чем выдал вызывающий, поэтому без этого job упадёт на OIDC.Тесты (
tests/unit/test_guardian_workflow.py)review.permissionsсодержитid-token: write;Sign in to OpenCode (OIDC)существует, стоит после всех PR-шагов и до «Run Guardian Review» (по аналогии сtest_the_app_token_is_minted_after_every_pr_step);$ACTIONS_ID_TOKEN_REQUEST_URL/$ACTIONS_ID_TOKEN_REQUEST_TOKEN, шлётaudience,grant_type=…token-exchange,subject_token_type=…jwt,client_idизvars.OPENCODE_CLIENT_ID, маскирует токен через::add-mask::и пишетOPENCODE_API_KEYв$GITHUB_ENV;workflow_call.secretsнетOPENCODE_API_KEY, в env review-шага нетsecrets.*OPENCODE*;guardian.yml: permissions включаютid-token: write(обновиtest_the_caller_hands_the_review_to_the_reusable_workflow);jq(проверка, что вrunнет вызоваjq).README/доки: вместо «положи
OPENCODE_API_KEYв secrets» — «включи OIDC-доступ для GitHub Actions в консоли opencode, задай переменнуюOPENCODE_CLIENT_ID; статический ключ не нужен». Токен короткоживущий, минтится непосредственно перед review.Если уже начал реализацию со статическим
secrets.OPENCODE_API_KEY— переделай на OIDC и отметь в комментарии, что именно изменил.Остальное из предыдущего комментария (провайдер, регистрация,
review_fingerprint, тесты провайдера, доки, гейты, «issue не закрывать») без изменений.it-start commentedon Nov 5, 2026
Понял: переделываю креды opencode-go на GitHub OIDC — шаг обмена токена,
id-token: writeв reusable и caller, безsecrets.OPENCODE_API_KEY; провайдерный код не меняю.zaebee commentedon Nov 5, 2026
Ревью PR #777.
Python Verification— зелёный,Conventional commit title— зелёный. Красное/замечания:Sonar Quality Gate: 3.0012% Duplication on New Code (порог ≤ 3%), 25 дублированных строк:
src/cgis/guardian/providers/opencode.py(блок 217–241) ↔src/cgis/guardian/providers/openrouter.py(174–198). Это дублируется хвост: применениеtemperature,generate_contentиgenerate_structuredсresponse_formatjson_schema. Не «подкрась иначе» — вынеси общий OpenAI-compatible кусок в одно место, которым пользуются оба провайдера (напримерproviders/openai_compatible.pyс общимиgenerate_content/generate_structured/response_format/применением temperature;_payloadоставь провайдерным — у openrouter тамreasoning, у opencodereasoning_effort). Тесты openrouter/opencode должны остаться зелёными. Новый модуль подproviders/без имени провайдера fingerprint не прунит — это shared helper,test_a_shared_helper_under_providers_is_never_prunedименно про это.Gemini inline (medium),
providers/opencode.py:121:effort.strip()упадётAttributeError, еслиeffortпридётNone;(effort or "").strip()надёжнее, аbaseне нужно дефолтить дважды. Поправь или ответь в комментарии, почему нет.После правки прогони проверки и ответь здесь, когда Sonar и замечание Gemini закрыты. Мерж — человек.
it-start commentedon Nov 5, 2026
Понял: выношу общий OpenAI-compatible код (
generate_*,response_format, temperature) вproviders/openai_compatible.py,_payloadоставляю провайдерным; инициализацию effort/base уже поправил. После прогона гейтов отвечу здесь.feat(guardian): add opencode-go DeepSeek provider over GitHub OIDC (#775
refactor(guardian): share OpenAI-compatible payload plumbing (#775)
zaebee commentedon Nov 5, 2026
Entire-ревьюер нашёл два medium на OIDC-шаге PR #777 (
.github/workflows/guardian-reusable.yml). Оба валидны — поправь до мержа.1. Не полагаться на
python3в PATHСейчас оба JSON-разбора идут через
python3 -c(строки ~294 и ~311):oidc=$(… | python3 -c '…')иtoken=$(… | python3 -c '…'). На self-hosted раннереuv syncсоздаёт.venv, но его интерпретатор в PATH не попадает, иpython3может отсутствовать. В ревью-команде ниже уже используетсяuv run --frozen python— сделай так же в обоих местах:Замени комментарий «python3 runs the tests, so it is there» на причину: uv установлен и env синхронизирован выше, а
python3в PATH не гарантирован. Тест добавь: вrunOIDC-шага нет вызоваpython3(regex по слову), оба разбора идут черезuv run --frozen python.2. Не требовать OIDC, когда выбран другой провайдер
Сейчас
if: vars.OPENCODE_CLIENT_ID != ''— у вызывающего сGUARDIAN_CLIENT_IDи, например,GUARDIAN_PROVIDER=mistralпадение/недоступность OpenCode валит job до запуска mistral. Гейт должен срабатывать только когда runner действительно выберет opencode:GUARDIAN_PROVIDER(послеtr '[:upper:]' '[:lower:]', как вbuild_provider) ∈ {opencode-go,opencode} → подписываться;GUARDIAN_PROVIDERпуст → подписываться: после минтаOPENCODE_API_KEYпопадёт в env, и_autodetect_providerвыберет opencode первым. Без минта autodetect ушёл бы в mistral/gemini — то есть OIDC сам делает opencode победителем автодетекта; это и есть «включая autodetection»;OpenCode is not the selected provider (…); skipping sign-in.иexit 0.Практически проще всего оставить
if: vars.OPENCODE_CLIENT_ID != '', а в началеrunсделать case-проверку по нормализованному$GUARDIAN_PROVIDER(передай его вenv:шага) и выйти 0 для чужого провайдера. Вариант с отдельным шагом-решателем иGITHUB_OUTPUTтоже ок, если так чище для тестов. В обоих случаях:tests/unit/test_guardian_workflow.py: сейчас он пинит точную строкуifи не проверяет skip-ветку — поправь и добавь кейс «явно выбран mistral/anthropic → opencode-шаг не подписывается»;GUARDIAN_PROVIDER=opencode-goили пустымGUARDIAN_PROVIDERпри заданномOPENCODE_CLIENT_ID; явный другой провайдер OIDC не трогает.Остальное (провайдер, fingerprint, тесты,
id-token, отсутствие статического ключа) не меняй. После правки — прогон гейтов и отпишись здесь; мерж человек.it-start commentedon Nov 5, 2026
On it: в OIDC-шаге перевожу оба JSON-разбора на
uv run --frozen python, добавляю skip-ветку для явно выбранного другого провайдера, обновляю тесты, шапку workflow и README; после прогона гейтов отпишусь здесь.fix(guardian): harden the OIDC sign-in for self-hosted runners (#775)
feat(guardian): add opencode-go DeepSeek provider over GitHub OIDC (#777
it-start commentedon Nov 5, 2026
PR #777 готов к мержу: оба замечания Entire по OIDC-шагу исправлены, все проверки и локальный гейт зелёные. Мерж за вами.
zaebee commentedon Nov 5, 2026
Готово — #775 закрыт по всем пунктам, кроме bench, который вынесен в #778.
Что сделано
opencode-go/DeepSeek с дефолтомdeepseek-v4.1-flash,GUARDIAN_OPENCODE_EFFORT(low по умолчанию),GUARDIAN_OPENCODE_BASE_URL, temp/max_tokens/reasoning_effort, 429/4xx/length/reasoning-only — громкие ошибки;review_fingerprintзнает нового провайдера; OIDC-шаг в reusable workflow без статического ключа, гейт по выбранному провайдеру,uv run --frozen pythonвместоpython3; тесты провайдера/runner/workflow/fingerprint; README + PRIVACY.deepseek-v4.1-flash, inline review отcodegraph-guardian[bot]):33ec492,id-token: write,ANTHROPIC_API_KEYубран) и смержен; run 42088770813 на тестовом PR #2556 — шаг OIDC success,ANTHROPIC_API_KEYв env пустой. Smoke-PR закрыт, ветка удалена.GUARDIAN_SKEPTIC=off. В run record это видно по пустомуskeptic_model.low|high|max, judge drift (рядом guardian(bench): detect LLM-judge drift between runs with a frozen anchor set #752), стоимость прогона.Закрываю: критерии Done when, кроме bench, выполнены; bench отслеживается в #778.