**현재 상태 (2026-09-22 기준): 롤아웃 코드는 전체 경로 — genesis → fencing → registry → broker → PEP → supervision → translator → deployment — 에 걸쳐 구현되고 테스트되었습니다.** 모든 `src/` 패키지는 자체 테스트 스위트(Go 단위/통합 테스트, 감사 및 측정 도구용 Python)를 갖추고 있으며, `deploy/selftest/`는 배포 가이드를 처음부터 끝까지 실행합니다(**82개 제어, 0개 실패** — 코드와 어긋난 가이드는 운영자가 아니라 여기서 깨집니다). 현재 이 저장소에 대해 열려 있는 PR은 없습니다 — 진행 중이던 백로그(T25 제어된 성능 저하, T38 경계-비동기 레지스트리 내구성, T26 번역기 품질 측정)는 모두 병합되었습니다. 두 항목이 의도적으로 열린 상태로 추적되고 있으며, 둘 다 파일럿을 차단하지 않습니다: 나머지 프랑스어 문서의 영어 번역([#83](https://github.com/philippeabraxas-jpg/TBP-NETWORK/issues/83), 진행 중 — `deploy/`와 `docs/`의 대부분은 이미 영어 원본을 갖추고 있습니다, 위의 "언어에 관한 참고" 참조)과 도메인 간 계층(명세 §13 — 명세 자체에 의해 연기됨, [#33](https://github.com/philippeabraxas-jpg/TBP-NETWORK/issues/33)에서 추적되어 "연기됨"이 조용히 사라지지 않고 가시적으로 유지됩니다). 그 외에 의도적으로 **아직** 여기에 없는 것: 파일럿에서 구성될 언어별 네이티브 번역기 코퍼스(§15 — 이를 재생하고 게이트하는 파이프라인은 구축됨)와 인간 중재 에스컬레이션 경로(brokerd v1은 `structured` 번역기만 허용). `config/`를 있는 그대로 배포하지 마십시오 — 그곳의 모든 파일이 이를 명시적으로 말하고 있으며, 여기서도 반복할 가치가 있습니다. 이 롤아웃 코드가 준거하는 프로토콜도 골격이 아닙니다: `tbp4.2.1/`은 작동하는 코어(HSM 서명자, Merkle 감사 체인, OPA 정책 엔진, 테스트, 적대적 검토 프로세스)를 git 서브모듈을 통해 트리 내에 벤더링하며, 특정 커밋에 고정되어 있습니다 — 복사하거나 중복하지 않고 여기에 존재합니다.

## 구성 지침 — 어디서 시작할 것인가

구현 순서(§13)와 파일럿 P1 범위(§13, §9.1: 서버 VLAN 1개, Debian 라우터, 셀 2개, 802.1X, 중앙 레지스트리, 측정된 사용자 경험 회귀 = 0)에 기반하여:

1. **Genesis와 키** (§7.2, §3.2) — 무엇보다 먼저: 컨트롤러 쿼럼(m-of-n, HSM)이 서명하고 대역 외로 앵커링된 genesis 의식. [`scripts/genesis/`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/scripts/genesis)가 에포크-0 도구(개발 경로 포함)를 제공합니다; 의식 자체는 절차적이며 코드가 아닙니다 — 이 저장소의 어떤 것도 이를 대체하지 않습니다.
2. **클러스터 펜싱** (§7, §13 2단계) — 에포크 발급 및 회전, class-W 작업을 위한 컨트롤러 쿼럼(k-of-n), 미러/카나리 승격. 아래의 2-셀 P1 파일럿을 포함한 모든 다중 셀 배포 전에 필요합니다 — 단일 셀은 이를 연기할 수 있지만, 파일럿은 그럴 수 없습니다. [`src/cluster/`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/src/cluster)에 구현되어 있으며(단일 권한 에포크 추적기, 쿼럼, 수신 증명에 의한 승격 — 여기에 개인 키는 보관되지 않음) 브로커([`src/broker/`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/src/broker))에 연결됩니다.
3. **OPA + 레지스트리** — OPA를 설치하고, [`policies/README.md`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/policies/README.md)에 따라 `policies/capabilities.json`을 생성하고(배포 전에 `http.send`와 `time.now_ns`를 제거하십시오, 절대 후가 아닙니다; `validate_determinism.go`와 결정론 CI 게이트가 이를 강제합니다), `lab/docker-compose.yml`로 시작하여 로컬에서 규칙을 반복하십시오. 증명된 매니페스트와 측정된 부팅(§6.3, §13 3단계) — 셀의 결정이 증명 가능하기 전에 셀 자체의 상태가 증명 가능해야 합니다 — 은 셀 로그, 백프레셔, 앵커링과 함께 [`src/registry/`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/src/registry)에 구현되어 있습니다.
4. **PEP** — 최초의 진정으로 거버넌스되는 경계(§13), [`src/pep/`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/src/pep)에 구현됨: 토큰 검증(CWT/COSE, Ed25519), 메모리-바운드 fail-closed 안티-리플레이, 클럭-상태 성능 저하 모드, 실행 할당량, 그리고 계획-계약 게이트(§4.2, §13 4단계 — 토큰 검증만으로는 단일 작업을 거버넌스하며, 운영자가 실제로 서명하는 다단계 계획은 아닙니다). [`src/pep/README.md`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/src/pep/README.md)와 Debian 측 네트워크 리다이렉션을 위한 [`config/nftables/pep-redirect.nft`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/config/nftables/pep-redirect.nft)를 읽으십시오. **먼저 모니터 모드로 배포하십시오**(로그만, 차단 없음) — 첫 롤아웃에서 절대 `closed`로 하지 마십시오(교리 §5.3); 포스처 전환 절차는 [`deploy/monitor-to-closed.md`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/deploy/monitor-to-closed.md)입니다. PostgreSQL의 경우, 프로세스 내 2-훅 PEP는 [`src/pep/postgres-extension/`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/src/pep/postgres-extension)에 있습니다(§4.4).
5. **NAC 병행** — [`config/freeradius/`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/config/freeradius): 핸드셰이크와 동일한 PKI를 재사용하는 802.1X/EAP-TLS(§3), 스위치 수준에서 강제되는 fail-closed(RADIUS 측만이 아님), v1에서는 RADIUS 할당 VLAN 없음. `lab/tests/` netns 스위트는 fail-closed, MAB/IoT-VLAN, OCSP-교정 경로를 실행합니다.
6. **호스트 강화** — TBP 구성 요소(broker, PEP, registry)를 실행하는 모든 머신에서 [`config/sysctl/99-tbp-hardening.conf`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/config/sysctl/99-tbp-hardening.conf).
7. **번역기는 마지막** (§13) — 다른 모든 것이 안정된 후에. [`src/translator/`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/src/translator)에 제공됨: 런타임 강화(비-루트, cap-drop, seccomp — 이미지를 저장 시에 보호하는 `dm-verity`와는 구별되며, 런타임이 아님), 제어된 성능 저하 상태 머신(structured-only, 클라우드 폴백 없음), 품질 측정(`measure.py`가 코퍼스를 재생하고 FNR/FPR 회귀에 대해 CI를 게이트하며, `tmetrics`가 결과를 레지스트리 리프로 기록, T26, §4.5) — 코퍼스 자체는 파일럿에서 구성되며 여기에 제공되지 않습니다.
8. **다중 머신 배포** — [`deploy/apercu.md`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/deploy/apercu.md)가 진입점입니다(무엇을, 어디에, 왜, 전제 조건); 역할별 가이드(라우터, 셀, 서버, 슈퍼바이저)와 머신별 수락 체크리스트를 종합합니다. `deploy/selftest/`는 가이드를 **실행**합니다(`bash deploy/selftest/selftest.sh`, 82개 제어, fail-closed) — 실제 머신을 건드리기 전에 실행하십시오.

모든 단계에서 마찰 예산(§9.1)에 대해 측정하십시오 — 정확한 임계값과 실행 가능한 하네스는 [`tests/p1_friction/`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/tests/p1_friction)을 참조하십시오. 지연 시간이나 중재율이 이 임계값을 초과하면 다른 모든 것이 작동하더라도 파일럿은 실패합니다.

## 로드맵: 적정 규모의 배포 스케일

TBP는 복잡한 전규모 거버넌스 시스템입니다 — 클러스터 펜싱, 쿼럼, 독립 슈퍼바이저, 강화된 번역기, 개체 간 핸드셰이크. 모든 배포에 이 모두가 필요한 것은 아닙니다. "증명 가능하고 기록된 이유 없이는 어떤 AI 에이전트도 행동하지 않는다"를 원하는 단일 서버 소규모 비즈니스는 홈 네트워크에 SOC가 필요하지 않은 것처럼 2-셀 페일오버가 필요하지 않습니다. 계획은 이 저장소에 이미 존재하는 것을 **네 가지 배포 스케일**로 패키징하는 것입니다. 각 스케일은 이전 스케일의 엄격한 상위 집합입니다 — 동일한 프리미티브(fail-closed, 해시-전용 리프, closed 전에 monitor)를 일관되게 사용하며, 스케일이 올라갈수록 더 많이 연결되고, 보안 포스처 — 그리고 그것이 사들이는 운영 복잡성 — 도 그에 따라 증가합니다:

- **스케일 1 — 단일 머신.** 하나의 호스트, 하나의 거버넌스된 경계: 서비스 앞의 `pepd`, 로컬 OPA 사이드카, 단일 `CellLog` 레지스트리. 클러스터 펜싱 없음(셀 하나로 펜싱할 대상이 없음), NAC 없음(네트워크에 허용할 대상이 없음 — 박스 하나), 브로커나 슈퍼바이저 데몬 없음. Genesis는 단일 운영자 키페어로 축소되며, 쿼럼 의식인 척하지 않고 그렇게 문서화됩니다. 최저 운영 복잡성: OPA 규칙을 올바르게 작성하고, 모니터 모드로 배포하고, 마찰 예산을 관찰하고, `closed`를 획득하십시오.
- **스케일 2 — 소규모 팀 / 단일 사이트.** 하나의 `brokerd` 뒤에 있는 하나의 LAN에 연결된 소수의 머신, 여전히 단일 레지스트리(아직 펜싱 없음 — 이 규모에서는 하나의 권위 있는 셀로 충분), NAC 추가(`config/freeradius/`, 스위치에서 802.1X)로 머신을 세그먼트에 허용, 모든 곳에 호스트 강화 적용. 데몬 하나 더, 서브시스템 하나 더, 스케일 1과 동일한 레지스트리 모델.
- **스케일 3 — 복원력 있는 다중 셀.** 위의 파일럿 P1 배포로 이미 완전히 구축되고 문서화된 것: 2개 이상의 셀, 클러스터 펜싱(에포크 발급/회전, class-W 작업을 위한 k-of-n 쿼럼, 미러/카나리 승격), 읽기 전용 콘솔을 갖춘 독립 슈퍼바이저, 제어된 성능 저하를 갖춘 강화된 번역기, 전체 `deploy/` 가이드 시퀀스와 그 82개 제어 셀프테스트. 단일 셀 다운을 견딜 수 없는 조직, 또는 거버넌스되는 에이전트가 추가 머신을 정당화하는 조직을 위한 것.
- **스케일 full — 다중 개체.** 개체 간 핸드셰이크(§3): 동일 조직의 셀 간이 아니라 조직 경계를 넘어 정책, 이력 연속성, 라이브니스를 증명하는 것 — 서로를 신뢰하지 않으면서 서로를 신뢰해야 하는 독립적으로 거버넌스되는 TBP 배포 간의 페더레이션. 의도적으로 아직 시작되지 않음; [#33](https://github.com/philippeabraxas-jpg/TBP-NETWORK/issues/33)(T32)에서 추적되어 조용히 사라지지 않고 나중의 별개 단계로 가시적으로 유지됩니다. 이것은 진정으로 새로운 프로토콜 작업이며, 이미 존재하는 것을 실행하는 머신이 더 많은 것이 아닙니다.

**이것이 어디에 서 있는지에 대한 정직함**: 스케일 3은 이 README 전반에 사용된 파일럿-P1 이름으로 오늘 제공됩니다. 스케일 1과 2는 아직 자체 가이드로 패키징되지 않았습니다 — 문서화된 것의 하위 집합을 배포하여 오늘 도달할 수 있지만(스케일 1은 클러스터 펜싱과 NAC를 건너뛰고, 스케일 2는 NAC를 추가하되 셀 하나를 유지), 그 경로는 아직 문서화되지 않았으며, 현재 누군가가 동일한 교리에 따라 스스로 올바르게 연결하는 것을 막는 것은 없습니다. 스케일 full은 새로운 가이드가 아니라 실제 새로운 코드(§3의 세 가지 증명)를 필요로 합니다.

### 다음 계획된 작업

두 가지 작업 흐름으로, 서로 다른 종류의 노력이므로 별도 이슈로 추적됩니다:

1. **스케일별 배포 가이드, 그리고 각 스케일에 맞춰진 관리 도구** ([#86](https://github.com/philippeabraxas-jpg/TBP-NETWORK/issues/86)).
   위의 스케일을 `deploy/scale-1.md` / `deploy/scale-2.md`로 전환하는 것 — 스케일 3은 이미 가이드 시퀀스를 갖추고 있으며, 그것이 `deploy/apercu.md`와 그것이 종합하는 역할별 가이드입니다 — 이 절반입니다: "파일럿 가이드에서 건너뛸 것을 스스로 알아내는 것"이 아니라 스케일별로 문서화되고 셀프테스트로 커버되는 경로. 나머지 절반은 운영자 대상 도구로, 오늘날에는 읽기 전용 JSON API(`src/supervision/console.go`: `/v1/arbitration`, `/v1/epoch`, `/v1/indicators`)와 원시 파일 및 CLI(손으로 편집하는 Rego 정책, 배포 전에 검증하고 제거하는 `policies/gen_capabilities.sh` / `validate_determinism.go`; 테스트와 셀프테스트에서 실행되지만 브라우징 UI가 없는 `ChainWatcher`의 검증된 스캔으로 읽는 레지스트리)입니다. 이미 존재하는 것 위에 세 가지 전용 도구가 계획되어 있으며, 각각 주어진 스케일이 실제로 필요로 하는 것에 맞춰집니다(스케일-1 운영자는 다중 셀 중재 뷰가 필요하지 않고, 스케일-3 운영자는 필요합니다):
   - 기존 읽기 전용 콘솔 위의 **슈퍼비전 대시보드** — 인간 대상, 구조적으로 여전히 읽기 전용(§7.1 "슈퍼바이저는 모든 것을 보고, 아무것도 건드리지 않는다"가 변경 없이 이어짐, D81);
   - OPA Rego 번들용 **규칙/정책 편집기** — `validate_determinism.go`가 이미 강제하는 동일한 결정론 및 기능-제거 게이트에 대해 편집, 테스트, 배포된 것과의 diff를 수행하고, 그 후에야 프로덕션에 도달;
   - 레지스트리용 **감사 브라우저** — 리프 이력(`KindDecision`, `KindTelemetry`, `KindQuorum`, …)을 검색하고 필터링하며, `ChainWatcher`가 이미 프로그래밍 방식으로 수행하는 동일한 제3자 검증 가능 체크포인트 증명을 테스트 어서션이 아니라 인간 감사자가 읽을 수 있게 만듭니다.
2. **표준 정렬 — 독점적 정책 모델에서 상호운용 가능한 모델로** ([#87](https://github.com/philippeabraxas-jpg/TBP-NETWORK/issues/87)).
   TBP의 규칙 분류법(class F/I/W/OUT, §5.3), 감사 추적(해시-전용 Merkle-로깅된 리프, §6.2), 제어 세트(fail-closed, monitor-before-closed, 고위험 작업에 대한 쿼럼)는 오늘날 TBP-특정적입니다 — 내부적으로 일관되고 테스트되었지만, 감사자나 규제자가 이미 인식할 외부 프레임워크에 매핑되지 않았습니다. 작업은 이것이 어떤 기존(그리고 신흥) 표준에 매핑되는지, 그리고 격차가 어디에 있는지 식별하는 것입니다 — 먼저 그 매핑을 수행하지 않고 이들 중 어느 것이 적용된다거나 TBP가 이미 이를 충족한다고 가정하는 것이 아닙니다. 출발점으로 평가할 가치가 있는 후보: **ISO/IEC 42001**(AI 관리 시스템 표준 — "AI 거버넌스" 주장에 가장 적합), **NIST AI Risk Management Framework**, 고위험 시스템에 대한 **EU AI Act**의 로깅 및 인간 감독 의무(§4.1의 결정당-리프와 §4.2의 계획-계약 중재는 Article 12/14가 요구하는 것과 구조적으로 가깝습니다 — 미검증, 가정이 아닌 실제 매핑이 필요), **NIST SP 800-207**(Zero Trust Architecture — 명세는 이미 §3.3에서 TBP를 Zero Trust에 대조하여 위치시키며, 제어별 형식 비교가 자연스러운 다음 단계), **OSCAL**(NIST의 기계 판독 가능 제어/평가 형식 — TBP 자체 감사 추적이 맞춤형 리더를 요구하는 대신 표준 컴플라이언스 도구에 공급될 수 있게 하는 그럴듯한 내보내기 대상). 이것은 코드가 되기 전의 연구 및 명세 작업입니다: 산출물은 격차 분석이며, 실제 매핑이 존재하는 곳에서는 어댑터 코드나 문서화된 동등성 — 규칙 엔진의 재작성이 아닙니다.

## 라이선싱

서브트리별 이중 라이선스:
- **`docs/`와 `figs/`**: [CC BY 4.0](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/docs/LICENSE) — 저작자 표시와 함께 자유롭게 공유 및 각색 가능.
- **그 외 모든 것** (`config/`, `src/`, `policies/`, `lab/`, `tests/`, `deploy/`, `scripts/`, `.github/`): [Apache 2.0](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/LICENSE) — [Responsible-Alliance-Protocol](https://github.com/philippeabraxas-jpg/Responsible-Alliance-Protocol)의 코어 프로토콜과 동일한 라이선스. 이 코드는 초기 파일럿 단계 동안 클로즈드 라이선스였습니다; 그 단계는 끝났습니다 — 프로젝트는 혼자 구축해서는 실행 가능하지 않으며, 자체 교리가 "결코 신뢰로, 항상 검증 가능한 증명으로"인 거버넌스 프로토콜이 자체 구현에 대해 신뢰를 요구해서는 안 됩니다.

기여 방법 — 이제 문서뿐 아니라 코드도 포함 — 과 명세 편집 시 따라야 할 규칙(용어 정규화, 검증된 인용, 체인지로그)은 [`CONTRIBUTING.md`](https://github.com/philippeabraxas-jpg/tbp-network/blob/main/CONTRIBUTING.md)를 참조하십시오.