pip install pic-standard
# 예시 제안서를 검증합니다
pic-cli verify examples/financial_irreversible.json
...

pip install

| 필드 | 목적 |
|---|---|
`intent` | 에이전트가 하려는 것 |
`impact` | 위험 등급: `money`, `privacy`, `irreversible`, `compute`, ... |
`provenance` | 결정을 내리는 데 영향을 준 입력 (신뢰 수준 포함) |
`claims` + `evidence` | 에이전트가 주장하는 내용과 이를 뒷받침하는 증거 |
`action` | 실제 도구 호출 (도구 바인딩) |

**규칙:** 높은 영향도의 제안에 대해서는 최소한 하나의 주장이 **신뢰할 수 있는(trusted)** 출처의 증거를 참조해야 합니다. 실패 시 차단(Fail-closed).

PIC는 **실행 전 액션 검증 계약(pre-execution action-verification contract)**입니다. 이는 에이전트 안전 스택 내의 병렬 표면이며, 공유 기반 구조의 원시 요소가 아닙니다. PIC는 액션 경계에서 높은 영향도의 도구 호출을 *지금* 실행할 자격이 있는지 결정합니다. 실행 후 시스템(post-execution systems) — 양자 영수증(bilateral receipts), 서명된 감사 로그(signed audit logs), 신뢰/평판 점수(trust/reputation scores) — 은 이미 발생한 것을 기록하며 구조적으로 구별됩니다.

| 우려 사항 | PIC (실행 전) | 영수증 / 감사 / 평판 시스템 (실행 후) |
|---|---|---|
| 작동 시점 | 액션 실행 전 — 실패 차단 게이트(fail-closed gate) | 액션 실행 후 - 서명된 기록 |
| 결정 출력 | `allow` / `block` / `require-more-evidence` | 서명된 영수증, 로그 항목, 평판 변화량 (reputation delta) |
| 송금 차단 여부? | 예(Yes) | 아니요 — 발생했다는 것을 기록함 |
| 신뢰 모델 | 로컬 키링(Local keyring), 운영자 소유 루트(operator-owned roots), 주입 가능 리졸버(injectable resolver) | 종종 공유 신뢰 네트워크 또는 교차 조직 연합에 의존 |
| 위협 초점 | 프롬프트 인젝션, 환각(hallucination), 맹목적 도구 호출 | 감사 가능성(Auditability), 책임 소재(accountability), 사후 규정 준수(ex-post compliance) |
| 종속 표면 | 외부 전송 없음 — 완전히 로컬에서 실행 | 종종 공유 표준화 기반 구조, 평판 집계기 또는 외부 검증자 네트워크에 의존 |

PIC의 사전 실행 표면(pre-execution surface)은 의사 결정 측면에서 Article 12 스타일의 추적성(traceability)에 기여할 수 있습니다. 검증된 액션 제안(Action Proposal)은 구조화된 의사 결정 아티팩트이며, 고위험 AI 시스템의 기록 보관 및 로깅 아키텍처에 통합될 수 있습니다. PIC 자체만으로는 Article 12 준수를 의미하지 않으며, Article 12와 Article 19에서 요구하는 광범위한 시스템 수준의 로깅 및 보존 의무를 보완합니다. 동일한 기본 요소(primitives)에 바인딩된 사후 실행 증명 표면(post-execution attestation surface)은 `docs/attestation-object-draft.md`에 작성되어 있습니다.

또한, 설계상 로컬 우선(local-first)이며 운영자 통제(operator-controlled)를 유지합니다.

**간단한 규칙:** 시스템이 “이 액션을 실행해도 될까요?”라고 묻는 것이 PIC의 표면입니다. 만약 시스템이 “이 액션이 실행되었나요, 그리고 에이전트의 평판은 어떤가요?”라고 묻는다면, 이는 보완적인 사후 실행 표면이며, PIC가 그 안에 위치하는 계층(layer)은 아닙니다.

PIC는 결정론적 증거 검증을 지원합니다. 권한을 지닌 서명 증거(Authority-bearing signature evidence)는 구성된 키링(keyring)을 통해 검증되며, 일치하는 경우 `provenance[].trust`를 인메모리에서 업그레이드할 수 있습니다. 해시 증거(Hash evidence)는 참조된 바이트의 내용 무결성만을 확립하며, 그 자체만으로는 신뢰도를 업그레이드하지 않습니다. 자세한 내용은 `docs/spec-evidence.md` 섹션 8을 참조하십시오.

| 유형 | 설명 |
|---|---|
`hash` | 파일 아티팩트(`file://...`)에 대한 SHA-256 검증 |
`sig` | 신뢰 키링을 통한 Ed25519 서명 검증 |

Ed25519 서명 검증에는 `pip install "pic-standard[crypto]"`가 필요합니다.

전체 가이드: docs/evidence.md

**정규화(Canonicalization) (v0.8.0+):** PIC Canonical JSON v1 (PIC-CJSON/1.0)은 PIC가 JSON 값을 해시하거나 서명할 때 사용되는 바이트 단위의 직렬화 규칙을 정의합니다. 규범적 사양(normative spec)은 `docs/canonicalization.md`입니다.

; 순수 표준 라이브러리 참조 구현체는 `pic_standard.canonical`에 있습니다.
(`canonicalize()`,
`sha256_hex()`,
`intent_digest_hex()`

)). v0.8.0에서는 이는 추가적인 기능입니다. 기존의 서명 검증 경로는 v0.7.x와 마찬가지로 계속 작동하며, 어테스테이션 객체 기반 서명에 와이어링 캐노니컬라이제이션(wiring canonicalization)은 추후 릴리스가 예정되어 있습니다. Conformance vectors는 `conformance/canonicalization/` 아래에 위치합니다.

