feat(studio-save): 그림 쪽에도 다리를 놓는다
문장 쪽에는 놨는데 그림 쪽에는 안 놨다. 화살표를 뒤집어도 관문이 전부 0 이고 경고도 비어 자동 통과했다. 설계가 「SVG 의 스크립트·외부 리소스는 저장 단계의 허용 정책으로 제한한다」고 적었는데 그 정책이 코드로 어디에도 없었다. 화살표 방향은 사람이 봐야 하지만 스크립트가 들어 있는지는 문자열로 판정된다 — 그림 쪽에서 기계가 할 수 있는 유일한 일이라 error 로 막는다. script·foreignObject·이벤트 처리기·바깥 href·바깥 리소스·@import 여섯이다. #fragment 와 data: 는 바깥으로 안 나가므로 막지 않는다. 그림이 검토 뒤에 바뀌면 경고로 올린다. 무엇이 바뀌었는지는 기계가 못 말하지만 바뀌었으니 보라는 말할 수 있다. 이것이 들어가면서 읽기 계약이 그림에도 걸린다. 실제 흐름과 개념 설명을 data-figure-kind 로 가른다. 표시가 없으면 error 가 아니라 warning 이다 — 지금 저장소의 그림 272장에 이 표시가 하나도 없고, 없다고 전부 막으면 정상을 막는 쪽으로 넘어간다. 설명용이라 밝힌 그림도 막지 않는다. 검사기를 조일 때마다 정상이 통과하는 대조를 같이 넣는다. 이번 대조군은 평범한 그림, 설명용이라 밝힌 그림, 내부·data 참조, 그리고 이 저장소의 그림 272장 전부다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Q4vKjQo9KKBBokzxqXLCfk
This commit is contained in:
DongHyeonka
co-authored by
Claude Opus 5
Claude Opus 5
parent
f1637ee532
commit
a5215eda31
+87
-1
@@ -68,10 +68,84 @@ FIELD_MAP = {
|
||||
BODY_START, BODY_END = "<!-- body:start -->", "<!-- body:end -->"
|
||||
|
||||
|
||||
# SVG 에서 **문자열로 판정되는 것**. 사람 판단이 필요 없으므로 error 로 막는다.
|
||||
# `plan/01` §8 이 「SVG 의 스크립트·외부 리소스는 저장 단계의 허용 정책으로 제한한다」고
|
||||
# 적었는데 그 정책이 코드로 어디에도 없었다. 화살표 방향은 사람이 봐야 하지만
|
||||
# 스크립트가 들어 있는지는 안 그렇다 — 그림 쪽에서 기계가 할 수 있는 유일한 일이다
|
||||
SVG_FORBIDDEN = (
|
||||
(re.compile(r"<\s*script\b", re.I), "스크립트가 들어 있다"),
|
||||
(re.compile(r"<\s*foreignObject\b", re.I), "foreignObject 는 임의의 HTML 을 싣는다"),
|
||||
(re.compile(r"\son[a-z]+\s*=", re.I), "이벤트 처리기 속성이 있다"),
|
||||
# 따옴표는 \x22 \x27 로 적는다. 정규식 안에 두 종류를 함께 쓰면 파이썬 문자열이 먼저 닫힌다
|
||||
(re.compile(r"(?:xlink:)?href\s*=\s*[\x22\x27](?:https?:)?//", re.I),
|
||||
"바깥 주소를 가리킨다"),
|
||||
(re.compile(r"<\s*(?:image|use)\b[^>]*(?:xlink:)?href\s*=\s*[\x22\x27](?!#|data:)", re.I),
|
||||
"바깥 리소스를 불러온다"),
|
||||
(re.compile(r"@import\b", re.I), "바깥 스타일을 불러온다"),
|
||||
)
|
||||
|
||||
# 그림이 **실제 흐름**을 그린 것인지 **개념 설명**인지. `plan/01` §8 이 표시하라고 적었다.
|
||||
# 없으면 error 가 아니라 warning 이다 — 지금 저장소의 그림 272장에 이 표시가 없고,
|
||||
# 없다고 전부 막으면 정상을 막는 쪽으로 넘어간다
|
||||
FIGURE_KIND = re.compile(
|
||||
r"data-figure-kind\s*=\s*[\x22\x27](evidence|illustrative)[\x22\x27]", re.I)
|
||||
|
||||
|
||||
class Refused(Exception):
|
||||
"""어댑터가 스스로 거절한 것. 서버 오류가 아니다."""
|
||||
|
||||
|
||||
def inspect_svg(path: str) -> tuple[list[str], str | None]:
|
||||
"""(막아야 할 것, 그림 종류). 종류를 못 읽으면 None."""
|
||||
try:
|
||||
text = open(path, encoding="utf-8", errors="replace").read()
|
||||
except OSError as e:
|
||||
return [f"열지 못했다: {e}"], None
|
||||
hits = [why for pat, why in SVG_FORBIDDEN if pat.search(text)]
|
||||
m = FIGURE_KIND.search(text)
|
||||
return hits, (m.group(1).lower() if m else None)
|
||||
|
||||
|
||||
def inspect_assets(package: dict) -> tuple[list[dict], list[dict]]:
|
||||
"""그림을 본다. 막는 것과 읽어야 할 것을 나눠 낸다.
|
||||
|
||||
**바뀐 것이 무엇인지는 기계가 못 말한다. 바뀌었으니 보라는 말할 수 있다.**
|
||||
화살표를 뒤집어도 `gates` 는 전부 0 이고 `warnings` 도 비어 자동 통과했다. 문장 쪽에는
|
||||
다리를 놨는데 그림 쪽에는 안 놨던 자리다.
|
||||
"""
|
||||
errors, warnings = [], []
|
||||
for asset in package.get("assets") or []:
|
||||
rel = asset.get("path", "")
|
||||
full = os.path.join(ROOT, rel)
|
||||
if not asset.get("exists") or not rel.endswith(".svg"):
|
||||
continue
|
||||
hits, kind = inspect_svg(full)
|
||||
for why in hits:
|
||||
errors.append({"id": "그림 허용 정책", "asset": rel, "detail": why})
|
||||
now = _sha256_file(full)
|
||||
if asset.get("sha256") and now != asset["sha256"]:
|
||||
warnings.append({
|
||||
"id": "그림이 검토 뒤에 바뀌었다", "asset": rel,
|
||||
"detail": f"검토 시점 {asset['sha256'][:12]} → 지금 {now[:12]}",
|
||||
"note": "무엇이 바뀌었는지는 이 어댑터가 말하지 못한다. "
|
||||
"화살표 방향·주체는 사람이 그림을 열어 봐야 안다",
|
||||
})
|
||||
if kind is None:
|
||||
warnings.append({
|
||||
"id": "그림 종류가 표시돼 있지 않다", "asset": rel,
|
||||
"detail": 'data-figure-kind="evidence" 또는 "illustrative" 가 없다',
|
||||
"note": "실제 흐름을 그린 것인지 개념 설명인지 못 가린다. "
|
||||
"설명용을 증거로 읽는 것을 막을 수 없다",
|
||||
})
|
||||
elif kind == "illustrative":
|
||||
warnings.append({
|
||||
"id": "설명용 그림", "asset": rel,
|
||||
"detail": "data-figure-kind=\"illustrative\" — 실제 흐름이 아니라 개념 설명이다",
|
||||
"note": "막지 않는다. 밝힌 대로 읽히는지만 검토가 본다",
|
||||
})
|
||||
return errors, warnings
|
||||
|
||||
|
||||
def _sha256_file(path: str) -> str:
|
||||
with open(path, "rb") as fh:
|
||||
return hashlib.sha256(fh.read()).hexdigest()
|
||||
@@ -334,6 +408,10 @@ def main() -> int:
|
||||
if not os.path.isfile(p):
|
||||
raise Refused(f"그런 파일이 없다: {p}")
|
||||
pkg = approved(args.record, args.package)
|
||||
asset_errors, asset_warnings = inspect_assets(pkg)
|
||||
if asset_errors:
|
||||
raise Refused("그림 허용 정책에 걸린다 — 저장 단계에서 막는다\n " +
|
||||
"\n ".join(f"{e['asset']}: {e['detail']}" for e in asset_errors))
|
||||
doc = build_input(args.record)
|
||||
steps = plan_requests(args.record, doc, args.document_id, args.expected_version)
|
||||
|
||||
@@ -354,10 +432,14 @@ def main() -> int:
|
||||
"approvedAgainst": pkg["target"]["sha256"],
|
||||
"checkerVersions": pkg.get("checkerVersions"),
|
||||
"requests": steps,
|
||||
"warnings": asset_warnings,
|
||||
"notes": [
|
||||
"이 파일의 요청을 아직 보내지 않았다. mode 가 plan 이다.",
|
||||
"게시·게시취소 경로는 이 어댑터가 만들지 않는다. 계획에 들어 있으면 거절한다.",
|
||||
"자격증명은 환경 변수 자리표시자로만 적혀 있다. 값은 이 저장소에 없다.",
|
||||
"**warnings 가 비어 있어야 자동 통과다.** 관문이 전부 통과해도 그것만으로는 "
|
||||
"아니다. 그림이 검토 뒤에 바뀌었다는 경고는 무엇이 바뀌었는지 말하지 못한다 — "
|
||||
"화살표 방향과 주체는 사람이 그림을 열어 봐야 안다.",
|
||||
],
|
||||
}
|
||||
text = json.dumps(plan, ensure_ascii=False, indent=2) + "\n"
|
||||
@@ -365,7 +447,11 @@ def main() -> int:
|
||||
os.makedirs(os.path.dirname(os.path.abspath(args.out)), exist_ok=True)
|
||||
open(args.out, "w", encoding="utf-8").write(text)
|
||||
ops = " · ".join(f"{s['op']} {s['method']}" for s in steps)
|
||||
print(f"{args.out} — {ops} · 무인 저장 {'켬' if UNATTENDED_SAVE_ENABLED else '끔'}")
|
||||
print(f"{args.out} — {ops} · 그림 {len(pkg.get('assets') or [])}장 "
|
||||
f"· 경고 {len(asset_warnings)}건 "
|
||||
f"· 무인 저장 {'켬' if UNATTENDED_SAVE_ENABLED else '끔'}")
|
||||
if asset_warnings:
|
||||
print("경고는 통과가 아니다. 근거를 읽는 검토가 항목마다 판정한다", file=sys.stderr)
|
||||
else:
|
||||
print(text, end="")
|
||||
return 0
|
||||
|
||||
Reference in New Issue
Block a user