Files
document-haness/runs/keycloak/2026-09-16-2101-lead-case-ap4-identity-header-trust/run.json
T
DongHyeonkaandClaude Opus 5 2109f726fe feat(pipeline): keycloak-session-store 25편·virtualization 59편을 S3→S5→S6 으로 돌린다
기록 84편을 계약 에이전트로 다시 썼다. 기존 71편(kss 25 · virt 46)과, 계약에만
있고 안 쓰여 있던 새 글감 13편이다. 원장 84개를 열어 단계마다 스킬 영수증과 관문
종료 코드를 적었고 verify-pipeline-run.py 가 error 0 으로 닫는다.

SSOT 결함 둘을 고쳤다.

- kss 의 `약 58일` 이 반입 중 `약 59일` 로 바뀌어 있었다. 원 증거 파일이
  「남은 일수: 88일 … 실제 갱신까지 약 58일」로 산수를 직접 적는다. D-4a 쪽
  `약 59일` 은 강제 갱신 뒤(`VALID: 89 days`)라 맞는 값이라 그대로 뒀다.
- virt §198 의 `11.6GB` 는 §178 의 원 측정 `Mem: 11648`(MiB)과 어긋나는데
  원 가이드의 표기 그대로라 고치지 않고 쓰이는 자리에 대조를 적었다.

기록의 수치 오류 셋을 고쳤다 — CASE 요약의 「게스트 셋에 8240MB」(5120+3120 은
둘이다), k3s 편이 같은 것을 여섯·일곱·여덟로 세던 것, no-docker 편의 「셋을 더
든다」(§281 의 표는 네 행이고 디스크 행이 빠져 있었다).

계약을 셋 고쳤다.

