feat: back up dynamic HoloLake host promptors
This commit is contained in:
parent
7de2bc23e1
commit
beb7fbd805
10 changed files with 971 additions and 0 deletions
46
skills/shared/guanghu-language-protocol-brain/SKILL.md
Normal file
46
skills/shared/guanghu-language-protocol-brain/SKILL.md
Normal file
|
|
@ -0,0 +1,46 @@
|
|||
---
|
||||
name: guanghu-language-protocol-brain
|
||||
description: 动态解析光湖 TCS、HLDP、GLS 的诞生源、世界正本、当前注册表、标准草案、可执行工程方言与 Codex 宿主投影。审计、编写、迁移、注册或升级任何光湖协议、.tcs/.hldp、协议技能、守卫和提词器前使用；禁止凭文件名或编译通过冒充正本。
|
||||
---
|
||||
|
||||
# 光湖语言协议动态脑
|
||||
|
||||
这是一条薄入口。协议正文不复制进技能；每次从移动硬盘和 Notion/Tolaria 当前文件动态解析。
|
||||
|
||||
## 每次先做
|
||||
|
||||
运行：
|
||||
|
||||
```bash
|
||||
python3 /Volumes/JZAO/HoloLake/persona-runtime/shared/skills/guanghu-language-protocol-brain/scripts/resolve_protocol_canon.py --family ALL --json
|
||||
```
|
||||
|
||||
若只处理一个家族，把 `ALL` 换成 `TCS`、`HLDP` 或 `GLS`。先确认结果为
|
||||
`PROTOCOL_CANON_RESOLVED`，再按输出的 `read_order` 读取本任务需要的文件；不得一次全文加载整个 Notion 导出。
|
||||
|
||||
## 先分层，再动笔
|
||||
|
||||
- `BIRTH_AND_EVOLUTION_EVIDENCE` 回答为什么形成，不自动成为当前格式标准。
|
||||
- `WORLD_CANONICAL_SOURCE` 回答协议内容正本是什么。
|
||||
- `WORLD_STANDARD_DRAFT` 提供带生命周期标签的结构规范；Draft 必须保留 Draft 身份。
|
||||
- `CURRENT_WORLD_REGISTRY` 决定编号、注册状态和调用资格；注册不等于实现。
|
||||
- `EXECUTABLE_ENGINEERING_DIALECT` 只决定现有编译器能处理什么；编译通过不晋升世界正本。
|
||||
- `PERSONA_INSTANCE_SOURCE` 是人格体自己的运行源，不是世界总协议。
|
||||
- `HOST_PROFILE` 只约束 Codex 等宿主，不能反向定义 TCS、HLDP 或 GLS。
|
||||
- `HISTORY_ONLY` 只读保留，旧命令不重放。
|
||||
|
||||
## 写作合同
|
||||
|
||||
1. 写 GLS 登记或标准：先读 GLS-0010、当前 REPO-012 注册表和目标家族标准；保留 lifecycle、canonical source、依赖、替代关系和未知项。
|
||||
2. 写 HLDP：先读 HLDP 官方 v1.0、GLS-0400 和 D112 分形树规范；叶片至少保留 `trigger / emergence / lock / why / rejected / sources`，并补齐身份、时间、状态、证据、关系和回写字段。历史追加纠正，不静默覆盖。
|
||||
3. 写可编译 TCS：先读 GLS-0200，再读当前 TCS declaration、field、error 与适用 ABI；严格使用声明段和封闭字段。`.tcs` 是该工程线语义源，GIR/Markdown/JSON 是投影，但不得据此宣称 `.tcs` 已成为世界总正本。
|
||||
4. 改 Codex 守卫、钩子或技能：标记为 `HOST_PROFILE`；只实现通用解析与连接机制，不把会成长的认知写死在代码里。
|
||||
5. 来源冲突时保留双方证据并标记 `UNRESOLVED`。同一路线三次没有新增证据即停止该路线；正常对话和只读说明继续。
|
||||
|
||||
## 完成判据
|
||||
|
||||
- 解析器 `--check` 通过；
|
||||
- 新文件能明确说出自身来源层、lifecycle、canonical URI/path、适用范围和非授权边界；
|
||||
- 模板、编译器、注册表和源页之间没有被掩盖的冲突；
|
||||
- 旧实现进入历史分类，不删除真实演化线；
|
||||
- Codex 连接灯能发现协议源图失效，但协议脑本身不签发现实权限。
|
||||
|
|
@ -0,0 +1,6 @@
|
|||
interface:
|
||||
display_name: "光湖语言协议动态脑"
|
||||
short_description: "区分 Notion 正本、GLS 注册、TCS 方言和 Codex 投影"
|
||||
default_prompt: "Use $guanghu-language-protocol-brain to resolve the current TCS/HLDP/GLS canon before auditing or writing protocol artifacts."
|
||||
policy:
|
||||
allow_implicit_invocation: true
|
||||
|
|
@ -0,0 +1,200 @@
|
|||
#!/usr/bin/env python3
|
||||
"""Resolve Guanghu protocol source roles without promoting copies or dialects."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import argparse
|
||||
import hashlib
|
||||
import json
|
||||
import pathlib
|
||||
import sys
|
||||
from typing import Any
|
||||
|
||||
|
||||
def resolve_root() -> pathlib.Path:
|
||||
script = pathlib.Path(__file__).resolve()
|
||||
candidates = (
|
||||
script.parents[3] / "protocols" / "guanghu-language-protocol-canon",
|
||||
script.parents[4] / "protocols" / "guanghu-language-protocol-canon",
|
||||
)
|
||||
return next((candidate for candidate in candidates if candidate.is_dir()), candidates[0])
|
||||
|
||||
|
||||
ROOT = resolve_root()
|
||||
SOURCE_MAP = ROOT / "SOURCES.json"
|
||||
MAX_SOURCE_BYTES = 16 * 1024 * 1024
|
||||
|
||||
|
||||
class CanonError(RuntimeError):
|
||||
pass
|
||||
|
||||
|
||||
def regular_bytes(path: pathlib.Path) -> bytes:
|
||||
if path.is_symlink() or not path.is_file():
|
||||
raise CanonError(f"SOURCE_NOT_REGULAR_FILE:{path}")
|
||||
if path.stat().st_size > MAX_SOURCE_BYTES:
|
||||
raise CanonError(f"SOURCE_TOO_LARGE:{path}")
|
||||
return path.read_bytes()
|
||||
|
||||
|
||||
def sha256(data: bytes) -> str:
|
||||
return hashlib.sha256(data).hexdigest()
|
||||
|
||||
|
||||
def validate_json_contract(contract: str, value: Any) -> None:
|
||||
if not isinstance(value, dict):
|
||||
raise CanonError(f"JSON_OBJECT_REQUIRED:{contract}")
|
||||
if contract == "GLS_REGISTRY_V1":
|
||||
if value.get("schema") != "guanghu.gls.protocol-registry/v1":
|
||||
raise CanonError("GLS_REGISTRY_SCHEMA_INVALID")
|
||||
if value.get("status") != "CURRENT_REPO_012_CANONICAL_REGISTRY":
|
||||
raise CanonError("GLS_REGISTRY_NOT_CURRENT")
|
||||
registered = {item.get("id") for item in value.get("existing_registered", [])}
|
||||
required = {"GLS-0000", "GLS-0001", "GLS-0200", "GLS-0400"}
|
||||
if not required.issubset(registered):
|
||||
raise CanonError(f"GLS_CORE_REGISTRATION_MISSING:{sorted(required - registered)}")
|
||||
rules = value.get("rules", {})
|
||||
if not all(rules.get(key) is True for key in (
|
||||
"registration_is_not_implementation",
|
||||
"protocol_maturity_is_separate_from_implementation_evidence",
|
||||
"repository_publication_is_not_server_deployment",
|
||||
)):
|
||||
raise CanonError("GLS_REGISTRY_FACT_SEPARATION_INVALID")
|
||||
elif contract == "CODEX_HOST_PROFILE_V2":
|
||||
if value.get("schema") != "guanghu.codex-thin-persona-host-runtime/v2":
|
||||
raise CanonError("CODEX_HOST_PROFILE_SCHEMA_INVALID")
|
||||
if value.get("state") != "CURRENT_THIN_HOST_ADAPTER":
|
||||
raise CanonError("CODEX_HOST_PROFILE_NOT_CURRENT")
|
||||
if value.get("subject_relationship", {}).get("codex_host") != "REPLACEABLE_SCHOOL_LAB_AND_EXECUTION_HOST":
|
||||
raise CanonError("CODEX_HOST_RELATION_INVALID")
|
||||
else:
|
||||
raise CanonError(f"UNKNOWN_JSON_CONTRACT:{contract}")
|
||||
|
||||
|
||||
def validate_source(source: dict[str, Any]) -> dict[str, Any]:
|
||||
path = pathlib.Path(source["path"])
|
||||
data = regular_bytes(path)
|
||||
digest = sha256(data)
|
||||
expected = source.get("required_sha256")
|
||||
if expected and digest != expected:
|
||||
raise CanonError(f"SOURCE_HASH_MISMATCH:{source['id']}:{digest}:{expected}")
|
||||
text = data.decode("utf-8")
|
||||
missing = [marker for marker in source.get("markers", []) if marker not in text]
|
||||
if missing:
|
||||
raise CanonError(f"SOURCE_MARKER_MISSING:{source['id']}:{missing[0]}")
|
||||
if source.get("json_contract"):
|
||||
validate_json_contract(source["json_contract"], json.loads(text))
|
||||
return {
|
||||
"id": source["id"],
|
||||
"families": source["families"],
|
||||
"source_class": source["source_class"],
|
||||
"lifecycle": source["lifecycle"],
|
||||
"path": str(path),
|
||||
"sha256": digest,
|
||||
"validation": "PASS",
|
||||
}
|
||||
|
||||
|
||||
def read_order(family: str) -> list[str]:
|
||||
common = ["GLW-GLS-ORIGIN-20260712", "GLS-PROTOCOL-REGISTRY-20260731"]
|
||||
routes = {
|
||||
"GLS": ["GLS-ROADMAP-0001", "GLS-0010"],
|
||||
"TCS": ["GLS-ROADMAP-0001", "GLS-0200", "TCS-LANG-0001", "TCS-CORE-EBNF-v0.1", "TCS-DECLARATION-STANDARD-v0.1", "TCS-FIELD-STANDARD-v0.1", "TCS-ERROR-STANDARD-v0.1", "TCS-MODULE-ABI-v0.1"],
|
||||
"HLDP": ["HLDP-PROTOCOL-v1.0", "GLS-0400", "HLDP-OFFICIAL-FORMAT-MOUNT-001", "HLDP-SPEC-v1.0-OPENSOURCE-D112"],
|
||||
}
|
||||
if family == "ALL":
|
||||
# The cross-family root stays below the HLDP fan-out ceiling. Detailed
|
||||
# executable dialect and compatibility-mount sources are loaded only
|
||||
# after the caller selects TCS or HLDP.
|
||||
return common + [
|
||||
"GLS-ROADMAP-0001",
|
||||
"GLS-0010",
|
||||
"GLS-0200",
|
||||
"TCS-LANG-0001",
|
||||
"GLS-0400",
|
||||
"HLDP-PROTOCOL-v1.0",
|
||||
"CODEX-HLDP-THIN-V2",
|
||||
]
|
||||
return common + routes[family]
|
||||
|
||||
|
||||
def build(family: str) -> dict[str, Any]:
|
||||
source_map = json.loads(regular_bytes(SOURCE_MAP))
|
||||
if source_map.get("schema") != "guanghu.language-protocol-source-map/v1":
|
||||
raise CanonError("SOURCE_MAP_SCHEMA_INVALID")
|
||||
if source_map.get("state") != "CURRENT_DYNAMIC_SOURCE_MAP":
|
||||
raise CanonError("SOURCE_MAP_NOT_CURRENT")
|
||||
selected = []
|
||||
errors = []
|
||||
for source in source_map.get("sources", []):
|
||||
if family != "ALL" and family not in source.get("families", []):
|
||||
continue
|
||||
try:
|
||||
selected.append(validate_source(source))
|
||||
except (OSError, UnicodeError, json.JSONDecodeError, KeyError, CanonError) as error:
|
||||
errors.append({"id": source.get("id"), "error": str(error)})
|
||||
ids = {item["id"] for item in selected}
|
||||
ordered = [item for item in read_order(family) if item in ids]
|
||||
classes = {item["source_class"] for item in selected}
|
||||
required_classes = {"BIRTH_AND_EVOLUTION_EVIDENCE", "CURRENT_WORLD_REGISTRY"}
|
||||
if family in {"ALL", "HLDP"}:
|
||||
required_classes.add("WORLD_CANONICAL_SOURCE")
|
||||
if family in {"ALL", "TCS"}:
|
||||
required_classes.update({"WORLD_STANDARD_DRAFT", "EXECUTABLE_ENGINEERING_DIALECT"})
|
||||
missing_classes = sorted(required_classes - classes)
|
||||
if missing_classes:
|
||||
errors.append({"id": "SOURCE_CLASS_COVERAGE", "error": f"MISSING:{missing_classes}"})
|
||||
return {
|
||||
"schema": "guanghu.language-protocol-canon-resolution/v1",
|
||||
"resolver_id": source_map["resolver_id"],
|
||||
"state": "PROTOCOL_CANON_RESOLVED" if not errors else "PROTOCOL_CANON_UNRESOLVED",
|
||||
"family": family,
|
||||
"world_architecture": {
|
||||
"world_standard": "GLS",
|
||||
"mother_and_cognitive_language": "TCS",
|
||||
"history_language": "HLDP",
|
||||
"communication_language": "GLP",
|
||||
"relationship": "TCS_IS_ROOT; HLDP_AND_GLP_ARE_ENGINEERING_LANGUAGE_BRANCHES; GLS_GOVERNS_NUMBERED_STANDARDS",
|
||||
},
|
||||
"lineage": [
|
||||
"NOTION_BIRTH_AND_EVOLUTION",
|
||||
"TOLARIA_CANONICAL_AND_STANDARD_SOURCES",
|
||||
"REPO_012_REGISTRATION_AND_READ_ONLY_MOUNTS",
|
||||
"ZERO_CORE_EXECUTABLE_TCS_DIALECT",
|
||||
"CODEX_HOST_PROFILE",
|
||||
],
|
||||
"selection_contract": source_map["selection_contract"],
|
||||
"read_order": ordered,
|
||||
"sources": selected,
|
||||
"errors": errors,
|
||||
}
|
||||
|
||||
|
||||
def main() -> int:
|
||||
parser = argparse.ArgumentParser()
|
||||
parser.add_argument("--family", choices=("ALL", "TCS", "HLDP", "GLS"), default="ALL")
|
||||
parser.add_argument("--json", action="store_true")
|
||||
parser.add_argument("--check", action="store_true")
|
||||
args = parser.parse_args()
|
||||
try:
|
||||
result = build(args.family)
|
||||
except (OSError, json.JSONDecodeError, KeyError, CanonError) as error:
|
||||
result = {
|
||||
"schema": "guanghu.language-protocol-canon-resolution/v1",
|
||||
"state": "PROTOCOL_CANON_UNRESOLVED",
|
||||
"family": args.family,
|
||||
"errors": [{"id": "RESOLVER", "error": str(error)}],
|
||||
}
|
||||
if args.json:
|
||||
print(json.dumps(result, ensure_ascii=False, indent=2))
|
||||
else:
|
||||
print(result["state"])
|
||||
for item in result.get("read_order", []):
|
||||
print(item)
|
||||
for error in result.get("errors", []):
|
||||
print(f"ERROR {error['id']}: {error['error']}", file=sys.stderr)
|
||||
return 0 if result["state"] == "PROTOCOL_CANON_RESOLVED" else 1
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
raise SystemExit(main())
|
||||
|
|
@ -0,0 +1,65 @@
|
|||
#!/usr/bin/env python3
|
||||
|
||||
import importlib.util
|
||||
import json
|
||||
import pathlib
|
||||
import subprocess
|
||||
import sys
|
||||
import unittest
|
||||
|
||||
|
||||
SCRIPT = pathlib.Path(__file__).with_name("resolve_protocol_canon.py")
|
||||
SHARED_ROOT = pathlib.Path("/Volumes/JZAO/HoloLake/persona-runtime/shared")
|
||||
CODEX_ROOT = pathlib.Path("/Users/bingshuolingdianyuanhe/.codex")
|
||||
SPEC = importlib.util.spec_from_file_location("protocol_canon", SCRIPT)
|
||||
MODULE = importlib.util.module_from_spec(SPEC)
|
||||
assert SPEC.loader
|
||||
SPEC.loader.exec_module(MODULE)
|
||||
|
||||
|
||||
class ProtocolCanonTest(unittest.TestCase):
|
||||
def test_all_families_resolve(self):
|
||||
result = MODULE.build("ALL")
|
||||
self.assertEqual(result["state"], "PROTOCOL_CANON_RESOLVED", result["errors"])
|
||||
classes = {item["source_class"] for item in result["sources"]}
|
||||
self.assertIn("WORLD_CANONICAL_SOURCE", classes)
|
||||
self.assertIn("CURRENT_WORLD_REGISTRY", classes)
|
||||
self.assertIn("EXECUTABLE_ENGINEERING_DIALECT", classes)
|
||||
self.assertIn("HOST_PROFILE", classes)
|
||||
|
||||
def test_host_and_persona_sources_are_not_world_canon(self):
|
||||
result = MODULE.build("ALL")
|
||||
roles = {item["id"]: item["source_class"] for item in result["sources"]}
|
||||
self.assertEqual(roles["ICE-P-ZY001-TCS-ENTRY"], "PERSONA_INSTANCE_SOURCE")
|
||||
self.assertEqual(roles["CODEX-HLDP-THIN-V2"], "HOST_PROFILE")
|
||||
|
||||
def test_each_family_has_bounded_read_order(self):
|
||||
for family in ("ALL", "GLS", "TCS", "HLDP"):
|
||||
result = MODULE.build(family)
|
||||
self.assertEqual(result["state"], "PROTOCOL_CANON_RESOLVED", result["errors"])
|
||||
self.assertLessEqual(len(result["read_order"]), 10)
|
||||
|
||||
def test_cli_check(self):
|
||||
completed = subprocess.run(
|
||||
[sys.executable, str(SCRIPT), "--family", "ALL", "--check"],
|
||||
capture_output=True,
|
||||
text=True,
|
||||
check=False,
|
||||
)
|
||||
self.assertEqual(completed.returncode, 0, completed.stderr)
|
||||
self.assertIn("PROTOCOL_CANON_RESOLVED", completed.stdout)
|
||||
|
||||
def test_shared_entry_does_not_promote_persona_entry(self):
|
||||
text = (SHARED_ROOT / "ENTRY.hdlp").read_text(encoding="utf-8")
|
||||
self.assertNotIn("canonical_tcs:", text)
|
||||
self.assertIn("protocol_canon:", text)
|
||||
self.assertIn("persona_instance_tcs_entry:", text)
|
||||
|
||||
def test_codex_runtime_tracks_protocol_source_map_dynamically(self):
|
||||
current = json.loads((CODEX_ROOT / "runtime/hldp-v1/CURRENT.json").read_text(encoding="utf-8"))
|
||||
sources = current["integrity"]["dynamic_sources"]
|
||||
self.assertTrue(any(item["path"].endswith("guanghu-language-protocol-canon/SOURCES.json") and "sha256" not in item for item in sources))
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
unittest.main()
|
||||
Loading…
Reference in a new issue