Skip to content

Commit b972b39

Browse files
Pigbibicodex
andauthored
Add qsl governance metadata for ops-control bridge (#7)
Co-authored-by: Codex <noreply@openai.com>
1 parent d024b54 commit b972b39

4 files changed

Lines changed: 55 additions & 0 deletions

File tree

README.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,15 @@ When a source issue contains a `codex-pr-feedback` marker from a failed CI run o
3131

3232
This avoids hard-coding Codex CLI setup in every source repository and avoids depending on a repository outside the `QuantStrategyLab` organization.
3333

34+
## Compatibility governance role
35+
36+
QuantStrategyLab `AIAuditBridge` is an ops/control-plane consumer only:
37+
38+
- It consumes compatibility governance metadata to align audit/review execution contracts.
39+
- It must **not** participate in trading runtime dependency graphs or strategy/runtime upgrade flows.
40+
- All governance references from this repo should be interpreted as control-plane/tooling compatibility, not runtime coupling.
41+
42+
3443
## Supported source repositories
3544

3645
| Source repository | Allowed task |

README.zh-CN.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,14 @@ Codex 执行现在只走 service backend:workflow 从 GitHub-hosted runner 调
3131

3232
这样可以避免每个 source repository 都硬编码 Codex CLI,也不会依赖 `QuantStrategyLab` 组织外的仓库。
3333

34+
## 兼容性治理定位
35+
36+
`QuantStrategyLab/AIAuditBridge` 只作为 ops/control-plane 的消费侧参与兼容治理:
37+
38+
- 仅消费兼容矩阵和治理元数据,确保审计/评审边界行为一致;
39+
- 不参与策略/交易运行时的依赖图、升级决策或 runtime 级联;
40+
- 本仓库中的兼容关系只用于审计与 review 运营(control-plane),不应被源仓库当作交易策略运行时依赖。
41+
3442
## 支持的 source repository
3543

3644
| Source repository | 允许的 task |

qsl.toml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
tier = "ops-tooling"
2+
ring = 4
3+
runtime_dependency = false
4+
5+
[compat]
6+
bundle = "2026.07.0"

tests/test_qsl_metadata.py

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
"""Validate qsl governance metadata for control-plane repos."""
2+
3+
from __future__ import annotations
4+
5+
from pathlib import Path
6+
import unittest
7+
8+
try:
9+
import tomllib
10+
except ModuleNotFoundError: # pragma: no cover
11+
import tomli as tomllib # type: ignore[import-not-found]
12+
13+
14+
class TestQslMetadata(unittest.TestCase):
15+
"""AIAuditBridge is a control-plane bridge, not runtime dependency."""
16+
17+
def _load_qsl(self) -> dict:
18+
with Path("qsl.toml").open("rb") as handle:
19+
return tomllib.load(handle)
20+
21+
def test_qsl_file_exists(self) -> None:
22+
self.assertTrue(Path("qsl.toml").exists())
23+
24+
def test_qsl_metadata_values(self) -> None:
25+
qsl = self._load_qsl()
26+
self.assertEqual(qsl.get("tier"), "ops-tooling")
27+
self.assertEqual(qsl.get("ring"), 4)
28+
self.assertIs(qsl.get("runtime_dependency"), False)
29+
30+
compat = qsl.get("compat")
31+
self.assertIsInstance(compat, dict)
32+
self.assertEqual(compat.get("bundle"), "2026.07.0")

0 commit comments

Comments
 (0)