Spaces:
Running
Running
File size: 10,361 Bytes
3dfc93b | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 | """ν
opt-in ν΄μ β νκ²½ λ³μ > μ€μ νμΌ `hub:` μ , ν κ³³Β·μμ (κ³ν 2026-09-27 L6 Β§2.2 Β· 2026-09-28 L10 Β§2.6 Β· D-L10-6).
| μ
λ ₯ | λ» |
| ------------------------------------- | -------------------------------------------------------------------------------------- |
| `HUB_DATABASE_URL` | μμΌλ©΄ hub λ€λ¦¬λ₯Ό μΌ λ€(μΆμ² `env`). κ°μ μ½μ§ μλλ€ β λΆλͺ¨ νκ²½ κ·Έλλ‘ μμμκ² κ°λ€ |
| μ€μ νμΌ `hub.database_url` | νκ²½ λ³μκ° μμ λλ§ opt-in(μΆμ² `config`) β **μ¬λ μ
Έλ§**. κ°μ μμ νκ²½μΌλ‘λ§ κ°λ€ |
| `SOLAR_EVAL_HUB_CONFIRM` | `local` μ΄λ©΄ `--i-understand-local-data`. λ€λ₯Έ κ°μ 무μ + κ²½κ³ ν μ€ |
| μ€μ νμΌ `hub.confirm` | `local` λ§ β **URL μΆμ²κ° μ€μ μΌ λλ§**, μ¬λ μ
Έλ§(μλ "κ·μΉ 9 μ μλλ μμΈ") |
| `SOLAR_EVAL_STRICT_INGEST` | `1`Β·`true`Β·`yes` λ©΄ `--strict-ingest` μ κ°λ€ |
| `HUB_TEXT_MODE` | μμΈ ν€μλ§ μ΄λ€(κΈ°λ³Έ `inline`) |
| `AGENT_SESSION_MARKERS`(μλ λͺ©λ‘) | μμ΄μ νΈ μΈμ
νμ β νλλΌλ μμΌλ©΄ νμΈ(νκ²½Β·μ€μ )κ³Ό μ€μ μΆμ² opt-in μ 무μνλ€ |
| `SOLAR_EVAL_HOOK_DEBUG` | `1`Β·`true`Β·`yes` λ©΄ λ΄μν μμΈμ νΈλ μ΄μ€λ°±μ WARNING λ‘κ·Έλ‘(κΈ°λ³Έ DEBUG) |
**μμ΄μ νΈ μΈμ
κ°λ(D-L6-16 Β· D-L10-6).** νμ λͺ©λ‘ `AGENT_SESSION_MARKERS` λ μ΄ λͺ¨λ ν κ³³μ΄λ€ β Claude Code μ
`CLAUDECODE` μ, Codex κ° μ
Έ λꡬ·Seatbelt μλλ°μ€ μμμ μ€μ νλ€κ³ κ·Έ λ ν¬ `AGENTS.md` κ° μ μ `CODEX_SANDBOX`Β·
`CODEX_SANDBOX_NETWORK_DISABLED`(Q-L10-22 β λ¬Έμλ‘ νμΈν κ²λ§). νμμ΄ νλλΌλ λΉμ΄ μμ§ μμΌλ©΄ `SOLAR_EVAL_HUB_CONFIRM`Β·
`hub.confirm` μ 무μνκ³ , μ€μ νμΌ `hub.database_url` λ 무μνλ€(hub λ€λ¦¬ `skipped:not_opted_in` + κ²½κ³ ν μ€). μ¬λ μ
Έμλ
μν₯μ΄ μλ€. νμμ μλͺ» λν΄λ μ¬λ μ
Έμμ μ€μ opt-in μ΄ κΊΌμ§ λΏμ΄λΌ μμ μͺ½μ΄λ€.
**κ·μΉ 9 μ μλλ μμΈ(L10 κ²ν F1-3).** λ§μ€ν° Β§4 κ·μΉ 9 λ "`HUB_DATABASE_URL`Β·νμΈμ μ
Έ νλ‘νμ΄ μλλΌ λͺ
λ Ή μμ" λ€.
μ€μ νμΌ `hub.confirm: local` μ κ·Έ κ·μΉμ **μλλ μμΈ**λ€ β μ¬λ μ
Έμμ, URL λ μ€μ νμΌμ μμ λλ§ ν¨λ ₯μ΄ μλ€(νκ²½ URL κ³Ό
μ€μ confirm μ μμ§ μλλ€ β νκ²½μ ν
μ€νΈ URL μ μ€ μν μμμ΄ μ¬μ©μ νμΈμ μ€μ§ μκ², κ²ν F1-1).
URL κ°μ μ΄λμλ μ£μ§ μλλ€ β κ²½κ³ Β·`repr` μ μκ³ , μ€μ μΆμ² κ°μ `HubOptIn.secrets` λ‘ κ°λ¦ΌΒ·κ±°λΆ λͺ©λ‘μλ§ κ°λ€.
"""
from __future__ import annotations
import os
from collections.abc import Mapping
from dataclasses import dataclass, field
from typing import Any, Literal
ENV_HUB_DATABASE_URL = "HUB_DATABASE_URL"
ENV_HUB_CONFIRM = "SOLAR_EVAL_HUB_CONFIRM"
ENV_STRICT_INGEST = "SOLAR_EVAL_STRICT_INGEST"
ENV_HUB_TEXT_MODE = "HUB_TEXT_MODE"
ENV_HOOK_DEBUG = "SOLAR_EVAL_HOOK_DEBUG"
#: μμ΄μ νΈ μΈμ
νμ β ν κ³³(D-L10-6 Β· Q-L10-22). 첫 μμλ Claude Code.
AGENT_SESSION_MARKERS: tuple[str, ...] = (
"CLAUDECODE",
"CODEX_SANDBOX",
"CODEX_SANDBOX_NETWORK_DISABLED",
)
#: μ μ΄λ¦(L6) β 첫 νμμ λ³μΉ.
ENV_AGENT_SESSION = AGENT_SESSION_MARKERS[0]
#: `SOLAR_EVAL_HUB_CONFIRM`Β·`hub.confirm` μ΄ λ°λ μ μΌν κ°.
CONFIRM_LOCAL = "local"
#: hub CLI μ μ¬μ©μ DB μ°κΈ° νμΈ νλκ·Έ.
CONFIRM_FLAG = "--i-understand-local-data"
TRUTHY = frozenset({"1", "true", "yes"})
DEFAULT_TEXT_MODE = "inline"
#: μ΄λ³΄λ€ μ§§μ κ°μ μ°μ°ν κ²ΉμΉ μ μμ΄ κ°λ¦ΌΒ·κ±°λΆνμ§ μλλ€(URL μ μ΄λ³΄λ€ κΈΈλ€).
MIN_SECRET_LENGTH = 8
SOURCE_ENV = "env"
SOURCE_CONFIG = "config"
HubSource = Literal["env", "config"]
_MARKERS_LABEL = "Β·".join(AGENT_SESSION_MARKERS)
#: μ¬λμ΄ μ§μ λΆλ₯Ό μ μ¬ ν μ€(URL μ리λ `β¦`).
MANUAL_INGEST = "HUB_DATABASE_URL=β¦ make hub-ingest CASE=<a/c> CONFIRM=local"
#: μ½μ κ²½κ³ λ¬Έκ΅¬(κ°μ μ£μ§ μλλ€).
WARN_CONFIRM_IGNORED_AGENT = (
f"{ENV_HUB_CONFIRM}Β·μ€μ νμΌ hub.confirm μ 무μνλ€ β μμ΄μ νΈ μΈμ
({_MARKERS_LABEL})μμλ "
f"μ¬μ©μ DB μ°κΈ° νμΈμ λκΈ°μ§ μλλ€. μ¬λμ΄ μ§μ : {MANUAL_INGEST}"
)
WARN_CONFIRM_UNKNOWN_VALUE = (
f"{ENV_HUB_CONFIRM} κ°μ΄ '{CONFIRM_LOCAL}' μ΄ μλλΌ λ¬΄μνλ€ (λ°λ κ°: {CONFIRM_LOCAL})"
)
WARN_CONFIG_CONFIRM_UNKNOWN_VALUE = (
f"μ€μ νμΌ hub.confirm κ°μ΄ '{CONFIRM_LOCAL}' μ΄ μλλΌ λ¬΄μνλ€ (λ°λ κ°: {CONFIRM_LOCAL})"
)
WARN_CONFIG_OPTIN_IGNORED_AGENT = (
f"μ€μ νμΌ hub.database_url μ 무μνλ€ β μμ΄μ νΈ μΈμ
({_MARKERS_LABEL})μμλ μ€μ νμΌ opt-inΒ·νμΈμ "
f"μ°μ§ μλλ€. μ¬λμ΄ μ§μ : {MANUAL_INGEST}"
)
#: μ€μ λͺ¨μ μ€λ₯ β `{problems}` λ ν€ μ΄λ¦λ§ λ΄μ λ¬Έμ λͺ©λ‘(`HubConfig.problems`).
WARN_CONFIG_HUB_INVALID = "μ€μ νμΌ hub: μ μ 무μνλ€ β {problems}"
@dataclass(frozen=True)
class ConfirmDecision:
"""`--i-understand-local-data` λ₯Ό λΆμΌμ§μ, 무μνλ€λ©΄ κ·Έ μ΄μ (μ½μ κ²½κ³ ν μ€)."""
confirm_local: bool
warning: str | None = None
@dataclass(frozen=True)
class HubOptIn:
"""opt-in ν΄μ κ²°κ³Ό. `child_env` λ μ€μ μΆμ²μΌ λλ§(λΆλͺ¨ νκ²½ + URL), `secrets` λ μ€μ μΆμ² URL κ° β λ λ€ repr λ°."""
source: HubSource | None
child_env: Mapping[str, str] | None = field(default=None, repr=False)
confirm: ConfirmDecision = ConfirmDecision(False)
warnings: tuple[str, ...] = ()
secrets: tuple[str, ...] = field(default=(), repr=False)
@property
def opted_in(self) -> bool:
return self.source is not None
def _env(env: Mapping[str, str] | None) -> Mapping[str, str]:
return os.environ if env is None else env
def is_agent_session(env: Mapping[str, str] | None = None) -> bool:
"""μμ΄μ νΈ μΈμ
μΈκ° β `AGENT_SESSION_MARKERS` μ€ νλλΌλ λΉμ΄ μμ§ μλ€."""
source = _env(env)
return any(source.get(marker, "").strip() for marker in AGENT_SESSION_MARKERS)
def resolve_hub_optin(env: Mapping[str, str] | None = None, config: Any | None = None) -> HubOptIn:
"""νκ²½ λ³μ > μ€μ νμΌ `hub:` μ (Β§2.6 ν). `config` λ `cli.config.HubConfig`(μμΌλ©΄ None)."""
source_env = _env(env)
agent = is_agent_session(source_env)
url, confirm, problems = _config_fields(config)
warnings: list[str] = []
if problems:
warnings.append(WARN_CONFIG_HUB_INVALID.format(problems="; ".join(problems)))
secrets = _secrets_of(url)
if source_env.get(ENV_HUB_DATABASE_URL, "").strip():
decision = _env_confirm(source_env, agent) or ConfirmDecision(False)
return HubOptIn(SOURCE_ENV, None, decision, tuple(warnings), secrets)
if url is None or problems:
return HubOptIn(None, None, ConfirmDecision(False), tuple(warnings), secrets)
if agent:
warnings.append(WARN_CONFIG_OPTIN_IGNORED_AGENT)
return HubOptIn(None, None, ConfirmDecision(False), tuple(warnings), secrets)
child_env = {**source_env, ENV_HUB_DATABASE_URL: url}
decision = _env_confirm(source_env, agent) or _config_confirm(confirm)
return HubOptIn(SOURCE_CONFIG, child_env, decision, tuple(warnings), secrets)
def config_secrets(config: Any | None) -> tuple[str, ...]:
"""μ€μ μΆμ² λΉλ°(`hub.database_url` κ°) β μν νμΌ κ±°λΆΒ·μ½μ κ°λ¦Ό λͺ©λ‘μ λνλ€(Β§2.6 "λΉλ°"). μ°μ§ μμ μ€μ κ°λ λ£λλ€."""
return _secrets_of(_config_fields(config)[0])
def _secrets_of(url: str | None) -> tuple[str, ...]:
return (url,) if url is not None and len(url) >= MIN_SECRET_LENGTH else ()
def _config_fields(config: Any | None) -> tuple[str | None, str | None, tuple[str, ...]]:
"""`HubConfig` μ (URL, confirm, λ¬Έμ ) β κ°μ΄ λ¬Έμμ΄μ΄ μλλ©΄ μλ κ²μΌλ‘ λ³Έλ€."""
if config is None:
return None, None, ()
url = getattr(config, "database_url", None)
confirm = getattr(config, "confirm", None)
problems = tuple(getattr(config, "problems", ()) or ())
url = url.strip() if isinstance(url, str) and url.strip() else None
confirm = confirm.strip() if isinstance(confirm, str) and confirm.strip() else None
return url, confirm, problems
def _env_confirm(env: Mapping[str, str], agent: bool) -> ConfirmDecision | None:
"""`SOLAR_EVAL_HUB_CONFIRM` ν΄μ β λΉμ΄ μμΌλ©΄ None(μ€μ confirm μΌλ‘ λμ΄κ°λ€). μμ΄μ νΈ μΈμ
μ΄λ©΄ `local` λ 무μ."""
raw = env.get(ENV_HUB_CONFIRM, "").strip()
if not raw:
return None
if raw != CONFIRM_LOCAL:
return ConfirmDecision(False, WARN_CONFIRM_UNKNOWN_VALUE)
if agent:
return ConfirmDecision(False, WARN_CONFIRM_IGNORED_AGENT)
return ConfirmDecision(True)
def _config_confirm(confirm: str | None) -> ConfirmDecision:
"""μ€μ `hub.confirm` β URL μΆμ²κ° μ€μ μ΄κ³ μ¬λ μ
ΈμΌ λλ§ λΆλ₯Έλ€."""
if confirm is None:
return ConfirmDecision(False)
if confirm != CONFIRM_LOCAL:
return ConfirmDecision(False, WARN_CONFIG_CONFIRM_UNKNOWN_VALUE)
return ConfirmDecision(True)
def strict_requested(flag: bool, env: Mapping[str, str] | None = None) -> bool:
"""`--strict-ingest` λλ `SOLAR_EVAL_STRICT_INGEST` κ° μ°Έ(`1`Β·`true`Β·`yes`, λμλ¬Έμ 무μ)."""
return flag or _env(env).get(ENV_STRICT_INGEST, "").strip().lower() in TRUTHY
def hook_debug_requested(env: Mapping[str, str] | None = None) -> bool:
"""`SOLAR_EVAL_HOOK_DEBUG` κ° μ°Έ β λ΄μν μμΈμ νΈλ μ΄μ€λ°±μ WARNING λ‘κ·Έλ‘ μ¬λ¦°λ€(νμ₯ μ§λ¨μ©)."""
return _env(env).get(ENV_HOOK_DEBUG, "").strip().lower() in TRUTHY
def text_mode(env: Mapping[str, str] | None = None) -> str:
"""`HUB_TEXT_MODE` ν΄μκ°(λΉμμΌλ©΄ `inline`) β μμΈ ν€μλ§ μ΄λ€(D-L6-7)."""
return _env(env).get(ENV_HUB_TEXT_MODE, "").strip() or DEFAULT_TEXT_MODE
|