chore: 운영 이미지에만 있던 커밋 넷을 main에 넣는다 #3

Merged
donghyeon.kang merged 4 commits from chore/sync-production-7a4e201 into main 2026-11-12 01:13:40 +00:00
Owner

무엇을, 왜

운영 hyeonworks.com의 frontend 이미지는 7a4e201에서 만들었다. 그 커밋과 앞의 셋은 노트북의 로컬 브랜치 chore/template-sync-v0.2.0에만 있었고 원격에는 한 번도 올라가지 않았다(W1 인프라 점검이 찾음). 그래서 지금 main에서 이미지를 다시 만들면 운영에서 다음이 되돌아간다.

  • 프론트 템플릿 동기화(ebea300 → af3d8e6)
  • 다크 모드에서 흰 바탕에 흰 글씨로 나가던 문제 수정
  • 본문이 2KB를 넘는 문서가 저장되지 않던 문제 수정
  • 주제 화면의 흐름 제목 문구

이 PR은 그 네 커밋을 main(585c6243, 운영 매니페스트·telemetry off 포함) 위로 옮긴다.

고른 방법과 버린 대안

  • git cherry-pick -x로 옮겼다. 충돌은 없었다. 각 커밋 메시지 끝에 원래 해시(cherry picked from commit …)를 남겼다.
  • 원래 커밋 메시지에 있던 AI 꼬리말(Co-Authored-By, Claude-Session)은 저장소 규칙(커밋에 AI 꼬리말 금지)에 따라 뺐다. 그래서 해시가 원래와 다르다. 운영 이미지와의 대응은 위의 cherry picked from 줄로 찾는다.
  • 노트북의 원래 로컬 브랜치는 건드리지 않았다.
  • 버린 안: 로컬 브랜치를 그대로 push. 꼬리말 규칙을 어기고, main과 갈라진 상태로 남는다.

위험과 영향

  • 파일 743개가 바뀐다. 대부분 템플릿 동기화다. 이미 운영에서 돌고 있는 코드라 동작 변화는 「운영과 같아짐」이다.
  • 결과 트리는 원래 로컬 브랜치와 같다. 다른 곳은 main에서 온 deploy/와 config/runtime/production.json(telemetry off)뿐이다(git diff chore/template-sync-v0.2.0 HEAD -- . ':!deploy' ':!config/runtime/production.json'가 비어 있음).

검증

  • runner quality-gates와 desktop 게이트로 확인한다(W1이 desktop에서 돌림).

리뷰어가 볼 곳

  • config/runtime/production.json: telemetry가 꺼진 상태로 남아 있어야 한다.
  • 이 PR 다음에 feat/backend-prod-profile, feat/frontend-nonroot가 이 위에 올라간다.
## 무엇을, 왜 운영 hyeonworks.com의 frontend 이미지는 `7a4e201`에서 만들었다. 그 커밋과 앞의 셋은 노트북의 로컬 브랜치 `chore/template-sync-v0.2.0`에만 있었고 원격에는 한 번도 올라가지 않았다(W1 인프라 점검이 찾음). 그래서 지금 main에서 이미지를 다시 만들면 운영에서 다음이 되돌아간다. - 프론트 템플릿 동기화(`ebea300` → `af3d8e6`) - 다크 모드에서 흰 바탕에 흰 글씨로 나가던 문제 수정 - 본문이 2KB를 넘는 문서가 저장되지 않던 문제 수정 - 주제 화면의 흐름 제목 문구 이 PR은 그 네 커밋을 main(`585c6243`, 운영 매니페스트·telemetry off 포함) 위로 옮긴다. ## 고른 방법과 버린 대안 - `git cherry-pick -x`로 옮겼다. 충돌은 없었다. 각 커밋 메시지 끝에 원래 해시(`cherry picked from commit …`)를 남겼다. - 원래 커밋 메시지에 있던 AI 꼬리말(`Co-Authored-By`, `Claude-Session`)은 저장소 규칙(커밋에 AI 꼬리말 금지)에 따라 뺐다. 그래서 해시가 원래와 다르다. 운영 이미지와의 대응은 위의 `cherry picked from` 줄로 찾는다. - 노트북의 원래 로컬 브랜치는 건드리지 않았다. - 버린 안: 로컬 브랜치를 그대로 push. 꼬리말 규칙을 어기고, main과 갈라진 상태로 남는다. ## 위험과 영향 - 파일 743개가 바뀐다. 대부분 템플릿 동기화다. 이미 운영에서 돌고 있는 코드라 동작 변화는 「운영과 같아짐」이다. - 결과 트리는 원래 로컬 브랜치와 같다. 다른 곳은 main에서 온 `deploy/`와 `config/runtime/production.json`(telemetry off)뿐이다(`git diff chore/template-sync-v0.2.0 HEAD -- . ':!deploy' ':!config/runtime/production.json'`가 비어 있음). ## 검증 - runner `quality-gates`와 desktop 게이트로 확인한다(W1이 desktop에서 돌림). ## 리뷰어가 볼 곳 - `config/runtime/production.json`: telemetry가 꺼진 상태로 남아 있어야 한다. - 이 PR 다음에 `feat/backend-prod-profile`, `feat/frontend-nonroot`가 이 위에 올라간다.
donghyeon.kang added 4 commits 2026-11-11 23:29:29 +00:00
Carries 359 template commits, tag v0.2.0 plus one documentation commit: the
generator-built feature index with its app, bounded-context and feature
declarations, the src/platform kernel and scale tooling, the 2026-09-24 src
review fixes, and the 2026-09-25 maturity review round with its CHANGELOG
[보안]/[계약] rows. 691 of the 824 template paths are applied, 85 of them
merged with product changes; 127 are not carried.

