Execution Control Plane · 구조도

Airlock▉

실행을 게이트하는 문. 실행 전에 막고, 실행 후에 증명하고, 그 위에 운영 지식을 쌓는다.

airlock 코어 ~4,510 LOC oce 지식 계층 ~1,239 LOC 293 tests green 런타임 의존성 0
# authorized_keys — 운영자는 이 문 하나로만 들어온다 (CA 단기 인증서로 서명)
restrict,pty,command="airlock gateway shell --user alice" ssh-ed25519 AAAA…
요청 한 건의 여정 · 문 → 게이트 → 실행 → 잎 → 감사 → 지식
운영자operator

사람 또는 AI 에이전트 — 같은 문, 같은 게이트

자기 키로 ssh. 대상의 자격증명은 끝내 보지 못한다. 타이핑한 명령이든 AI가 제안한 명령이든 출처와 무관하게 동일한 판정을 받는다.

문door

지나지 않고는 서버에 닿을 수 없다 — 강제의 성립 지점

sshd 강제 명령이 셸 대신 게이트웨이를 띄우고, ACL이 접근 가능한 대상만 노출한다. 대상 ssh 스펙은 자격증명 브로커링으로 감춰지고, 운영자 신원은 CA 단기 인증서(force-command를 서명 안에, TTL=회수)로 못 박힌다.

gateway.py 90 targets.py 70 certs.py 153
게이트gate

다층 결정론 판정 — 심각도 max 병합

규칙(정규식) → script(스크립트 인라인 스캔) → argv(확장 후 표기 변형, 불투명 fail-closed) → context(맥락) → advisory(AI 자문). 앞 네 층은 결정론이라 감사·재현 가능하고, gate.py가 세 진입점(REPL·TUI·웹)을 같은 순서로 통과시킨다.

· ALLOW 실행 ! WARN 경고 후 실행 ? CONFIRM 승인(y/N) × BLOCK 실행기 미도달
gate.py 48 rules.py 139 argv.py 203 context.py 153 advisory.py 44 guide.py 138 scan.py 204 masking.py 38

AI는 판정하지 않는다 — 자문 층조차 bool만 내고 상한은 CONFIRM. Verdict는 언제나 결정론 코드가 만든다. LLM이 없으면 게이트는 그대로(fail-safe).

브로커·실행broker & exec

REPL이 파싱→판정→실행을 중개, 백엔드가 어디서 실행할지 추상화

커맨드 브로커가 실행 상류에 서서 한 줄을 직접 중개한다. 같은 게이트 위에 세 얼굴(터미널 REPL·풀스크린 TUI·웹 콘솔). 실행 대상은 local / container / ssh 교체 가능 — 컨테이너 리허설을 실서버로 승격(promote).

terminal.py 295 console.py 369 tui.py 327 backends.py 362 promote.py 64
잎leaf enforcer

게이트가 못 본 둘째 홉을 대상 커널에 위임

vim :!rm -rf / · find -exec rm 처럼 대상에서 스폰돼 라인에 없는 실행은 AppArmor/seccomp가 커널에서 거부하고, 그 차단을 정규화해 우리 해시체인 감사에 흡수한다 — 게이트가 못 봐도 잎이 막고 세션에 남는다.

leaf.py 130 apparmor/airlock-container.profile seccomp/airlock-nodelete-demo.json

↳ 흡수 recorder.record_leaf_denial → 아래 감사 체인으로

감사audit · source of truth

append-only 해시체인 — 변조 방지의 진실의 원천

명령 하나에 레코드 둘: 움직이기 전 intent, 끝난 뒤 outcome (executed/blocked/rejected/error + 종료코드). 결과 없는 명령은 "미상"으로 남고 그 침묵이 증거가 된다. 각 레코드가 직전 해시를 품어 중간 변조 시 체인이 깨진다.

recorder.py 125 audit.py 244 events.py 41 summary.py 192 replay.py 53

↳ 읽기 web.py · api.py · web-next(Next.js) — 감사를 브라우징하는 표현 계층

지식 계층operation-context-engine · oce

해시체인을 접어 운영 지식으로 — 파생 프로젝션

감사 원천을 classify(결정론 분류) · segment(작업 단위 분할) 후 SQLite FTS5 인덱스로 투영한다. 지워도 원천에서 reindex로 재생성 — 잃는 것 없음. 끝은 Operation Memory(제목·원인·조치·결과, LLM 요약, 판정권 없음).

classify.py 396 segment.py 181 store.py 405 cli.py 247
불변식 · 네 개의 못
01

실행 상류에서 차단

PTY 캡처는 하류에서 관측할 뿐이다. 통과하지 못한 명령은 실행기에 도달하지 않는다 — "위험했습니다"가 아니라 애초에 돌지 않는다.

02

LLM은 판정하지 않는다

자문 층조차 bool만 내고 상한은 CONFIRM. 차단·판정은 결정론 규칙의 몫. 분류마저 결정론인 이유 — LLM이 분류하면 간접적으로 차단권을 갖는다.

03

해시체인이 원천, SQLite는 파생

감사를 DB 원천으로 두면 UPDATE 한 번에 변조 방지가 무너진다. 해시체인 파일이 원천, 인덱스는 질의용 사본. reindex --full로 통째 재생성.

04

문이 있어야 강제

게이트를 우회해 대상에 닿을 수 있으면 그것은 권고다. 자격증명을 문이 쥐고 있어 경유 없이는 닿을 길이 없을 때, 가드레일이 통제가 된다.

같은 코어, 두 진입점
매출·통제

airlock gateway gateway

조직이 반드시 경유하는 강제 경로. sshd 강제 명령·중앙 감사·자격증명 브로커링. 운영자는 우회할 수 없다.

채택

airlock start client

개인의 가드레일·리허설. 같은 룰·기록·가이드를 스스로 켠다. 컨테이너에서 돌려보고 통과한 것만 실서버로 승격.