Files
clean-architecture-frontend…/docs/operations/ci-quality-gates.md
T
DongHyeonka 45e8cb774c docs(operations): 운영 문서와 adapter 재검토 처리 원장을 한국어로 옮긴다
문제: docs/operations의 release-cache-rollback.md와
adapter-remediation-ledger.md는 본문이 영어이고, 나머지 복구 문서와
ci-quality-gates.md에도 영어 문단이 남아 있다.

고른 방법: 뜻을 바꾸지 않고 옮긴다. 원장은 check:remediation-ledger가
읽으므로 같은 변경에서 스크립트를 맞춘다.
- `SECTION_HEADING`을 옮긴 절 제목(`## 세 번째 재검토 (2026-08-14)`)으로
- 「모두 닫혔다」를 잡는 `BLANKET_CLOSURE`에 한국어 대안을 더한다. 영어
  대안은 원장이 인용한 옛 문장을 잡도록 그대로 둔다
- 표 구조, id 칸, disposition 칸의 백틱 값, file-transfer 예산 숫자는
  그대로다
- ci-quality-gates.md의 advisory 표가 복사한 zod·react-router 버전을
  `package.json`·`pnpm-lock.yaml`을 가리키게 바꾼다(number 검사)

위험: check:remediation-ledger는 게이트 밖이라 CI가 돌리지 않는다.
desktop에서 손으로 돌려 확인했다.

검증: dispositions.json의 id 25개가 그 절의 행과 맞는지, 예산 숫자가
있는지를 스크립트로 확인했다. 문서 검사의 language·number 줄이 0이 되어
예외 목록에서 지웠다.
2026-11-08 21:57:47 +09:00

47 KiB

CI 품질 게이트 구성

config/ci/gates.json은 모든 게이트를 담은 실행 가능한 registry이고, workflow 모델은 이것 하나뿐이다. .gitea/workflows/quality-gates.yml은 이 엄격한 v2 계약에서 생성한다. 따로 설정을 정하는 정본이 아니다. registry를 고치고 corepack pnpm generate:ci-workflow를 돌린 뒤, 생성된 바이트를 함께 커밋한다. corepack pnpm check:ci-workflow는 빠졌거나, 낡았거나, CRLF이거나, 그 밖에 바이트가 다른 출력을 거절한다. corepack pnpm check:ci는 산출물 schema 검사, 타입이 있는 계약 검사기, 이 workflow drift 검사를 돈다. Gitea adapter는 게이트마다 독립된 matrix check로 돌린다. 모두 펼쳐서(full fan-out) 돌리고, 실패를 무시하는(soft-fail) 연결은 없다.

기준선 갱신과 새 프로젝트 시작 시 초기화할 기준선

게이트 계약의 크기와 모양은 코드 상수가 아니라 config/ci/contract-baseline.json에 있다. 이 파일에는 게이트 수, 명령 정의 수, 명령 참조 수, 산출물 수, stage 수, 게이트 모양 SHA-256과 함께 owner·reason이 들어 있다. 계약을 불러올 때 현재 gates.json과 이 파일이 다르면 실패한다(scripts/contracts/ci-gates.ts의 assertCiContractBaseline). 그래서 게이트·명령·산출물을 추가하거나 지운 뒤에는 다음 순서로 커밋한다.

# 1. config/ci/gates.json 수정
CI_CONTRACT_BASELINE_OWNER=<팀> CI_CONTRACT_BASELINE_REASON=<이유> corepack pnpm update:ci-contract-baseline
corepack pnpm generate:ci-workflow
corepack pnpm check:ci

update:ci-contract-baseline은 scripts/update-ci-contract-baseline.ts를 실행한다. 리뷰는 contract-baseline.json의 diff로 변경을 승인한다. 샘플·recipe·런타임 제거 검증(test:*-removal)도 같은 절차를 쓴다. 줄인 계약을 기준선으로 기록한 뒤 canonical check:ci를 돌린다(scripts/lib/removal-fixture.ts의 pruneRemovalFixtureCiContract). 완화 모드는 없다.

check:ci는 tests/ 아래 테스트 파일(tests/fixtures 제외)이 모두 CI 게이트 명령에서 실행되는지도 확인한다. 게이트 명령이 닿는 package script의 Vitest 경로와 Playwright 설정의 testDir를 모아 비교한다(scripts/lib/ungated-tests.ts). run-scale-profile.ts <tier>를 부르는 명령은 그 tier의 Vitest 경로로 센다. 게이트가 돌리지 않는 테스트는 config/ci/ungated-tests.json에 이유와 함께 적어야 한다. 게이트가 이미 돌리는 파일을 이 목록에 남겨 두면 실패한다.

package script도 같은 방식으로 확인한다(scripts/lib/ungated-scripts.ts). check:*·verify:*·test:*·drill:*·review:*·scan:* 스크립트는 게이트 명령에서 package script 그래프로 닿거나, 게이트가 이미 돌리는 Vitest 경로만 다시 돌려야 한다. 둘 다 아니면 config/ci/ungated-scripts.json에 이유와 함께 적는다. 게이트가 닿는 스크립트를 이 목록에 남겨 두면 실패한다. 두 목록에 남은 항목과 이유는 각 파일에 있다.

규모 테스트는 이렇게 나뉜다(리뷰 11-03, scripts/scale/run-scale-profile.ts).

  • check:scale:pr은 merge gate FE-GATE-005에서 돈다. 개수·상한·증가 모양만 검사하므로 CPU가 달라도 결과가 같다. S0~S2 조합 증가 검사가 여기 있다. S0/S1만 재면 모든 workload가 noise floor 아래라 이차 누적을 놓친다. 조합 timing은 산출물(artifacts/scale/pr/composition-s0-s2.json)에 기록만 한다.
  • main·nightly·release tier는 CI에서 돌지 않는다. 이 tier들은 baseline-regression을 포함한다. 이 단계는 config/scale/benchmark-baseline.json을 기록한 CPU 모델에서만 timing을 비교하고, 다른 CPU에서는 incomplete로 끝난다. 이 tier에만 있는 테스트는 ungated-tests.json에, tier를 실행하는 check:scale:* 스크립트는 ungated-scripts.json에 이유와 함께 남아 있다.

템플릿을 복사해 새 프로젝트를 시작하면 아래 기준선은 템플릿의 값이다. 샘플을 지우거나 구조를 바꾸면 프로젝트 값으로 다시 찍는다.