- kss 의 sourceRepository 리비전이 cdac9b8 이었는데 그 커밋에는 docs/guides/**
  28개가 아예 없다. 9465582b 로 바꾸고, 반입한 바이트가 어느 커밋과도 같지 않다는
  것을 측정값과 함께 적었다 — 반입은 커밋이 아니라 그 시점의 작업 트리에서 떠 온
  것이다(kss 297/306 · virt 12/14 가 작업 트리와 같고, 200 커밋을 거슬러 전수
  대조했을 때 가장 가까운 커밋도 28개가 어긋났다).
- virt 계약이 「2026-09-11 재배분」이라고 적는데 SSOT 는 재배분 날짜를 적지 않고
  재배분 뒤 값은 이미 2026-09-10 측정에 찍혀 있다.
- kss 후보 대장이 지나친 절 아홉에 처분을 적었다(warn 9 → 0). 새 글감은 0건이고
  넷은 앵커가 h3 슬러그의 접두가 아니라 중간 토막이라 검사기가 못 본 것이었다.

style_profile.mjs 의 결함 둘을 고쳤다 — frontmatter 가 문장으로 세어져
(실측 398자짜리 「문장」 하나) 평균 길이를 기준 안으로 밀어 올리고 있었고,
engPerSent 의 분자는 목록을 포함한 글에서, 분모는 목록을 걷어낸 글에서 세고
있었다(Question 기록에서 11.94 → 3.86).

verify-pipeline.py 전 항목 PASS · error 0 · unittest 334건 OK.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-17 11:01:55 +09:00

257 lines
11 KiB
JSON

{
"schemaVersion": 2,
"runId": "2026-09-16-2002",
"project": "keycloak",
"record": "docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/case/case-ap4-identity-header-trust.md",
"startedAt": "2026-09-16T20:02:40+09:00",
"finishedAt": "2026-09-16T20:14:58+09:00",
"stages": [
{
"id": "S1",
"name": "코드베이스 → SSOT",
"skill": "analyzing-codebase-for-tech-log",
"runBy": "ssot-analyst",
"status": "SKIPPED",
"skipReason": "SSOT(docs/keycloak/final/document.md)가 이미 있고 이 기록의 근거를 그 안에서 찾을 수 있다. 이번 런은 기록의 칸 배치를 고치는 것이라 SSOT 를 건드리지 않았다.",
"skillEcho": "",
"skillRevision": "edd45dfec66d155a621cd41186b83b5582f2244c",
"inputs": [],
"outputs": [],
"gates": [],
"notes": "",
"finishedAt": "2026-09-16T20:05:54+09:00",
"finishedBy": null
},
{
"id": "S2",
"name": "SSOT → 분해 계약",
"skill": "deriving-tech-log-root-tree",
"runBy": "tree-deriver",
"status": "SKIPPED",
"skipReason": "이 글감은 tech-log-tree.json 에 PROMOTE·CONFIRMED 로 이미 있다. 계약이 아니라 기록 파일 안의 문단 위치를 고쳤다.",
"skillEcho": "",
"skillRevision": null,
"inputs": [],
"outputs": [],
"gates": [],
"notes": "",
"finishedAt": "2026-09-16T20:05:54+09:00",
"finishedBy": null
},
{
"id": "S3",
"name": "글감 → 기록",
"skill": "writing-tech-log-records",
"runBy": "record-writer",
"status": "DONE",
"skipReason": "",
"skillEcho": "수치, 날짜, 버전, 단위, 코드, 명령어, URL, 인용, 공식 명칭은 원문과 한 글자도 달라지면 안 된다.",
"skillRevision": null,
"inputs": [],
"outputs": [
"docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/case/case-ap4-identity-header-trust.md"
],
"gates": [
{
"cmd": "python3 scripts/studio-body.py docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/case/case-ap4-identity-header-trust.md -o /tmp/sb.md",
"exit": 0,
"session": null,
"generation": 1,
"at": "2026-09-16T20:05:54+09:00"
},
{
"cmd": "node --experimental-transform-types .agents/skills/writing-tech-log-records/scripts/check_body.mjs /tmp/sb.md",
"exit": 0,
"session": null,
"generation": 1,
"at": "2026-09-16T20:05:54+09:00"
},
{
"cmd": "node .agents/skills/rewriting-technical-prose-naturally/scripts/check_prose.mjs docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/case/case-ap4-identity-header-trust.md",
"exit": 0,
"session": null,
"generation": 1,
"at": "2026-09-16T20:05:54+09:00"
},
{
"cmd": "node .agents/skills/writing-tech-log-records/scripts/check_evidence.mjs keycloak --repo",
"exit": 0,
"session": null,
"generation": 1,
"at": "2026-09-16T20:05:54+09:00"
},
{
"cmd": "python3 scripts/check-required-content.py --file docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/case/case-ap4-identity-header-trust.md",
"exit": 0,
"session": null,
"generation": 1,
"at": "2026-09-16T20:05:54+09:00"
}
],
"notes": "둘째 문단 266자를 문장 넷으로 갈랐다. 셋은 「결론」(53·55-57행)·「검증 환경」(70-72행)·「재현 조건」 8번에 이미 있어 지웠고, 하나 — 「호스트 포트를 닫아도 같은 Compose 네트워크 안에서는 app 의 8081 에 닿을 수 있고 그 요청은 Nginx 를 거치지 않으니 덮어쓰기도 함께 지나친다」 — 는 어느 칸에도 없어 「결론」의 세 줄 목록 뒤로 원문 그대로 옮겼다. 덮어|거치지|Compose 로 전문을 훑어 없는 것을 확인했다. Compose·8081·Nginx 가 보호 구간이라 문체에 맞춰 고쳐 쓰지 않고 문장을 통째로 옮겼다.",
"startedAt": null,
"generation": 1,
"owner": null,
"elapsedSeconds": 0,
"finishedAt": "2026-09-16T20:05:54+09:00",
"finishedBy": null
},
{
"id": "S4",
"name": "기록 → 그림",
"skill": "technical-visualizer",
"runBy": "diagram-maker",
"status": "SKIPPED",
"skipReason": "그림이 필요 없다. 이번 런은 제목 아래 문단을 알맞은 칸으로 옮기거나 지운 것이라 새로 그릴 소재가 생기지 않았다.",
"skillEcho": "",
"skillRevision": "edd45dfec66d155a621cd41186b83b5582f2244c",
"inputs": [],
"outputs": [],
"gates": [],
"notes": "",
"finishedAt": "2026-09-16T20:05:54+09:00",
"finishedBy": null
},
{
"id": "S5",
"name": "AI 티 제거",
"skill": "rewriting-technical-prose-naturally",
"runBy": "prose-rewriter",
"status": "DONE",
"skipReason": "",
"skillEcho": "| One sentence runs through two subjects, scales, or results | Split it at the subject change |",
"skillRevision": null,
"inputs": [],
"outputs": [
"docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/case/case-ap4-identity-header-trust.md"
],
"gates": [
{
"cmd": "node .agents/skills/rewriting-technical-prose-naturally/scripts/check_prose.mjs docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/case/case-ap4-identity-header-trust.md",
"exit": 0,
"session": null,
"generation": 1,
"at": "2026-09-16T20:10:29+09:00"
},
{
"cmd": "node .agents/skills/rewriting-technical-prose-naturally/scripts/style_profile.mjs docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/case/case-ap4-identity-header-trust.md",
"exit": 0,
"session": null,
"generation": 1,
"at": "2026-09-16T20:10:29+09:00"
},
{
"cmd": "node --experimental-transform-types .agents/skills/writing-tech-log-records/scripts/check_body.mjs /tmp/s5.md",
"exit": 0,
"session": null,
"generation": 1,
"at": "2026-09-16T20:10:29+09:00"
},
{
"cmd": "node .agents/skills/writing-tech-log-records/scripts/check_evidence.mjs keycloak --repo",
"exit": 0,
"session": null,
"generation": 1,
"at": "2026-09-16T20:10:29+09:00"
}
],
"notes": "옮겨 온 문장이 바로 뒤 문단과 같은 말을 하고 있었다 — 옮긴 쪽이 구체 사례인데 다음 문단이 그것을 다시 일반론으로 말해 두 번 읽힌다. 옮긴 문장은 보호 구간(Compose·app의 8081)이라 그대로 두고 뒤 문장을 앞을 받는 형태로 바꿨다. 두 항목 이름은 글자 그대로 남겼고 본문은 한 글자도 안 건드렸다. 문체 벗어남 0.",
"startedAt": null,
"generation": 1,
"owner": null,
"elapsedSeconds": 0,
"finishedAt": "2026-09-16T20:10:29+09:00",
"finishedBy": null
},
{
"id": "S6",
"name": "일한 사람의 목소리",
"skill": "writing-as-the-person-who-did-it",
"runBy": "voice-writer",
"status": "DONE",
"skipReason": "",
"skillEcho": "3. **어긋난 자리를 남긴다** — 예상과 결과가 달랐던 지점이 자료에 있으면 지우지 않는다",
"skillRevision": "edd45dfec66d155a621cd41186b83b5582f2244c",
"inputs": [],
"outputs": [
"docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/case/case-ap4-identity-header-trust.md"
],
"gates": [
{
"cmd": "node .agents/skills/writing-as-the-person-who-did-it/scripts/check_voice.mjs docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/case/case-ap4-identity-header-trust.md",
"exit": 0,
"session": null,
"generation": 1,
"at": "2026-09-16T20:14:57+09:00"
},
{
"cmd": "node .agents/skills/rewriting-technical-prose-naturally/scripts/check_prose.mjs docs/keycloak/tech-log-studio/oauth-oidc-auth-boundary/case/case-ap4-identity-header-trust.md",
"exit": 0,
"session": null,
"generation": 1,
"at": "2026-09-16T20:14:57+09:00"
},
{
"cmd": "node --experimental-transform-types .agents/skills/writing-tech-log-records/scripts/check_body.mjs /tmp/s6.md",
"exit": 0,
"session": null,
"generation": 1,
"at": "2026-09-16T20:14:57+09:00"
},
{
"cmd": "node .agents/skills/writing-tech-log-records/scripts/check_evidence.mjs keycloak --repo",
"exit": 0,
"session": null,
"generation": 1,
"at": "2026-09-16T20:14:58+09:00"
}
],
"notes": "흔적 없음. SSOT 의 AP4 대목 여섯 구간(173-177 · 262-270 · 1387-1397 · 1465-1473 · 1081-1299)과 이번 런의 git diff 를 뒤졌고, 거기 있는 흔적은 이미 기록 안에 제자리를 잡고 있었다 — 앞단에 관문을 세우고 나니 위조 가능한 헤더를 믿는 구성이 된 것, Traefik 대안 넷을 그대로 바꿔 끼울 수 있다고는 확인 못 한 것, 「로그인이 성공한다」를 성공 기준으로 삼으면 못 잰다는 것, 신뢰할 프록시 IP 를 좁힌 이유, 컨트롤러 하나에만 있는 검사. 이번 런이 지운 문단이 흔적을 가져갔는지도 대조했고 안 가져갔다. 접은 것 — AP4 에서 AP3 로 되돌아가는 길(SSOT:1483)은 줄이 있지만 이 기록의 source 앵커 다섯 밖이다.",
"startedAt": null,
"generation": 1,
"owner": null,
"elapsedSeconds": 1,
"finishedAt": "2026-09-16T20:14:58+09:00",
"finishedBy": null
},
{
"id": "S7",
"name": "Studio 저장",
"skill": "publishing-tech-log-to-studio",
"runBy": "studio-validator",
"status": "SKIPPED",
"skipReason": "사용자가 Studio 반입을 요청하지 않았다. 이 기록은 이미 게시돼 있고 S7 은 저장까지인데, 저장하면 Studio 쪽 version 이 올라간다. 저장소와 공개본이 갈린 상태로 두고 사람이 판단할 일로 넘긴다. 게시는 어떤 경우에도 하지 않는다.",
"skillEcho": "",
"skillRevision": null,
"inputs": [],
"outputs": [],
"gates": [],
"notes": "",
"finishedAt": "2026-09-16T20:14:58+09:00",
"finishedBy": null
}
],
"revision": 23,
"updatedAt": "2026-09-16T20:14:58+09:00",
"sessions": [
{
"session": null,
"stage": "S3",
"generation": 1,
"beganAt": "2026-09-16T20:05:54+09:00"
},
{
"session": null,
"stage": "S5",
"generation": 1,
"beganAt": "2026-09-16T20:10:29+09:00"
},
{
"session": null,
"stage": "S6",
"generation": 1,
"beganAt": "2026-09-16T20:14:57+09:00"
}
]
}