퍼블리시 게이트 + 빈 산출물 덮어쓰기 금지
공개/공유 데이터 파일을 자동 커밋하는 잡에서 게이트 통과 ≠ push 가능, 수집 실패 ≠ 빈 파일로 덮어쓰기를 분리한다.
1) Pre-push publication gate
# 개념: origin/main 대비 워킹트리/ahead 커밋 검사
python agent/publication_gate.py --base origin/main
# exit 0 = PASS, exit 2 / PUBLICATION HOLD = hold (push 금지)게이트 PASS 후에도 git push 403이면 자격 증명/ACL 문제 — GitHub-Fine-Grained-PAT-Contents-Write-Probe.md (remote 임베디드 PAT vs env GH_TOKEN 불일치 포함).
2) Empty overwrite guard
외부 API/시드 확장이 비어 점수 미달 → candidates=[] / items=[]일 때:
- 공개 큐 파일을 빈 내용으로 커밋하지 않는다 (마지막 정상 생성분을 보존).
- 원인(미설정 env, 쿼터, 스키마)을 로그·티켓에 남기고 재실행 조건을 명시한다.
적용 체크
- 게이트 스크립트가 CI/스케줄 push 직전에 있는가?
- “변경 없음 / 빈 결과”와 “안전한 갱신”을 구분하는가?
- push 실패를 게이트 실패와 혼동하지 않는가?
분기·스택 운영
- 로컬
main이 미공개 Pass 스택으로origin/main과 diverge면, curation/radar 잡은origin/main에 detach → 작업 →push HEAD:main→ 로컬 스택 checkout으로 보존한다. Pass 스택을 curation에 ff-only merge하지 않는다. dirty leftoveragent/cron/WIP가 이미 PR로 들어갔으면 ff-only pull 전에 정리. preserve branch는 백업일 뿐 ship 경로가 아니다. - 대안 (스택을 살린 채 ship):
git branch agent/pass-stack-preserve-YYYYMMDD로 백업한 뒤origin/main에 rebase(충돌 0이면 콘텐츠 게이트 → ship). rebase 충돌이 있으면 detach 경로로 되돌린다. - Pass 스택 rebase/fixup 후 people slug가 바뀌면 stance·링크를 remap하고 깨진/org/unknown stance 라인은 drop한 뒤 게이트를 다시 돌린다.
- 검색엔진 결과 URL은 allowlist 출처가 아니다 — 게이트 PASS 이후에도 검색 URL 출처는 공개 본문에서 제거한다.
- bare 호스트만의 출처는 부족 —
naver.com처럼 기사/프로필 경로 없는 도메인만으로는 allowlist 출처로 쓰지 않고 drop한다. - 콘텐츠 diff 0 → commit/push 없음: curation·hygiene 후 워킹트리·인덱스에 실질 변경이 없으면 no-op으로 종료한다(빈 커밋 금지).
- clean main → Done without push:
publication_gate.py --base origin/mainexit 0이고 unpublished diff가 비어 HEAD=origin/main이면 push·Hugo를 스킵해도 야간 게이트는 성공(Done) 으로 마감한다(실패 아님). - 약한 중립(weak-neutral): 신원·SSoT가 부족한 stance는 hold만 하지 말고 drop. org/unknown·SSoT-없는 slug와 같은 축.
- yaml↔wiki orphan 0을 유지하려면 stub yaml 추가 시 최소 wiki stub도 같이 seed. SSoT 카운트는
yaml==wiki로 맞춘다. - 게이트 PASS ≠ content-safe:
/people/unknown, org-as-person stance, 이슈 slug를 인물로 쓴 stance, 약한 중립(발언 미확인), 역할·신원 오인 stub는 추가 strip. people promote는 allowlisted 공식/프로필 URL(≥1)이 있을 때만; wiki-only·비허용 호스트·검색 URL·직원명단 미기재 go.kr는 부족. 애매한 기자·통신원·특파원·동명이인·역할 불일치·비인물(학교·부처 등)은 hold. - 게이트 스크립트 ≠ 전체 리뷰:
publication_gate.py는 zero-stance ongoing issue만 차단한다. 야간 전체 리뷰는 별도로/people/unknown,/people/tmp, 깨진**입장**줄, SSoT 없는 slug를 잡아야 한다. - 깨진 입장 줄 수리:
**입장**이 slug 라벨이거나 영문 source 표기이면, 같은 출처 이슈의 중립 문장으로 바꾼 뒤 게이트를 다시 돌린다. 새 입장을 쓰지 않는다. - Hugo 없음 + 입장 한 줄: 사이트 빌드 바이너리가 없으면 빌드를 건너뛴다(실패 아님). 마감 기준은 게이트 exit 0 그리고 링크·SSoT orphan 0이다.
- 야간 fixup 패턴: 해석 불가 actor 링크는 drop; 알려진 slug 오타는 기존
data/people로 remap; stub는 이미 출처가 있는 실명 인물에만 추가. 지자체·기관·기사 제목을/people/*로 발행하지 않는다(실인물 SSoT 필수). - stub→curated 승격 축: allowlist URL이 같은 사람·같은 직을 가리킬 때만. 역할 라벨이 틀린 stub(예: 「위원장」인데 실제는 연구위원)는 역할을 정정한 뒤 승격하거나 hold.
- 동명이인 함정: allowlist 호스트 URL이 다른 사람(같은 이름, 다른 직/기관)이면 콘텐츠 안전 실패 — 그 URL을 promote에 붙이지 않는다. 기초의원·명단 URL만으로 승격하지 않는다.
- 직원명단 미기재: 성명이 직원명단/조직도에 없으면
go.kr등 허용 호스트여도 승격 근거로 쓰지 않는다. 직위만 있고 이름이 없는 페이지도 동일. - 목표 미달 ≠ 강제 승격: 잔여 stub가 목표 구간(예: 20–30, 백로그가 허용하면 ~30 승격) 아래여도 안전 출처가 없으면 부족 건수와 함께 Done으로 끝낸다(강제 승격 금지). 동명이인·역할 불일치(예: 서울청장 vs 가스공사 사장)는 allowlist URL이 있어도 reject. 정치 인물 본문은 org-wiki에 합성하지 않는다(후보 제품 vault 정본).
- people slug remap: collapse/접두 규칙(
lee→i,park→bak,kim→gim,jung→jeong) +name_ko매칭으로 정규화한 뒤 stance·링크를 고친다(예: unknown 김기재 →gimgijae). 로마자 비정규 slug도 같은 축 — 로마자만 보고 유지하지 말고name_ko로 remap(예:yuhyoshang→yu-hyo-sang,lee-man-hee→i-man-hui, Pass 스택 잔여lee-jaemyung·yonghyein·oh-geoho,/people/unknown).pending같은 placeholder slug는 실명 slug로 remap하거나 drop. - stance 링크는 yaml+wiki 동시 존재 필수: 한쪽에만 있으면 orphan/깨진 링크. remap·drop 후 yaml↔wiki orphan 0을 재확인한다.
- 공개 전 제거: placeholder/unknown·SSoT 없는 slug·불완전 신원 stub·기관을 people로 링크한 stance.
- Pass D가 people YAML을 추가하면 최소 wiki stub도 같이 seed해 yaml↔wiki orphan 0을 유지한다. 로컬 Pass 스택이 yaml-only people stub를 추가하면 publication-safety 전에 매칭 wiki shell을 seed해 slug 정렬을 맞춘다. 약한 중립 줄을 drop해도 orphan 0을 깨지 않게 stub를 함께 맞춘다.
http.extraheader+ remote에 박힌 토큰이 401이면, env 토큰을 URL에 넣은 한 번의 push로 충분하다 — GitHub-Fine-Grained-PAT-Contents-Write-Probe.md.- meta/stub+stance만 갱신하는 잡에서 사이트 빌드 바이너리(예: Hugo)가 없으면 빌드를 스킵해도 된다 — 게이트·pytest가 정본이다.
- issue-radar → today 발행: empty-overwrite guard 통과 후에만 공개 큐(
today.yaml등)를 커밋·push하고, 승인 티켓은 만들지 않는다. 커밋 범위는 공개 큐 파일만(캐시/리포트 MD 제외). 스케줄 보고는 제품 프로젝트 Done 티켓으로만 남긴다. - radar ≠ auto-close: closure audit가 성숙한 이벤트 이슈를 편집자 모니터링용으로 표면화할 수는 있으나, radar가 이슈를 자동 종료하지 않는다.
- 점수 게이트 ≠ 출처 게이트: empty-overwrite는
items=[]만 막는다. 점수 임계(예: ≥4)를 넘은 후보는 보도 0건·출처 목록이 비어도 공개 큐에 남을 수 있다. 출처가 필수면 점수와 별도로 source-nonempty 게이트를 둔다. 이 분기는 가드 실패가 아니다. - 공개 today 큐는 중립만: 내부 승인 상태·스케줄/도구명을 노출하지 않는다. 후보·이슈 큐 페이로드만 게시한다.
- publication-safety 잡은 push 직전·직후
publication_gate.py --base origin/mainPASS를 남기고, Pass 스택은 preserve 브랜치 또는 detach 경로로 다룬다(§분기·스택 운영). people curation은 Pass issue-stance 스택을 preserve 브랜치에 두고origin/main에 detach해 작업·push한 뒤 로컬 스택을 rebase한다. - hygiene 패턴(2026-09-01): SSoT slug alias remap, non-SSoT/org person 링크 delink, weak misattribution stance drop — publication 시점에 people stub를 새로 invent하지 않는다(slug shell이 이미 있을 때만).
Ops log 2026-11-09···10 (candidate schedules)
- publication-safety factory restore: cron
0 18 * * *UTC = 03:00 KST. unpublished Pass diverge →origin/maindetach; Pass ff-merge 금지; HOLD=no push; clean main+empty unpublished+gate exit 0 → Done without push/Hugo. - 2026-11-10 gate: fetch → main behind only →
pull --ff-onlyto0c957763→publication_gate.py --base origin/mainexit 0 PASS (zero-stance ongoing blockers 없음). HEAD=origin/main, unpublished empty → Done without push/Hugo. - people-ssot-curation factory restore: cron
0 9 * * *UTC = 18:00 KST. stub→curated는 allowlisted official/profile URL ≥1일 때만; 부족≠실패. empty content diff → commit 금지. Pass ff-merge 금지. - 2026-11-09 curation: base
origin/mainff-only; push SHAbf23cc3b; stub→curated 0 (잔여 stub 31 전부 official/profile URL 없음); hygiene delink/people/jeong-bu(정부),/people/bae-jae-go(배재고); yaml↔wiki orphan 0. - issue-radar-today 2026-11-10:
issue_radar.py run→publish_today.pyexit 0; empty-overwrite 미발동(10 items). push onlywiki/data/today.yamlSHA4428431c…;generated_at2026-11-09T23:0xZ. No Leantime write; cache/report MD 제외. - source N/A: Pass A
is_valid_source_url+ Hugo render-link 가드 — Candidate-Source-URL-NA-Guard.md.
Ops log 2026-11-11 (candidate schedules)
- publication-safety: main already
55d1f459==origin/main;publication_gate.py --base origin/mainexit 0 PASS; unpublished empty → Done without push/Hugo. - people-ssot-curation 18h (2026-11-10): ff-only to
55d1f459; stub→curated 0; residual stub 32 (allowlist URL 없음) → 부족≠실패; content diff 0 → no commit. Hold: org 3 · journalist/weak 14 · no URL 15(incl.i-si-ba). yaml↔wiki orphan 0. pytest slug+stance links 2 passed. - issue-radar-today: items=10; empty-overwrite 미발동; push only
wiki/data/today.yamlSHA9dbd58d9…;generated_at2026-11-10T23:01:10Z. No Leantime.
🔗 관련 문서
- GitHub-Fine-Grained-PAT-Contents-Write-Probe.md
- Hugo-External-Link-New-Tab.md
- Wiki-Synthesis-Policy.md
Ops 2026-11-12
- publication-safety: exit 0 PASS; clean-main (HEAD=
fb3db2c9==origin/main) → Done without push/Hugo. - issue-radar-today: items=10;
wiki/data/today.yamlonly SHA68757f34; empty-overwrite 미발동. - people-ssot 2026-11-11: stub→curated 0; residual stub 31 (allowlist URL 부족≠실패); content diff 0 no-op.
Ops 2026-11-12···13
- publication-safety 2026-11-13: exit 0 PASS; clean-main HEAD=
6f3eaef3==origin/main → Done without push/Hugo. - issue-radar-today 2026-11-13: items=10;
wiki/data/today.yamlonly SHAe4581e05…; empty-overwrite 미발동;generated_at2026-11-12T23:01:07Z. - people-ssot 2026-11-12 18h: stub→curated 0; residual stub 31 (allowlist URL 부족≠실패); content diff 0 no-op.
- escalation drain 2026-11-12: pending 15 → usable 0 → processed; PR skip = AC (Candidate-Source-URL-NA-Guard.md).
Ops 2026-11-13···14
- publication-safety 2026-11-14: exit 0 PASS; clean-main HEAD=
0d19f300==origin/main → Done without push/Hugo (ticketb5e06d9c). - issue-radar-today 2026-11-14: items=10;
wiki/data/today.yamlonly SHA3fad5c50…; empty-overwrite 미발동;generated_at2026-11-13T23:01:42Z; PM Intent pass3dc67547. - people-ssot 2026-11-13 18h: stub→curated 0; residual stub 34 (allowlist URL 없음) → 부족≠실패; content diff 0 no-op (ticket
fa80ac61). - escalation drain 2026-11-13: pending 17 → usable 0 (
no_person_mention9 ·no_source_url8) → processed; PR skip = AC.
Ops 2026-11-14···15
- publication-safety 2026-11-15: exit 0 PASS; clean-main HEAD=
9125f417==origin/main → Done without push/Hugo (ticketde3d1bd9). - issue-radar-today 2026-11-15: items=7;
wiki/data/today.yamlonly SHA12af427b…;generated_at2026-11-14T23:01:34Z; empty-overwrite 미발동; PM Intent pass6b05e84a. - people-ssot 2026-11-14 18h: stub→curated 0; residual stub 38 (allowlist URL 없음) → 부족≠실패; content diff 0 no-op (ticket
bfd8085c). Hold: org/non-person 6 · journalist/weak 16 · no-URL 15(incl.i-si-ba) · role ambiguous 1 (jo-deon). - escalation drain 2026-11-14: pending 9 → usable 0 → processed; PR skip = AC.
Ops 2026-11-15···16
- publication-safety 2026-11-16: exit 0 PASS; clean-main HEAD=
12af427b==origin/main → Done without push/Hugo (ticketc9e41caa). - issue-radar-today 2026-11-16: items=7;
wiki/data/today.yamlonly SHA386523aa…;generated_at2026-11-15T23:01:09Z; empty-overwrite 미발동 (ticket197efc6c). - people-ssot 2026-11-15 18h: stub→curated 0; residual stub 38 (allowlist URL 없음) → 부족≠실패; content diff 0 no-op (ticket
90f49986). Hold: org/non-person 6 · journalist/weak 10 · no-URL 21(incl.i-si-ba) · role ambiguous 1 (jo-deon). pytest slug+stance 2 passed.
Ops 2026-11-16···17
- publication-safety 2026-11-17: exit 0 PASS; clean-main HEAD=
386523aa==origin/main → Done without push/Hugo. - issue-radar-today 2026-11-17: items=10;
wiki/data/today.yamlonly SHAf5bb1eb5…;generated_at2026-11-16T23:01:06Z; empty-overwrite 미발동.