기준선 파일 갱신 방법 검사 위치
CI 계약 크기·게이트 모양 config/ci/contract-baseline.json update:ci-contract-baseline (CI_CONTRACT_BASELINE_OWNER·_REASON 필수) scripts/contracts/ci-gates.ts assertCiContractBaseline
registry 스냅샷과 승인 config/contracts/registry-baseline.json, registry-baseline.approval.json update:registry-baseline (REGISTRY_BASELINE_OWNER·_REASON 필수). 기준선을 새로 찍지 않고 breaking 변경을 유지하려면 config/contracts/registry-change-evidence.json에 항목을 추가(changeId, 그 변경 뒤 값 after(삭제는 생략, 값은 JSON 그대로이고 키·원시값 배열 순서는 상관없다), versionBump·migration·compatibilityWindow·rollback·owner). 같은 칸을 다시 바꾸면 after가 달라 새 항목이 필요하다. 지금 diff의 breaking 변경과 changeId가 맞지 않는 항목이 있으면 게이트가 그 항목을 나열하며 실패한다. update:registry-baseline은 새 기준선이 설명하는 항목을 모두 지운다(지운 항목은 git 이력에 남는다) scripts/check-registries.ts의 baseline 비교
커버리지 모듈 수 하한 config/testing/risk-coverage.json의 repositoryBaseline 직접 수정. 지운 production 모듈 수만큼 줄인다(scripts/test-sample-removal.ts가 같은 계산을 한다) scripts/lib/risk-coverage.ts "repository module baseline"
기능 끄기 설정 config/runtime/<profile>.json의 FEATURE_OVERRIDES 직접 수정. 지운 기능의 키를 뺀다(scripts/test-sample-removal.ts가 같은 일을 한다) 실패하는 검사는 없다. 남은 키는 아무것도 끄지 않고, check:release-admission(FE-GATE-027)이 release admission warning: FEATURE_OVERRIDES.<id> … the override does nothing을, 부팅이 진단 feature.override.unknown(warn)을 남긴다(리뷰 09-09)
의존성 목록 config/security/dependency-baseline.json, dependency-baseline.approval.json update:dependency-baseline (DEPENDENCY_BASELINE_OWNER·_REASON 필수) scripts/generate-supply-chain.ts

계약을 불러올 때, runner가 실행 callback에 들어가기 전에 등록된 명령 항목을 모두 검증한다. 기준은 정본인 루트 package script 그래프와 lifecycle/install 정책이다. 그래서 다른 cwd/workspace의 script로 넘기는 호출, 인자에 따라 동작이 바뀌는 dispatcher, 효과 없는 lifecycle 억제는 사전 검사(preflight)에서 실패한다. 나중의 check:ci 명령이 돌지 않는 경우에도 그렇다. npm에서는 이 루트 전용 경계가 명시적 run/run-script 대상이나 암묵적 test/start/stop/restart 대상 뒤의 옵션도 해석한다. --workspace, -w, --workspaces, --prefix는 다른 manifest 범위를 가리키므로 실행 전에 거절한다. 처음 나오는 글자 그대로의 --가 npm 옵션 해석을 끝낸다. 그 뒤 token은 일반 script 인자다. pnpm과 Yarn은 다르다. 고른 script 이름 뒤의 옵션은 그 script로 넘어간다. cwd/workspace 선택자는 package manager가 script를 고르기 전에 소비하는 위치에 있을 때만 거절한다.

npm 그래프는 명시적 run/run-script 의존과 암묵적 start/stop/restart/test 의존마다, 그 앞뒤에 있는 루트 manifest의 pre<script>, post<script> hook을 포함한다. hook을 빼는 것은 처음 나오는 글자 그대로의 -- 앞에서, 순서대로 놓인 npm 옵션이 실제로 적용될 --ignore-scripts 값을 모호함 없이 정할 때뿐이다. 값 없는 형태와 명시적으로 참인 형태는 hook을 뺀다. 거짓, 부정, 모순, 잘못된 형태, 구분자 뒤의 형태는 hook을 계속 따라가거나 닫힌 쪽으로 실패한다(fail closed). token으로 나눈 명령이 npm을 부르면 대소문자와 상관없이 npm_config_workspace, npm_config_workspaces, npm_config_prefix, npm_config_userconfig, npm_config_globalconfig 대입을 거절한다. 직접 대입, basename이 env인 정적 경로, 정확한 command/exec 접두 사슬, 앞선 export, set -a 대입은 같은 접두 문법 하나를 쓴다. 허용하는 것은 모형으로 정의한, 범위를 바꾸지 않는 env -i, env -u, env --unset, env -- 형태뿐이다. cwd를 바꾸거나 모르는 옵션은 닫힌 쪽으로 실패한다. 동적인 대입 이름, 모형에 없는 환경 변경, npm --userconfig/--globalconfig, npm 인자 구분자 앞의 따옴표 없는 경로 이름 확장은 거절한다. 게이트 runner는 계약을 불러오거나 실행 callback에 들어가기 전에 물려받은 환경 변수에서도 같은 이름을 검사한다. 그래서 그 이름은 자식 게이트 process에 닿지 못한다.

이 셸 파서(scripts/lib/package-script-graph.ts)는 리뷰 12-10에서 줄일 수 있는지 확인했고 남겼다. workflow 설치의 --ignore-scripts와 pnpm-workspace.yaml의 allowBuilds로는 막히지 않는 위험이 있기 때문이다. 첫째, 게이트 명령이 직접 설치를 돈다(verify:lockfile, 제거 fixture). allowBuilds는 pnpm의 의존성 build script만 제한한다. 루트 프로젝트의 install hook과 npm/yarn 설치는 --ignore-scripts가 없으면 그대로 돈다. 둘째, 게이트가 부르는 이름이 다른 manifest의 script로 바뀌는 경로다(--prefix, --filter, -C, npm pre/post hook, npm_config_*). 이것은 설치 옵션과 관계가 없다. 이유는 파일 머리 주석에도 있다.

의존 그래프는 아래와 같다.

MERGE_READY
  -> RELEASE_READY
    -> PROD_PROMOTION_READY
      -> FIELD_SLO_READY

DOCUMENTATION_READY (off-chain)

DOCUMENTATION_READY(verify:documentation)가 검사하는 범위는 좁다 (scripts/verify-documentation-readiness.ts).

  • 설치된 라우트마다 수동 접근성 기록 artifacts/tests/a11y-manual/<ROUTE_ID>.md가 있는지. 없으면 route ID를 적고 실패한다
  • README가 빌드와 승인 단계가 읽는 환경 변수를 모두 적는지
  • 입구 문서가 실제 src 최상위 폴더와 .dependency-cruiser.json 규칙 이름을 적는지
  • docs/README.md 1절의 현재 계약 문서에 적힌 repo 경로·링크·package script· FE-GATE ID가 실제로 있는지. 짝 백엔드 경로는 옆 checkout의 작업 트리가 아니라 config/contracts/backend-contract-pin.json이 고정한 커밋에서 찾고, 그 커밋을 읽을 수 없으면 확인하지 못한 것으로 남긴다
  • 2026-07-18 diagram 리뷰 기록의 두 사본(docs/architecture/review-ledger.json, review-evidence.md)이 같은 해시·점수를 담는지. 원본 diagram은 repo 밖에 있으므로 이 항목은 구조가 바뀌어도 통과한다

