Spaces:
Running
Running
Download solar_eval/hub_hook/optin.py from dev-strender/proofread-demo: direct link, hf CLI and curl.
- Browser
- Download file 10.4 kB
-
https://huggingface.co/spaces/dev-strender/proofread-demo/resolve/main/solar_eval/hub_hook/optin.py
- Command line
-
hf download hf://spaces/dev-strender/proofread-demo/solar_eval/hub_hook/optin.py
-
curl -L -o optin.py https://huggingface.co/spaces/dev-strender/proofread-demo/resolve/main/solar_eval/hub_hook/optin.py
10.4 kB
| """ν 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}" | |
| class ConfirmDecision: | |
| """`--i-understand-local-data` λ₯Ό λΆμΌμ§μ, 무μνλ€λ©΄ κ·Έ μ΄μ (μ½μ κ²½κ³ ν μ€).""" | |
| confirm_local: bool | |
| warning: str | None = None | |
| 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) | |
| 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 | |