그리고 `PIC Conformance` CI 작업에서 모든 PR을 통해 실행됩니다.

서명 증거에는 만료 및 폐기 지원이 가능한 신뢰할 수 있는 공개 키들의 키링(keyring)이 필요합니다.

**사용자 정의 리졸버 (Custom resolvers) (v0.7+):** v0.7부터 신뢰 해상도(trust resolution)는 주입 가능하고 로컬 우선 방식입니다. PIC는 더 이상 서명당 기본 키링을 다시 로드하지 않으며, 사용자 정의 리졸버가 검증기(verifier)와 파이프라인에 직접 연결될 수 있습니다. 자체 신뢰 백엔드 또는 사전 로드된 신뢰 소스(HSM 기반 서비스, Vault 관리 키, 캐시된 원격 키링 등)를 사용하려면 `KeyResolver` 프로토콜을 구현하십시오:

`from pic_standard import KeyResolver, StaticKeyRingResolver`

**신뢰 제어 (Trust controls) (v0.9.0a2+):** `strict_trust=True`는 안전한 기본값입니다. 모든 인바운드 출처(provenance) 신뢰는 `untrusted`로 정리되며, 현재 서명 증거와 같이 권위가 있는 증거 검증만이 일치하는 출처 신뢰를 업그레이드할 수 있습니다. 레거시 호환 모드 (`strict_trust=False`)는 여전히 호출 가능하며 구성 시 `PICLegacyTrustModeWarning`을 방출합니다. 마이그레이션 가이드에 대해서는 docs/migration-trust-sanitization.md를 참조하십시오.

전체 가이드: docs/keyring.md

**Python 레퍼런스 구현:** 이 저장소는 PyPI에서 `pic-standard`로 게시되었습니다.**TypeScript 구현:** `pic-standard/pic-standard-ts`이며, `canonicalization`, `core`, 및 `trust_sanitization` 모드에 대한 공유 컨포먼스 코퍼스를 전달합니다. 이 저장소의 권고적 차분 CI는 `main`을 대상으로 하는 모든 PR에서 Python과 TypeScript 엔벨로프를 비교합니다.**다음 고가치 트랙:** Go와 Rust 구현입니다. 하나를 소유하고 싶다면 기여자 호출(call for contributors)을 참조하십시오.

graph TD
A[Shared conformance corpus] --> B[Python reference verifier]
A --> C[TypeScript verifier]
...

Guard any tool node with `PICToolNode`

:

`pip install "pic-standard[langgraph]"`

`PICToolNode`

이제 `verify_evidence`, `strict_trust`, `policy`, 그리고 `key_resolver`를 수락하여 전체 파이프라인 구성을 지원합니다 (v0.7.5+).

실패 시 닫힘(fail-closed) 기본값, 요청 상관관계(request correlation), DoS 제한, 증거 격리(evidence sandboxing) 기능을 갖춘 엔터프라이즈 도구 보호:

`pip install "pic-standard[mcp]"`

전체 가이드: docs/mcp-integration.md

OpenClaw AI 에이전트를 위한 TypeScript 플러그인 (`pic-gate`, `pic-init`, `pic-audit` 훅):

전체 가이드: docs/openclaw-integration.md

PIC 검증을 실패 시 닫힘 방식의 세 방향 라우팅(three-way routing)으로 Cordum 워크플로우 게이트 단계로 제공하는 Go Pack.

전체 가이드: docs/cordum-integration.md

Python 외 통합을 위해 PIC는 HTTP 브리지를 노출합니다:

범위, 위협 모델(threat model), 보안 속성(security properties), 적합성 수준(conformance levels), 그리고 선행 기술 차별화를 다루는 공식 명세서. SHA-256 지문 매니페스트를 가진 방어적 간행물로 발행되었습니다: `docs/RFC-0001.SHA256`

.

로컬에서 검증하기: `sha256sum -c docs/RFC-0001.SHA256`

**표준 어휘(Canonical Vocabulary)** — 외부 교차 참조 및 레지스트리에서 인용하는 PIC 용어의 권위 있는 용어집.

- Core verifier, CLI, schema, policy system
- 증거 검증 (Evidence verification) (SHA-256 해시 + Ed25519 서명)
- 앵커 통합(Anchor integrations) (LangGraph, MCP, OpenClaw, Cordum)
- 주입 가능한 키 해결 및 핫 패스 수정 (Injectable key resolution + hot path fix) (v0.7)
- 신뢰성 강화 및 증명 객체 초안 (Trust hardening + attestation object draft) (v0.7.5)
- 표준화 명세(Canonicalization spec) (PIC Canonical JSON v1) + 참조 구현 (reference implementation) (v0.8.0)
- 초기 적합성 스위트 (Initial conformance suite) (표준화 + 핵심 모드)와 CI 러너 (CI runner) (v0.8.0)
- `canonicalization`, `core`, 및 `trust_sanitization`을 위한 TypeScript 로컬 검증기

- Cross-implementation differential CI (Python 대 TypeScript 의미론적 래퍼)
- Evidence 모드 TypeScript 일치성
- Go/Rust 검증기 일치성
- 규범적 의미론 (MUST/SHOULD 사양 문서)
- OpenAPI 사양 + 가드 강화 (구조화된 감사 로그, 요청 상관관계)