문서의 다른 내용(수치, 목록, 설명)이 코드와 맞는지는 검사하지 않는다(리뷰 14-07).

check:architecture는 Babel parser/Node resolver 기반 staticImportGraph를 artifacts/quality/dependency-report.json에 기록한다. 규칙은 .dependency-cruiser.json에서 읽지만 dependency-cruiser는 실행하지 않는다. dependency-cruiser 18은 TypeScript 7을 해석하지 못해 0개 모듈을 검사하고 통과했다(리뷰 12-05). TS/TSX의 static, dynamic, type, CommonJS 및 JSDoc import를 검사하고, 로컬 source import에는 실제 TypeScript 확장자를 요구한다. 실행 source나 로컬 specifier에 .js/.jsx/.mjs/.cjs가 있거나 unresolved dependency, parse failure, error-severity layer violation, cycle 또는 지원하지 않는 architecture rule shape가 하나라도 있으면 gate는 실패한다. resolver, unresolved import, layer edge와 cycle regression fixture도 같은 명령에서 실행된다.

Gitea workflow는 run ID/attempt, checkout SHA와 ref에서 build/release 식별자를 만들고 최소 contents: read 권한만 요청한다. Gate runner는 HEAD의 full commit ID와 commit timestamp를 한 번 읽어 SOURCE_DATE_EPOCH를 유도한 뒤 workflow의 SHA와 실제 checkout이 일치하는지 확인한다. CI=true에서 이 식별자 중 하나라도 없거나 불일치하면 build step 전에 fail-closed하며, build와 release manifest도 같은 build ID, commit SHA, release ID와 timestamp를 가져야 한다.

Release tier의 immutable_build는 dist의 hidden .vite entries, raw pnpm-lock.yaml, build/module inventory와 local release/security evidence를 한 번 생성해 run ID/attempt로 구분된 archive로 게시한다. Raw lock bytes의 SHA-256은 dependency inventory와 candidate manifest 양쪽의 lockfileSha256과 같아야 한다. Producer는 게시 전에 manifest가 선언한 exact member set과 각 byte digest를 검증하고 archive SHA-256을 job output으로 고정한다. 같은 job은 마지막 단계에서 FE-GATE-015·027의 gate log와 evidence, scan:dependency-advisories 기록을 후보와 다른 이름(immutable-gate-evidence-<run>-<attempt>)으로 성공·실패와 상관없이 올린다(1105/13-01). 올라가는 것은 그 run에 생긴 파일이다. ci:gate는 처음 실패한 명령에서 멈추므로 FE-GATE-027은 막지 않는 advisory 검사를 승인보다 먼저 돌린다. 그래서 승인이 거절된 run에도 advisory 기록이 있다(1106/13-01). FE-GATE-015가 실패하면 FE-GATE-027이 돌지 않으므로 그 run에는 FE-GATE-027의 log와 advisory 기록이 없다. ci:gate는 명령 출력을 gate log에만 쓰고 콘솔에는 한 줄만 남기므로, release 단계의 실패 이유는 이 산출물에서 읽는다. 후보 archive의 member set은 그대로다. Vulnerability/provenance provider job은 같은 archive를 각각 내려받아 output SHA-256과 exact member set을 확인한 뒤 checkout과 분리된 root에만 추출하고, CANDIDATE_LOCKFILE_PATH와 CANDIDATE_DIST_SHA256를 외부 command에 전달한다. Provider command 실행 후에는 archive와 추출된 candidate를 다시 검증하고, strict provider JSON과 candidate digest가 일치할 때만 report를 업로드한다. Promotion은 같은 archive와 두 report를 별도 경로로 내려받고 SHA/member 검증을 마친 뒤 격리된 root에 추출하여 local evidence를 read-only로 다시 계산하고 Ed25519 signature/digest를 확인한다. Promotion job에는 build/rebuild command가 없으며 검증한 archive 자체를 변경 없이 그대로 승격한다. Local evidence 관계 검증에 필요한 policy와 verifier source도 archive member로 고정되며, checkout 밖의 격리된 cwd에서도 archive path와 기대 digest만으로 candidate-internal check를 재계산하고 archived secret-scan policy/rule/SARIF/zero-finding/digest 관계를 검증한다. Archive에 없는 checkout source를 다시 scan했다고 주장하지 않는다.

Provider baseline은 Gitea 1.26.4 이상과 Gitea Runner 1.0.0 이상이다. Linux runner에는 실행 가능한 /usr/bin/bwrap, /usr/bin/prlimit, /usr/bin/systemd-run, /usr/bin/systemctl, bwrap --size 지원, 활성 user bus, 254 이상의 systemd user manager, 통합 cgroup v2와 위임된(delegated) memory/pids/CPU controller가 모두 필요하다. 실행 파일, user manager/version, trust/archive/path 같은 host-side preflight 실패는 raw report 생성 전에 차단된다. bwrap --size 수용 여부와 실제 delegated controller/limit 값은 owned raw inode를 만든 뒤 scope 안에서만 확정할 수 있으며, 이 단계의 실패는 해당 inode를 identity-bound cleanup하고 fail closed한다.

비특권 user namespace (1105/12-01). runner는 비특권 process가 bubblewrap으로 user namespace와 network namespace를 만들 수 있게 허용해야 한다. provider sandbox는 bwrap --unshare-pid --unshare-ipc --unshare-uts --unshare-net으로 뜬다(scripts/lib/provider-sandbox-namespaces.ts). bubblewrap은 setuid가 아니므로 이 옵션마다 비특권 user namespace가 필요하다. 이 조건은 provider job과 merge 게이트 FE-GATE-013(test:system의 provider 테스트) 둘 다에 걸린다. config/ci/gates.json의 FE-GATE-013 hostRequirements에 같은 조건이 있고, 생성 workflow는 그것을 merge job의 runs-on 옆 주석으로 보여 준다.

  • Ubuntu 23.10부터는 kernel.apparmor_restrict_unprivileged_userns=1이 기본이다(24.04도 같다). /usr/bin/bwrap에 userns를 허용하는 AppArmor profile이 없으면 bwrap이 bwrap: loopback: Failed RTM_NEWADDR: Operation not permitted로 끝난다.
  • test:system은 먼저 scripts/check-system-test-prerequisites.ts를 돈다. 이 검사는 provider와 같은 namespace 옵션으로 bwrap에서 /bin/true를 한 번 띄운다. 실패하면 "this host does not allow unprivileged user and network namespaces"와 bwrap의 stderr, 위 sysctl 값, 고치는 방법을 적고 exit 1로 멈춘다. 전에는 이 검사가 PASS를 낸 뒤 provider 테스트가 bwrap 원문 오류로 실패했다(2026-11-05 desktop에서 114건 중 18건).
  • 고치는 방법은 scripts/check-system-test-prerequisites.ts가 실패할 때 출력한다. 호스트의 보안 설정을 바꾸는 일이므로 호스트 소유자가 고른다. 호스트를 바꾸는 설정 파일과 명령은 runner를 만드는 쪽의 인프라 repo가 갖는다.

