dragon-py-core 0.1.0__tar.gz

dragon_py_core-0.1.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: dragon-py-core
+Version: 0.1.0
+Summary: DRAGON 领域框架契约面（Python SDK）：与 TS zod 正本逐值对齐的 pydantic 模型 + seam fixture 装载
+License: Apache-2.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic>=1.10
+
+# dragon-py-core
+
+DRAGON 领域框架 Python SDK 组件（core 面）。用法与多语言一致性门禁见
+[python/README.md](../README.md)；框架主仓：DRAGON 领域框架（Apache-2.0）。

dragon_py_core-0.1.0/README.md

@@ -0,0 +1,4 @@
+# dragon-py-core
+
+DRAGON 领域框架 Python SDK 组件（core 面）。用法与多语言一致性门禁见
+[python/README.md](../README.md)；框架主仓：DRAGON 领域框架（Apache-2.0）。

dragon_py_core-0.1.0/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dragon-py-core"
+version = "0.1.0"
+description = "DRAGON 领域框架契约面（Python SDK）：与 TS zod 正本逐值对齐的 pydantic 模型 + seam fixture 装载"
+requires-python = ">=3.10"
+license = {text = "Apache-2.0"}
+readme = "README.md"
+dependencies = ["pydantic>=1.10"]
+
+[tool.setuptools.packages.find]
+where = ["src"]

dragon_py_core-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

dragon_py_core-0.1.0/src/dragon_py_core/__init__.py

@@ -0,0 +1,27 @@
+"""dragon_py_core — DRAGON 领域框架契约面（Python SDK）。
+
+与 TS 契约正本（`packages/is-contracts`，zod schema）逐值对齐；对齐门禁 = 与 TS 侧
+消费同一套 seam fixture（`fixtures/seams/`）——多语言合规锚（Paper 2 §4/§6 证据面）。
+
+兼容 pydantic v1 惯用法（在 v2 下带弃用告警运行）。
+"""
+from dragon_py_core.contracts import (
+    AutonomyLevel,
+    Envelope,
+    IsDescriptor,
+    LOW_CONFIDENCE_THRESHOLD,
+    Sla,
+    UNLABELED_AUTONOMY_FALLBACK,
+)
+from dragon_py_core.fixtures import load_seam_fixture, seams_root
+
+__all__ = [
+    "AutonomyLevel",
+    "Envelope",
+    "IsDescriptor",
+    "LOW_CONFIDENCE_THRESHOLD",
+    "Sla",
+    "UNLABELED_AUTONOMY_FALLBACK",
+    "load_seam_fixture",
+    "seams_root",
+]

dragon_py_core-0.1.0/src/dragon_py_core/contracts.py

@@ -0,0 +1,59 @@
+"""L3 契约面（Python 侧）——与 TS 正本 `packages/is-contracts` 逐值对齐。
+
+对齐纪律（同 contract-fuzz 的双语言纪律）：值域/缺省/阈值任何一侧漂移，
+`tests/test_conformance.py` 对 seam fixture 的断言即失败。
+"""
+from enum import Enum
+from typing import List, Optional
+
+from pydantic import BaseModel, Field, confloat
+
+# 与 TS `meta/contract/src/autonomy.ts` 同值域；未标注缺省 L3（fail-closed，GADR-028）
+UNLABELED_AUTONOMY_FALLBACK = "L3"
+
+# 与 TS `is-contracts` LOW_CONFIDENCE_THRESHOLD 同值（编排决策分界）
+LOW_CONFIDENCE_THRESHOLD = 0.6
+
+
+class AutonomyLevel(str, Enum):
+    L0 = "L0"
+    L1 = "L1"
+    L2 = "L2"
+    L3 = "L3"
+    L4 = "L4"
+
+
+class Sla(BaseModel):
+    target_latency_ms: Optional[int] = Field(default=None, alias="targetLatencyMs")
+    availability: Optional[confloat(ge=0, le=1)] = None
+
+    class Config:
+        allow_population_by_field_name = True
+
+
+class Envelope(BaseModel):
+    """概率契约（C1）：置信度 + SLA + 前提 + 可降级。"""
+
+    confidence: confloat(ge=0, le=1)
+    sla: Optional[Sla] = None
+    preconditions: List[str] = Field(default_factory=list)
+    degradable: Optional[dict] = None
+
+    def is_low_confidence(self) -> bool:
+        return self.confidence < LOW_CONFIDENCE_THRESHOLD
+
+
+class IsDescriptor(BaseModel):
+    """IS 契约描述符（Python 侧最小面——完整字段以 TS zod schema 为准）。"""
+
+    is_id: str = Field(alias="isId")
+    name: str
+    role: str  # L1..L5
+    scope: str  # IS | IIS
+    networkable: bool = False
+    envelope: Envelope
+    autonomy: AutonomyLevel = AutonomyLevel(UNLABELED_AUTONOMY_FALLBACK)
+    contract_version: str = Field(alias="contractVersion")
+
+    class Config:
+        allow_population_by_field_name = True