Product identity is unchanged: name, version 0.1.0, routes, design and the
TechLog domain.

Three decisions worth naming. TechLog stays composed directly, as the last
two syncs recorded; its directory carries a NOT_INSTALLED marker that says so,
and every installed-* composer takes the template's projection with TechLog
added on top. The reference sample is no longer installed: the template now
installs a feature only through feature-module.ts and context-routes.ts,
which load the screens this product deleted, so its three operations, six
schemas and one topic leave the registries, recorded as registry change
evidence. And AppRouter mounts the platform and TechLog routes only; the
template's bounded-context route gateway waits for a generator-installed
feature.

Required fixes: readSubject on the BFF session owner (without it every HTTP
Studio session would close as integration-failed), zod through the facade in
nine TechLog files, noUnusedLocals, and public/config.json written out to
match the local profile. Derived baselines were recomputed after reproducing
both sides' values: CI contract 101 commands / 106 references / 141
artifacts, gate shape c9adcf85; registry approval 2dc6c3a3; the runtime
config schema baseline equals the schema at 8210d48.

Verified here: types, lint, architecture, adapter inventory, CI contract,
i18n, design system, diagnostics, browser security, dev release manifest,
TechLog contract and build pass; 220 component, 155 integration, 15
contract, 418 TechLog, 43 reference-feature, 18 recipe and 46
release-coherence tests pass, and 2381 of 2383 unit tests. Reproduced at
8210d48 first and unchanged: check:registries (byte-identical),
test:runtime-schema, verify:documentation. Brought by the template and
escalated rather than suppressed: check:request-fanout on TechLog's cursor
pagination, check:remediation-ledger (fails upstream too), the shared-chunk
hash test, and the registry-dependent sample removal and second-feature
tests. Playwright suites were not run.

Full record, the five open questions and the follow-ups in
docs/operations/template-sync-2026-09-29.md.

(cherry picked from commit b2170cf265dea45dc9cc05d3c61e627e97f31cdb)
배색을 토큰 별칭으로 옮기면서 TechLog 가 템플릿의 `--color-*` 를 가리키게
됐는데, 템플릿에는 `:root[data-theme="dark"]` 가 있고 그쪽이 더 구체적인
선택자라 TechLog 의 `:root` 를 이긴다. 운영체제가 어두운 화면을 쓰는 사람에게는
글자색만 뒤집히고 배경은 이 파일의 원색(`rgba(252, 252, 251, 0.94)`)이 그대로
남았다 — 스튜디오 헤더가 흰 바탕에 흰 글씨였고, 링크가 안 보이니 눌러도
아무 일이 없는 것처럼 읽혔다.

이 파일의 값은 전부 밝은 화면 하나만 상정하고 고른 것이므로 다크에도 같은
값을 건다. 템플릿의 밝은 값을 그냥 쓰던 여섯 개(hover·pressed·on-action·
disabled 계열)도 이름을 적어 둔다 — 적지 않으면 그 여섯만 혼자 어두워진다.

어두운 배색을 따로 그리는 일은 하지 않았다. 지금은 한 벌만 쓴다.

검사는 「템플릿이 어둡게 덮는 토큰은 TechLog 도 같은 조건에서 되돌린다」를
본다. 템플릿이 새 토큰을 어둡게 덮기 시작하면 그 이름을 짚는다 — 손으로
맞춘 목록은 반드시 낡는다.

(cherry picked from commit 42d1ae1f2da395eb69a29dfaec8bebcd7a003b63)
저장을 눌러도 요청이 나가지 않고 「저장하지 못했습니다.」만 떴다. 갓 만든
문서는 저장되고 글을 쓴 문서만 안 되어서 원인을 짚기 어려웠다.

명령의 신원을 만들 때 플랫폼은 `identity` 훅이 없으면 입력 전체를 쓴다.
그 신원은 `canonicalize` 를 지나고 거기에는 문자열 하나당 2KB 한도가 있다
(`contracts/query-keys.ts` 의 `maxStringBytes`). 본문이 그 한도를 넘는
순간 신원을 만들다 던지고, 명령은 `NOT_STARTED` 로 끝난다 — 전송 전이라
네트워크에도 콘솔에도 아무것도 남지 않는다. 실제로 걸린 문서의 본문은
11,222 바이트였다.

명령을 가리키는 이름은 「어느 문서에 대한 무슨 명령인가」이지 본문이 아니다.
문서 id 만 넘긴다. 같은 문서의 저장을 한 번에 하나만 돌리는 것이
`REJECT_WHILE_ACTIVE` 가 원하는 바이므로 이것으로 충분하다.

검사는 두 쪽을 같이 본다: 입력을 그대로 쓰면 실제로 던진다는 것과, 넘기는
신원은 본문 크기와 무관하다는 것. 앞의 절반이 없으면 한도가 사라져도
검사가 통과한다.

(cherry picked from commit 27f2182c7da2d6c5afbcf13ae0cf4ceaf6d9638c)
「결론까지 이어진 사고 흐름」은 추상어를 쌓은 말이었다. 이 구역이 하는 일은
이 주제를 어떤 순서로 읽으면 되는지 보이는 것이다.

(cherry picked from commit 7a4e201a2934e708c383bd0db132557ea659afad)
donghyeon.kang merged commit 3b4c13e242 into main 2026-11-12 01:13:40 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/tech-log-frontend#3