각 provider는 고유한 collected user scope에서 실행된다. Supervisor는 실행 전에 실제 cgroup membership과 memory.max=1073741824, memory.swap.max=0, pids.max=64, cpu.max="100000 100000"을 확인한다. 내부 process에는 core 0, file-size 8,388,607 bytes, open FD 64, CPU 1,200초 상한도 적용된다. 같은 UID 전체에 합산되는 RLIMIT_NPROC로 provider별 32개를 보장한다고 주장하지 않으며 aggregate PID authority는 cgroup TasksMax=64다. Bubblewrap는 network namespace를 분리해 완전 offline으로 실행하고 workspace, verified candidate, .git mask, /tmp, /etc, /proc, /dev를 read-only로 유지한다. Archive 검증·추출과 sandbox/trust preflight가 끝난 뒤 supervisor가 생성하고 inode를 고정한 정확한 raw report 파일 하나만 read-write bind된다. 주변 untrusted directory 전체는 writable이 아니다. 실행 전 또는 provider 실패 시, 그리고 성공적으로 sealed evidence를 게시한 뒤에도 supervisor가 소유한 inode만 atomic quarantine을 거쳐 제거하므로 빈 stale report 없이 재시도할 수 있다.

Provider command와 provider 접두사가 붙은 environment는 크기 상한이 있는 length-prefixed bwrap vector로 systemd-run stdin에 전달되어 supervisor/systemd/bwrap wrapper argv나 unit metadata에 노출되지 않는다. 단, 최종 provider executable의 일반 argv는 같은 UID의 process inspection에 보일 수 있으므로 command 문자열과 인자에 token, password, private-key material을 넣으면 안 된다. Credential은 반드시 해당 종류의 VULNERABILITY_PROVIDER_* 또는 PROVENANCE_PROVIDER_* environment로만 전달하고 *_COMMAND에는 넣지 않는다. 정상 provider 종료까지 같은 stdin을 parent-liveness pipe로 열어 두며 supervisor hard death의 EOF를 받은 in-scope wrapper는 provider process group 전체를 종료하고 dev/inode가 일치하는 raw report만 정리한다.

별도의 trusted guardian child는 provider scope 밖에서 filesystem transaction 전체를 소유한다. Client는 spawn 전에 canonical raw/evidence directory를 O_DIRECTORY|O_NOFOLLOW로 열고 identity를 확인한 뒤 provider kind와 nonce에서 canonical raw/final 및 nonce-private raw-staging/sealed-temp exact leaf를 확정한다. Client가 두 private file을 O_RDWR|O_CREAT|O_EXCL|O_NOFOLLOW mode 0600으로 미리 할당하고 dev/inode를 기록한다. Directory descriptor는 guardian fd 3/4, private file descriptor는 fd 5/6으로 상속되며 guardian argv에는 Node와 helper 경로만 있다. 최초 canonical v2 frame에는 provider kind, absolute deadline, 32-byte nonce만 전달한다.

Guardian bootstrap은 procfs link를 읽기 전에 fd 5/6을 fstat한다. Procfs pathname은 canonical directory의 exact direct-child grammar를 만족하고 descriptor-relative lstat이 이미 확보한 fd identity/type/mode/size/link count와 일치할 때만 해당 identity의 cleanup alias가 된다. Guard frame 검증 뒤 raw staging을 fixed raw leaf에 no-overwrite hard link하고 두 alias의 link count 2를 확인한 다음 private alias를 제거하고 raw directory를 sync한다. Canonical raw가 같은 identity와 link count 1로 남은 뒤에만 READY를 응답한다. READY 전 종료 시 client는 pre-spawn raw identity로 raw staging/canonical을, sealed identity로 temp/final을 각각 확인해 일치하는 alias만 정리한다. 현재 canonical pathname을 새 ownership identity로 승격하지 않으므로 외부 file과 concurrent same-kind winner를 보존하면서 같은 workspace를 즉시 재시도할 수 있다. Supervisor는 READY identity와 canonical target도 정확히 확인한다.

검증된 JSON bytes는 pinned temp inode에만 기록하고 0400 적용과 file sync를 마친다. Guardian은 authenticated publish의 size/hash/identity를 재검증하고 같은 directory에서 no-replace link(temp, final), temp unlink, directory sync를 수행한 뒤 PUBLISHED를 응답한다. GITHUB_OUTPUT append 이후 commit은 raw inode를 제거하고 commitPending으로만 전이하며, 깨끗한 control EOF까지 확인해야 PASS가 된다. 그 전의 EOF, deadline, 잘못된 frame/nonce, commit 뒤 추가 byte 또는 guardian 조기 종료는 identity가 일치하는 raw/temp/final을 모두 정리하고 fail closed한다. Provider wall timeout 30분에 post-processing 10분을 더한 guardian lease 상한은 40분이다.

Client가 private allocation 뒤 guardian spawn 전에 hard stop되면 empty mode-0600 nonce-private leaf만 남을 수 있다. 기록되지 않은 pathname은 ownership 근거가 아니므로 자동 sweeping하지 않는다. 이 private leaf는 fixed raw/final name을 점유하지 않아 same-kind retry를 막지 않는다.

GITHUB_OUTPUT은 runner가 소유한 regular file이라는 실행기 계약을 전제로 한다. Sealing/output I/O의 OS-level cancellation을 보장하지 않는다. Provider scope가 이미 수집된 뒤 guardian이 종료되면 scope-active latch는 늦은 kill을 시작하지 않고 lifecycle error만 기록한다. 이후 publish/commit의 awaited failure가 identity가 고정된 raw/temp/final fallback을 모두 정리하고 fail closed한다.