dragon_py_core-0.1.0/src/dragon_py_core/fixtures.py

@@ -0,0 +1,25 @@
+"""seam fixture 装载——多语言合规锚（OSR-15 的 Python 消费面）。
+
+Python SDK 与 TS 内核消费**同一份** `fixtures/seams/*.json`：fixture 是契约锁，
+任何一侧漂移在两侧测试同时失败。
+"""
+import json
+import os
+from pathlib import Path
+from typing import Any, Dict
+
+
+def seams_root() -> Path:
+    """定位 fixtures/seams 根（env 可覆盖：DRAGON_REPO_ROOT）。"""
+    override = os.environ.get("DRAGON_REPO_ROOT")
+    if override:
+        return Path(override) / "fixtures" / "seams"
+    # 本文件 <repo>/python/dragon_py_core/src/dragon_py_core/fixtures.py → 上溯 4 级到仓根
+    return Path(__file__).resolve().parents[4] / "fixtures" / "seams"
+
+
+def load_seam_fixture(name: str) -> Dict[str, Any]:
+    """按文件名装载 seam fixture（如 "s7-value-domains.json"）。"""
+    path = seams_root() / name
+    with path.open(encoding="utf-8") as fh:
+        return json.load(fh)

dragon_py_core-0.1.0/src/dragon_py_core.egg-info/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: dragon-py-core
+Version: 0.1.0
+Summary: DRAGON 领域框架契约面（Python SDK）：与 TS zod 正本逐值对齐的 pydantic 模型 + seam fixture 装载
+License: Apache-2.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic>=1.10
+
+# dragon-py-core
+
+DRAGON 领域框架 Python SDK 组件（core 面）。用法与多语言一致性门禁见
+[python/README.md](../README.md)；框架主仓：DRAGON 领域框架（Apache-2.0）。

dragon_py_core-0.1.0/src/dragon_py_core.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/dragon_py_core/__init__.py
+src/dragon_py_core/contracts.py
+src/dragon_py_core/fixtures.py
+src/dragon_py_core.egg-info/PKG-INFO
+src/dragon_py_core.egg-info/SOURCES.txt
+src/dragon_py_core.egg-info/dependency_links.txt
+src/dragon_py_core.egg-info/requires.txt
+src/dragon_py_core.egg-info/top_level.txt
+tests/test_conformance.py

dragon_py_core-0.1.0/src/dragon_py_core.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

dragon_py_core-0.1.0/src/dragon_py_core.egg-info/requires.txt

@@ -0,0 +1 @@
+pydantic>=1.10

dragon_py_core-0.1.0/src/dragon_py_core.egg-info/top_level.txt

@@ -0,0 +1 @@
+dragon_py_core

dragon_py_core-0.1.0/tests/test_conformance.py

@@ -0,0 +1,40 @@
+"""多语言合规一致性门禁（Python 侧）：SDK 契约面 ↔ seam fixture 逐值对齐。
+
+与 TS 侧 `packages/ara-tests/tests/seam-compliance.spec.ts` 消费同一套 fixture——
+两语言测试互为镜像，任一语言漂移即该侧失败（Paper 2 §4「同一 fixture 集自检」的多语言实例）。
+"""
+from dragon_py_core import (
+    AutonomyLevel,
+    Envelope,
+    LOW_CONFIDENCE_THRESHOLD,
+    UNLABELED_AUTONOMY_FALLBACK,
+    load_seam_fixture,
+)
+
+
+def test_autonomy_domain_matches_seam_fixture():
+    s7 = load_seam_fixture("s7-value-domains.json")
+    assert s7["autonomy"]["domain"] == [lvl.value for lvl in AutonomyLevel]
+    # 未标注缺省 fail-closed：两侧同为 L3（GADR-028）
+    assert s7["autonomy"]["unlabeledDefault"].startswith(UNLABELED_AUTONOMY_FALLBACK)
+    assert UNLABELED_AUTONOMY_FALLBACK == "L3"
+
+
+def test_envelope_confidence_bounds_match_contract():
+    env = Envelope(confidence=0.9)
+    assert env.confidence == 0.9
+    assert env.is_low_confidence() is False
+    assert Envelope(confidence=0.42).is_low_confidence() is True
+    # 阈值是编排分界——低于即触发重试/兜底/人审
+    assert LOW_CONFIDENCE_THRESHOLD == 0.6
+
+
+def test_approval_verbs_match_seam_fixture():
+    s1 = load_seam_fixture("s1-approval.json")
+    assert s1["valueDomain"]["decisionVerbs"] == ["approve", "reject"]
+
+
+def test_identity_rule_matches_seam_fixture():
+    s9 = load_seam_fixture("s9-token-claims.json")
+    # SDK 不做自有认证——与 TS 侧同一纪律（S-9）
+    assert "never issues, stores, or verifies credentials" in s9["rule"]