Provider stdout/stderr는 credential을 포함할 수 있는 untrusted bytes이므로 CI log로 재전송하거나 보관하지 않고, byte 수만 합산해 1 MiB 상한을 적용한다. Guardian의 stderr/control fd가 닫혀 진단 출력이 EPIPE/EBADF가 되어도 cleanup 뒤 nonzero 종료는 생략되지 않는다. Provider wall-clock 상한은 30분이다. Wall timeout, aggregate output 초과, parent-liveness loss, 실행 중 guardian loss는 provider process group을 명시적으로 SIGKILL한다. 일반 command 실패와 FD/CPU RLIMIT 종료는 실제 exit/signal로 systemd completion을 거치며, 모든 경로에서 wrapper 종료와 systemd unit/cgroup collection을 확인한다. Adapter는 사전에 배치된 offline data와 supervisor candidate binding만 읽어 정확한 report inode에 기록해야 한다. Scope/cgroup limit drift, residual unit, workspace·host home/toolcache·sealed evidence 접근 의존성은 모두 blocking failure다.

Workflow가 실행하는 action은 scripts/contracts/ci-gates.ts의 단일 typed, runtime-frozen registry에서만 resolve된다. uses:에는 repository 별칭, tag, branch 또는 short SHA를 허용하지 않고 다음 absolute upstream URL과 full 40-hex commit만 사용한다.

  • https://github.com/actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 (v4.3.1)
  • https://github.com/actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 (v4.4.0)
  • https://github.com/ChristopherHX/gitea-upload-artifact@81f940d004763f986ba3582c007fd842dd5cb0d7 (patched v4 branch)
  • https://github.com/ChristopherHX/gitea-download-artifact@75635f32b4c1c41c4b3d64e8f85210112ed4c9c7 (patched v4 branch)

Gitea 1.22 공식 Actions 문서는 artifact v4 호환 경로로 이 ChristopherHX patched upload/download fork를 권고한다. 이 권고는 실제 설치 환경의 호환성을 증명하지 않으므로, 지원 baseline은 계속 Gitea 1.26.4+ 및 Gitea Runner 1.0.0+이며 action 변경은 registry, semantic tests, snapshot과 generated workflow를 함께 갱신해야 한다.

이 workflow를 required check로 전환하기 전에 staging instance에서 permissions, gitea.run_attempt, 위 digest-pinned patched artifact action을 포함한 한 번의 실제 end-to-end provider smoke를 반드시 통과시켜야 한다. mock/local generation 결과는 required-check enablement evidence가 아니다. 모든 setup step은 node-version-file: .nvmrc를 사용하므로 CI Node.js 버전은 .nvmrc의 exact pin과 같다. CI contract는 .nvmrc가 full semantic version인지, 모든 job이 이 파일을 사용하는지 함께 검사한다. ubuntu-latest runner label은 관리자가 임의 환경에 매핑할 수 있으므로 provenance로 사용하지 않는다. 대신 그 label을 immutable container image에 매핑하고 동일한 image digest를 repository variable RUNNER_IMAGE_DIGEST에 설정한다. Workflow는 이 값을 runtime environment의 CI_RUNNER_IMAGE로 전달하며, 값이 비어 있으면 모든 gate가 실행 전에 실패한다. Gitea repository variable 이름에는 CI prefix를 사용할 수 없으므로 두 이름을 의도적으로 구분한다.

pull request와 develop push는 merge 준비 상태(merge readiness)를 평가한다. version tag는 merge를 평가한 뒤 release 준비 상태를 평가한다. production과 field 평가는 명시적인 workflow dispatch가 있어야 한다. field tier는 28일 표본 기준(threshold) 결정이 기록될 때까지 통과할 수 없다. 문서 준비 상태(documentation readiness)는 범위를 정한 두 diagram이 이미 100/100 PASS_SCOPED를 받은 정본 project-note 증거를 쓴다. repo ledger는 그 증거의 범위와 정본 digest를 보존한다.

모든 job은 실패한 뒤에도 공유 artifacts/ 트리를 올린다. 보관 기간 숫자는 조직이나 provider가 정할 일로 남긴다. workflow는 일부러 retention-days를 지어내지 않는다. 상대적인 최소 보관 기간은 registry에 기록한다. merge 증거는 PR 결정까지, 서로 맞는 release 증거는 다음 release 승격까지, drill 증거는 다음 production 승격까지, field 증거는 집계까지 보관한다.

runbook job은 고정 경로 artifacts/runbooks/<runbook-id>/record.json에 쓴다. 바뀌는 release identity는 record 안에 저장한다.

runbook drill(drill:runbook, FE-GATE-021..025)은 판정마다 PASS, FAIL, UNVERIFIED 중 하나로 기록한다(scripts/drill-runbook.ts, record schema는 scripts/contracts/release-artifacts.ts). PASS/FAIL은 drill이 빌드된 dist/를 대상으로 확인했다는 뜻이다. drill은 public/의 placeholder를 읽지 않으므로 빌드가 없으면 실패한다. CI의 production 단계는 다시 빌드하지 않는다. production_gate는 promotion job의 promoted-release 산출물을 내려받는다. 그 release-candidate.tar.gz를 immutable_build의 archive_sha256과 대조한 뒤 (scripts/verify-ci-candidate-archive.ts) .release/promoted-release에 푼다. drill 명령마다 --release-root .release/promoted-release를 넘긴다(config/ci/gates.json). CI 계약은 빌드하거나 release root를 빠뜨린 production 게이트 명령을 거절한다 (scripts/contracts/ci-gates.ts, 13-03, 1101/13-01). 로컬에서 --release-root 없이 돌리면 drill은 로컬 빌드를 검사한다.

hosting 게이트 FE-GATE-019도 .release/promoted-release를 읽는다. 그 archive의 dist를 검사하고, live 호스트가 후보(candidate)의 buildId와 releaseId를 담은 release-manifest.json을 내주기를 요구한다. 그래서 아직 이전 release를 내주는 호스트는 실패한다(1101/13-01). 같은 run에서 다시 빌드한 것도 같은 이름을 갖는다. 그래서 호스트가 내준 config.json도 두 긴급 스위치를 빼고 후보의 것과 같아야 하고, 호스트가 내준 index.html도 후보의 진입 스크립트를 가리켜야 한다(1103/13-01). workflow는 스스로 아무것도 배포하지 않는다. promotion과 production_gate 사이에 deployment job이 있다. 이 job이 프로젝트의 배포 슬롯이다. 기본값은 비어 있다. 그러면 job은 deployed=false를 보고하고, FE-GATE-019는 호스트를 probe하지 않고 UNVERIFIED(exit 3)로 끝나며, production 단계는 닫히지 않는다. 슬롯을 채우려면 제품이 소유한 config/ci/product-gates.json에 deployment를 넣고 corepack pnpm generate:ci-workflow를 돌린다(1103/12-07). 예는 아래와 같다.

{
  "schemaVersion": 1,
  "deployment": {
    "script": "deploy:desktop",
    "environment": [
      { "name": "DEPLOY_HOST", "value": "${{ vars.DEPLOY_HOST }}" },
      { "name": "DEPLOY_SSH_KEY", "value": "${{ secrets.DEPLOY_SSH_KEY }}" }
    ]
  },
  "mergeGates": []
}

슬롯의 나머지는 템플릿이 생성한다. promoted-release 전송물을 내려받고, 후보 digest와 대조해 .release/promoted-release에 푼 다음, script를 돌린다. 그 script가 .release/promoted-release/dist를 배포한다. environment는 vars.*와 secrets.* 값만 받는다. 템플릿은 이 파일을 비운 채로 내보내고 절대 바꾸지 않는다. 그래서 템플릿 동기화가 이 파일과 부딪히지 않는다. config/ci/gates.json은 템플릿의 것으로 남고, 그 계약 기준선은 템플릿 계약만 센다. 두 파일 모두에 슬롯을 채우면 거절한다.

mergeGates는 제품 자체 검사를 더한다. 예를 들어 짝 백엔드와의 계약 검사는 { "id": "PRODUCT-GATE-001", "name": "backend-contract", "script": "check:backend-contract" }이다. ID는 PRODUCT-GATE-NNN이다. FE-GATE-NNN ID와 그 명령, 산출물, 준비 상태 공식은 템플릿의 것으로 남는다. 각 검사는 product_merge_gate job에서 corepack pnpm <script>로 돈다. 조건은 merge_gate와 같다. 브라우저 없이, ci:gate의 게이트 log와 evidence 산출물 없이 돈다. release_gate는 merge_gate를 기다리듯 그 job도 기다린다. 그래서 제품 게이트가 실패하면 같은 run의 release 빌드, 승격, 배포도 멈춘다(1105/13-02). 제품 게이트가 없으면 workflow는 템플릿의 것 그대로다. pull request merge를 막는 것은 branch의 required check다. 그러니 merge를 막아야 하는 곳에서는 이 job을 required check로 만든다. check:ci는 package.json에 없는 script와, release_gate가 제품 job을 기다리지 않는 workflow를 거절한다. 그리고 이 script들을 게이트가 돌리는 것으로 센다.

config/ci/gates.json에 저장한 슬롯도 같은 계약 규칙을 따른다. 계약이 허용하는 step은 checkout, setup-node, frozen-install, download(promoted-release 전송물), extract, 그리고 script가 package script를 가리키는 마지막 deploy step 하나다. 변수는 immutable_build의 CANDIDATE_ARCHIVE_SHA256 digest와 vars.*, secrets.* 값만 쓸 수 있다. deploy script가 있는 슬롯은 promoted-release 전송물만 내려받고, 그 release-candidate.tar.gz를 풀고, digest를 묶어야 한다. 그래서 script는 다시 빌드한 것이 아니라 승격한 후보를 배포한다(1103/13-01). secrets.* 값은 job이 아니라 deploy step에만 넣는다. 그래서 checkout, setup-node, download action은 그 값을 보지 못한다(1103/13-05). deploy step은 script가 성공한 뒤에만 deployed=true를 쓴다. 이 job은 게이트를 소유하지 않는다. 그래서 슬롯을 채워도 게이트 소유와 계약 기준선은 바뀌지 않는다. 브라우저 boot, live API 트래픽, provider 전환 뒤의 smoke, runbook이 provider 확인이 필요하다고 표시한 것은 모두 UNVERIFIED다. FAIL이 하나라도 있으면 drill은 FAIL(exit 1)이다. 그렇지 않고 UNVERIFIED가 하나라도 있으면 UNVERIFIED(exit 3)이고, 게이트는 PASS가 아니다. 그래서 provider 증거가 없으면 production 단계는 닫히지 않는다. 의도한 결과다. 로컬 drill은 승격한 release를 rollback할 수 있다는 것을 보여 줄 수 없다. FE-GATE-016(rollback-drill)은 FE-GATE-025와 같은 FE-RB-005 drill을 돌렸으므로 폐기했다(scripts/contracts/ci-gates.ts의 RETIRED_GATE_IDS). 이렇게 하면 게이트 증거를 찾는 일이 RELEASE_ID의 slash나 그 밖의 provider별 문자에 영향을 받지 않는다. 그러면서도 workflow 산출물은 각자 자기 run 범위에 남는다.

브라우저를 쓰는 merge 게이트는 버전을 고정한 Chromium, Firefox, WebKit 엔진을 설치해 실행한다. 그래서 route 동작, reflow, 기본 dialog 동작, theme 유지, 자동 접근성 검사는 Chromium에서만 보는 smoke check가 아니라 엔진 전체에 걸친 계약이 된다.

FE-GATE-005의 unit suite에는 client cache/storage의 deterministic contract가 포함된다. storage-registry.test.ts는 key별 codec, schema/TTL, 16,384-byte 상한, quota/security/corrupt cleanup과 memory fallback을, cross-tab-invalidation.test.ts는 2,048-byte exact wire, topic/release epoch, self/duplicate/out-of-order/gap, BroadcastChannel → localStorage → local-only degrade와 cleanup을 검증한다. tanstack-cache-coordinator.test.ts는 topic을 local namespace로만 resolve하고 query key/data를 wire에 보내지 않으며 mutation 중 remote hint를 coalesce하는지 검증한다. 결과는 기존 artifacts/tests/unit.xml과 coverage evidence에 포함된다.

FE-GATE-006과 runtime adapter unit은 QueryInvalidationProvider/coordinator가 실제 production provider tree와 bootstrap에 존재하고 browser capability getter가 실패해도 boot가 DEGRADED_LOCAL_ONLY로 계속되는지 확인한다.

FE-GATE-008의 test:browser-capabilities suite는 File/Blob, 브라우저 기본 file input, IndexedDB, OPFS, Cache Storage와 StorageManager의 reference runtime을 Vite dev origin의 실제 browser API에 연결한다. API가 없는 engine에서는 skip하지 않고 adapter의 명시적인 UNSUPPORTED fallback을 검증한다. 생성한 database, OPFS namespace와 owned cache는 각 test가 자신이 만든 opaque namespace만 정리한다.

FE-GATE-010은 application/domain/presentation에서 raw browser storage와 picker global 접근을 막고, 선택되지 않은 reference runtime을 bootstrap이나 installed feature가 import하는 것도 거절한다. catalog의 referenceRuntime.sourceRoots와 conformance script가 실제로 존재해야 하며, productionComposition은 project capability 결정 전까지 false다. 같은 gate의 realtime source/fixture 검사는 native SSE/WebSocket/Web Push API가 소유 adapter 밖으로 새는 것, presentation timer owner, 미선택 runtime의 bootstrap/installed-feature 조합을 차단한다. optional recipe source gate는 uncomposed runtime 전체를 tree-shaking 없이 합성해 catalog의 gzip 예산도 blocking으로 검증한다. FE-GATE-020은 reference runtime source·전용 test·catalog metadata를 제거한 임시 repository에서도 base typecheck, architecture, test, build가 통과하는지 검증해 skeleton의 선택성을 유지한다. browser file/storage와 realtime runtime은 각각 독립 removal fixture와 JUnit evidence를 가지며, realtime fixture는 공통 event authority, SSE, WebSocket, 상한 있는(bounded) Polling, Web Push의 source와 공개 export, 전용 boundary script를 제거한 뒤 base gate를 다시 실행한다.

같은 FE-GATE-010의 FE-REG-QUERY governance는 installed query마다 namespace, serialization/identity, invalidation topic, version, crossContext: "invalidate-only"와 persistence: "disabled"를 요구한다. 따라서 cross-tab invalidation은 조립됐지만 query persistence와 기존 IndexedDB reference runtime은 계속 미조립이다.

현재 FE-GATE-008 browser-capability suite에는 실제 두 page의 BroadcastChannel/localStorage fallback scenario가 아직 없다. unit fake 통과를 native multi-tab promotion evidence로 간주하지 않는다. 이 gap은 클라이언트 캐시·브라우저 저장소 플랫폼 설계의 완료 기준에 미완료로 남아 있다. 현재 장애 분류와 안전한 local-only 복구 절차는 클라이언트 캐시와 Web Storage 복구를 따른다.

상위 tier가 요구하는 repository 변수는 아래와 같다.

  • RUNNER_IMAGE_DIGEST: ubuntu-latest runner label이 쓰는, 바꿀 수 없는 job container image의 digest. workflow는 이 값을 게이트에 CI_RUNNER_IMAGE로 넘긴다(모든 tier가 요구한다)
  • HOSTING_BASE_URL: 배포된 승격 release의 live 헤더 검증용(FE-GATE-019, production 단계). 없으면 게이트는 실패한다. 로컬 fixture 결과는 UNVERIFIED다. deployment job이 release를 배포했을 때만 probe한다
  • APP_PROFILE: release 후보를 빌드할 runtime profile(local, development, staging, production; scripts/generate-runtime-config.ts). 설정하지 않으면 local로 빌드한다. 빈 값이면 빌드가 실패한다.
  • RELEASE_TARGET: FE-GATE-027이 후보를 승인해 들여보낼 환경 (scripts/check-release-admission.ts). 기본값이 없다. immutable_build job은 FE-GATE-015를 돌린 뒤 FE-GATE-027을 돌린다. FE-GATE-027은 APP_PROFILE이 설정돼 있고 RELEASE_TARGET과 다르면 후보를 거절한다. 둘 다 repository 전체 변수이므로 release마다 함께 설정한다. FE-GATE-027은 scan:dependency-advisories를 먼저 돌리고 승인(admission)을 그 뒤에 돌린다(1103/13-03, 1106/13-01). 이 scan은 lockfile에 대한 registry의 advisory report(pnpm의 audit 명령에 --json)에 config/security/vulnerability-policy.json과 그 예외를 적용한다. 결과는 게이트 log와 artifacts/security/dependency-advisories.json에 쓴다. 결과는 PASS, POLICY_VIOLATION(production 승격이 거절할 내용과 그 발견 사항), UNVERIFIED(registry 없음) 중 하나다. 이 scan은 게이트를 실패시키지 않는다. 코드가 그대로여도 advisory 데이터베이스가 바뀌면 release가 깨지기 때문이다. 승격은 여전히 vulnerability provider의 서명된 판정이 정한다. job 콘솔은 게이트마다 PASS/FAIL 한 줄만 보여 준다. 그래서 immutable_build job은 job의 성공·실패와 상관없이 두 게이트의 log와 evidence, 이 기록을 run 산출물 immutable-gate-evidence-<run>-<attempt>로 올린다(1105/13-01). 이 산출물에는 그 run이 만든 파일이 들어 있다. ci:gate는 처음 실패한 명령에서 멈추고, scan은 승인보다 먼저 돈다. 그래서 승인이 거절된 run에도 advisory 기록이 있다. FE-GATE-015가 실패하면 FE-GATE-027은 돌지 않는다. 그래서 그 run에는 FE-GATE-027의 log도 기록도 없다. FE-GATE-015나 FE-GATE-027이 실패한 이유와 advisory 상태는 이 산출물에서 읽는다. Renovate runner를 붙이면 renovate.json이 보안 업데이트 PR을 연다. 의존성 업데이트는 같은 변경에서 의존성 기준선을 다시 승인한다 (update:dependency-baseline).
  • FIELD_WEB_VITALS_INPUT: 개인정보 검토를 통과한 field 표본 문서
  • MIN_ELIGIBLE_SAMPLES: 기준선 결정 뒤에 설정한다
  • VULNERABILITY_PROVIDER_COMMAND, PROVENANCE_PROVIDER_COMMAND: 따로 운영하는 scanner와 attestor 명령
  • VULNERABILITY_PUBLIC_KEY_PATH, VULNERABILITY_KEY_ID, PROVENANCE_PUBLIC_KEY_PATH, PROVENANCE_KEY_ID: 따로 관리하는 신뢰할 수 있는 Ed25519 검증 자료

scan:dependency-advisories가 이 lockfile에 대해 보고한, 정책의 high 이상 advisory는 아래와 같다. 2026-11-04에 확인했다(리뷰 1103/13-03). 2026-12-04까지 또는 아래 업데이트를 할 때 다시 확인한다. 개발 전용 의존성(storybook, vite, vitest, undici, brace-expansion, nanoid, source-map-js)은 선언한 범위 안에서 업데이트해서 없어졌다.

Advisory 패키지 고친 버전 아직 업데이트하지 않은 이유
GHSA-mrhx-c7xc-m3w5 (high) zod(production. 지금 버전은 package.json) 4.6.6 production 직접 의존성을 올리려면 config/security/dependency-change-evidence.json 항목이 필요하고, 그 항목의 reviewer는 owner가 아니어야 한다. 4.6.7은 초기 JavaScript를 gzip으로 약 7 KB 늘려 번들 예산을 넘는다. 그래서 업데이트에는 예산 결정도 필요하다. 앱은 HTTP 본문을 바이트 상한을 두고 읽는다. 그래서 이 advisory가 필요로 하는 큰 collection 입력이 좁아진다(리뷰 추정)
GHSA-qwww-vcr4-c8h2 (high) react-router, react-router-dom을 거쳐 들어옴(production. 지금 버전은 pnpm-lock.yaml) 7.18.2 같은 evidence 규칙을 따른다. 이 advisory는 RSC 모드에 관한 것이다. browser router를 쓰는 이 SPA는 RSC 모드를 쓰지 않는다(리뷰 추정, 확인하지 않음). 7.18.5는 초기 JavaScript를 약 470 B 늘린다

두 provider role은 서로 다른 key ID뿐 아니라 canonical DER-SPKI public-key bytes도 사용해야 한다. 동일 key를 서로 다른 ID로 재등록한 구성도 finalizer가 거절한다.

외부 provider 명령, report, trust 경로, key ID 중 하나라도 없으면 승격은 FAIL_UNVERIFIED로 막힌 채 남는다. 로컬에서 생성하거나 복원하는 대체 경로(fallback)는 없다.

provider 명령은 각각 supervisor가 묶어 준 값으로 엄격한 provider evidence v2를 원자적으로 내보내야 한다. 묶는 값은 evidence 종류, 발급·만료 시각, run ID/attempt, PROVIDER_INVOCATION_NONCE, source identity, 후보 digest, key ID, DER-SPKI key fingerprint다. 승격은 두 supervisor job의 output을 VULNERABILITY_INVOCATION_NONCE와 PROVENANCE_INVOCATION_NONCE로 받는다. 이 값을 상수나 provider report에서 읽은 값으로 바꾸지 않는다.

Promotion verification/staging step과 promoted-release upload action 사이에는 어떤 step도 둘 수 없고 upload에는 if: always()를 사용할 수 없다. 이 인접성은 실패한 검증의 publication을 막지만 staging path를 upload action에 cryptographically hand off하지는 않는다. 따라서 promotion runner는 trusted, exclusive, single-tenant여야 하고 staging step 종료부터 바로 다음 upload action이 파일을 여는 시점까지 같은 UID로 실행되는 provider command나 다른 process가 살아남지 않는다는 운영 가정을 만족해야 한다. 업로드된 artifact의 downstream consumer도 artifact service나 transfer action을 신뢰 경계 밖으로 보고, candidate manifest와 signed provider evidence에 바인딩된 digest를 다운로드 후 다시 검증해야 한다. 현재 producer-side adjacency 자체는 consumer-side digest revalidation을 대신하지 않는다. Promotion job에는 job-level if가 없다. 기본 needs 성공 의미론으로 immutable build, vulnerability provider, provenance provider 세 job이 모두 성공해야 하며, always()나 cancelled()로 cancellation을 덮어쓰지 않는다. Bare always()는 step cleanup에만 사용된다. 다만 cancellation 시 cleanup 실행 여부는 workflow 정적 타입이나 단위 테스트로 증명하지 않았으며 runner/native smoke에서 확인해야 하는 신뢰 경계다. Finalizer output은 RUNNER_TEMP 아래 random private directory이며 exact-five upload는 ${{ steps.finalize.outputs.staging_root }} 아래 다음 다섯 canonical pathname만 사용한다: release-candidate.tar.gz, vulnerability-report.json, provenance-attestation.json, provider-verification.json, promotion-verification.json. 바로 다음 always() cleanup은 staging path/token, runner-temp device/inode와 staging-leaf device/inode 여섯 output을 모두 요구한다. cleanup은 pin한 leaf descriptor에서 exact-five name만 unlink하고 non-recursive rmdir만 사용하므로 교체된 directory나 canary tree를 recursive 삭제하지 않는다. stable .release/promoted-staging directory를 만들거나 재사용하지 않는다. exact five는 captured archive 한 개, captured report 두 개와 process 안에서 생성한 provider/promotion verification v3 두 개이며 promotion record는 provider 기록, 로컬 평가(local assessment), report hash와 run/source/candidate/ nonces/key identities/trust-policy hash 및 signed secretScanAttestation을 함께 bind한다. 이 attestation은 PASS와 local-assessment/source-set/policy/SARIF/ scan-input digest를 포함한다. Supervisor/finalizer는 captured archive에서 기대 tuple을 유도해 exact equality를 확인하지만, 실제로 같은 source-set 전체를 독립 스캔하고 forged empty SARIF에 서명하지 않을 책임은 trusted vulnerability provider에 있다. Staging은 restrictive umask와 무관하게 directory 0700, file 0400을 강제하고, 모든 write 뒤 live time으로 exact-five signature/freshness를 다시 확인한 뒤에만 output을 공개한다. Descriptor-relative 정리는 ancestor/leaf 교체와 symlink를 fail-closed로 처리하지만 upload action의 same-UID pathname reopen 또는 atomic renameat2 handoff를 보장하지 않는다. staging Gitea smoke/native adapter 확인 전에는 그 경계를 닫았다고 보고하지 않는다. 실제 smoke는 exact-five upload-download와, 성공·검증 실패·upload 실패·취소 각각의 cleanup을 관찰해야 한다. 현재 repository에는 native uploader나 renameat2 보장이 없다. 또한 portable Node의 mkdir와 최초 pathname lstat는 atomic하지 않다. 구현은 mkdir 직후 metadata를 저장하고 이후 O_DIRECTORY|O_NOFOLLOW descriptor의 device/inode와 비교한 뒤에만 permission을 바꾸지만, 최초 lstat보다 앞서 성공한 malicious same-UID 교체는 native/privilege 경계로 남는다. 따라서 RUNNER_TEMP private 0700 ancestor와 exclusive single-tenant runner가 필수다. 실패 cleanup도 created device/inode와 opened descriptor가 일치한 뒤에만 활성화된다. 불일치 descriptor는 close만 수행하며 현재 visible replacement pathname은 unlink나 rmdir하지 않는다. 공격자가 original directory를 다른 이름이나 parent 밖으로 이동한 경우 portable Node parent scan으로 안전하게 회수할 수 없으므로, 공격자를 배제한 trusted runner/native cleanup 또는 격리된 test fixture가 잔여 directory를 후처리해야 한다.

branch 보호 설정은 각 FE-GATE-* / <name> check를 선언한 tier에 맞게 required로 표시해야 한다. 이 repo는 파일을 커밋하는 것으로 서버 쪽 보호 설정을 바꿀 수 없다.