Compare commits

...
10 Commits
23 changed files with 771 additions and 325 deletions

No files matched your search

-97
View File
@@ -1,97 +0,0 @@
# ---------------------------------------------------------------------------
# .env.example — committable template for the multi-agent-mux-* skills
#
# This file is tracked in git and contains NO secrets. To get a working local
# config, copy it to `.env` (which is git-ignored) and edit as needed:
#
# scripts/generate-env.sh # creates .env from this template if absent
# # or manually: cp .env.example .env
#
# Every variable below is OPTIONAL. The skills already resolve sane defaults
# (shown after each `#default:` line), so an unset/commented variable just keeps
# the built-in behaviour. Uncomment + edit only the ones you want to override.
#
# SECURITY: never put real secrets in this template. Secret-bearing vars use a
# `replace_me` placeholder — fill them in only in your local `.env`.
# ---------------------------------------------------------------------------
# ===========================================================================
# Workspace / runtime paths
# ===========================================================================
# Single source of truth for the agent session registry YAML.
#default: <workspace>/.mam/agent-sessions.yaml
# AGENT_SESSIONS_YAML=/path/to/workspace/.mam/agent-sessions.yaml
# Where the monitor (reconcile.sh) keeps its drift-state cache.
#default: <workspace>/.cache/multi-agent-mux-monitor
# AGENT_SESSIONS_STATE_DIR=/path/to/workspace/.cache/multi-agent-mux-monitor
# Root directory that holds Claude Code per-project conversation logs (*.jsonl).
#default: $HOME/.claude/projects
# CLAUDE_PROJECT_DIR=$HOME/.claude/projects
# Directory scanned for per-session launcher wrappers (~/.local/bin/<session>).
#default: $HOME/.local/bin
# LOCAL_BIN=$HOME/.local/bin
# tmux server socket name (`tmux -L <name>`). "default" = the normal tmux server
# (no -L). Set this to opt into an isolated server for all skill tmux calls.
#default: default
# TMUX_SERVER_NAME=default
# ===========================================================================
# delegate-job / MQTT broker
# ===========================================================================
# MQTT broker host the delegate-job publisher/subscriber connects to.
#default: broker.hivemq.com
# MQTT_BROKER=broker.hivemq.com
# Broker auth username. Leave unset for anonymous brokers.
#default: (unset → anonymous)
# MQTT_USERNAME=replace_me
# Broker auth password. SECRET — fill in only in your local .env, never commit.
#default: (unset → anonymous)
# MQTT_PASSWORD=replace_me
# Prefix for generated MQTT client ids (publisher/subscriber/monitor).
#default: hermes
# MQTT_CLIENT_ID_PREFIX=hermes
# Path to a CA bundle for TLS broker verification (set MQTT_TLS=1 to use TLS).
#default: (unset → no custom CA)
# MQTT_CA_CERTS=/path/to/ca.crt
# Client certificate for mutual-TLS brokers.
#default: (unset → no client cert)
# MQTT_CERTFILE=/path/to/client.crt
# Client private key for mutual-TLS brokers. SECRET — keep the key file private.
#default: (unset → no client key)
# MQTT_KEYFILE=/path/to/client.key
# Directory for delegate-job audit logs (sits beside .mam/jobs/).
#default: <cwd>/.mam/delegate_job_logs
# DELEGATE_JOB_LOGS_DIR=/path/to/workspace/.mam/delegate_job_logs
# ==============================================================================
# deploy / distribution source (for forks/mirrors)
# ==============================================================================
# Note: These variables are read from the execution environment by deployment scripts.
# Since deploy/install.sh runs before .env exists, you must pass them via export
# or prepended variables (e.g. MAM_REPO_URL=... bash deploy/install.sh).
# If you run a private mirror, we strongly recommend configuring all three variables.
# Distribution repository URL (cloned during recovery steps).
#default: https://git.godopu.com/tmpl/multi-agent-mux.git
# MAM_REPO_URL=https://git.godopu.com/tmpl/multi-agent-mux.git
# Distribution archive download URL (used for bootstrap extraction).
#default: https://git.godopu.com/tmpl/multi-agent-mux/archive/main.tar.gz
# MAM_ARCHIVE_URL=https://git.godopu.com/tmpl/multi-agent-mux/archive/main.tar.gz
# Distribution update/installer script URL.
#default: https://git.godopu.com/tmpl/multi-agent-mux/raw/branch/main/deploy/install.sh
# MAM_INSTALLER_URL=https://git.godopu.com/tmpl/multi-agent-mux/raw/branch/main/deploy/install.sh
+341 -6
View File
@@ -4,10 +4,10 @@
| 항목 | 내용 | | 항목 | 내용 |
| :--- | :--- | | :--- | :--- |
| **문서 ID** | `REQ-ANL-WEB-001` | | **문서 ID** | `REQ-ANL-WEB-001` |
| **버전** | `1.8` | | **버전** | `1.14` |
| **작성일** | 2026-07-30 | | **작성일** | 2026-07-30 |
| **작성자** | claude (`canary-projects-landing-page-creator-claude`) · Role: planner | | **작성자** | claude (`canary-projects-landing-page-creator-claude`) · Role: planner |
| **상태** | 승인 (Approved) — v1.5에서 **D-01** 확정(A·B안 기각 / `intl-conf` 폐기 · 3개 카테고리), v1.6에서 **D-06** 확정(레이아웃 컨테이너 3계층 분리). v1.7에서 **§6.1.2 Research Project PageView** 신설 — 신규 미결 **D-07**(🔴 Funder 실데이터 부재)·**D-08**(🟡 프로젝트 집합 범위)은 각 기본값으로 구현을 차단하지 않는다. 잔여 미결 D-02·D-03·D-05는 🟡 등급으로 각 기본값이 적용되어 승인을 보류하지 않는다 | | **상태** | 승인 (Approved) — v1.5에서 **D-01** 확정(A·B안 기각 / `intl-conf` 폐기 · 3개 카테고리), v1.6에서 **D-06** 확정(레이아웃 컨테이너 3계층 분리). v1.7에서 **§6.1.2 Research Project PageView** 신설 — 신규 미결 **D-07**(🔴 Funder 실데이터 부재)·**D-08**(🟡 프로젝트 집합 범위)은 각 기본값으로 구현을 차단하지 않는다. 잔여 미결 D-02·D-03·D-05는 🟡 등급으로 각 기본값이 적용되어 승인을 보류하지 않는다. v1.9에서 **§8.7 색 토큰 알파 계약**(R-8.21~R-8.24)을 신설하고 **D-09**(Publications 인덱스 라우트)를 확정했다. v1.10에서 개발 팀장(Agy) 이의제기를 반영해 **D-09를 Overview 뷰로 재확정**하고 R-8.25·AC-41을 신설했다. v1.11에서 강조색 교체 커밋(`eaddc4f`)의 대비 붕괴를 규명해 **§8.7에 R-8.26~R-8.28**(강조색 대비 바닥값 · 색값 변경 재측정 의무 · 명암 반전 계약)을 신설하고 **D-10을 확정**(`--cobalt` #4A7CE8 유지 + `--cobalt-dark` #32549E 재조정), **AC-43~AC-46**(대비 게이트 Gate 10 및 그 폴트 인젝션)을 신설했다. 신규 미결 **D-11**(🟡 `text-vermillion` 소형 텍스트 30여 곳)은 현행 유지를 기본값으로 하여 구현을 차단하지 않는다. v1.12에서 개발 팀장(Agy) 이의제기(Job `7f136931`)를 반영해 **D-10의 배지·칩 전경/배경을 재확정**(`bg-cobalt text-ink` 폐기 → `bg-{accent}-dark text-ivory`)하고 **R-8.29**(반전 토큰 쌍의 `dark:` 불필요 원칙)·**AC-47**(팔레트 외 색 상한)을 신설했다. v1.13에서 Primary #4E77FF 전면 적용 커밋군(`ca4a7ee`~`082d71e`)을 검증해 **Gate 0~10 전량 통과 상태에서 AA 미달 6건·통일성 결함 9건**을 실측 확정하고, 게이트 범위 결함 3종에 대해 **R-8.30~R-8.32**(비텍스트 UI 대비 · 역할 단위 색 통일 · 게이트 면제 형식 제한)와 **AC-48~AC-50**(Gate 11 · 폴트 인젝션 F1~F9 · `docs/DESIGN.md` 동기화)을 신설했다. **§8.1을 실제 토큰값으로 동기화**하고 **D-10 확정값을 #345AD2로 개정**했다. 신규 미결 **D-12**(🔴 Primary 적용의 판정 기준 및 히어로 `Orchestration` 시맨틱 규약)는 **A안+B안 병행**을 기본값으로 하여 구현을 차단하지 않으며, **D-13**(🟡 `--vermillion` 반전 1.25)은 현행 유지 + 화이트리스트 등재를 기본값으로 한다. v1.14에서 개발 팀장(Agy) 이의제기(Job `4962a667`)를 반영해 **R-8.33**(토큰 등급 불변식)을 신설하고 **R-8.29를 강화**(강조색 `dark:` 변형 금지 · 현행 위반 38건)했으며, 다크 테마 `bg-paper` 소형 텍스트 **8곳의 AA 미달(4.37)** 과 **G-7**(AC-44 정규식이 다크 절반을 설계상 면제)을 확정해 **AC-51**을 신설했다. 신규 미결 **D-14**(🔴 `--cobalt` 반전 1.00)는 **A안(브랜드 고정 예외)** 을 기본값으로 하되 규격 완화를 포함하므로 **cline·GM 심사 전에는 집행하지 않는다** |
| **대상 독자** | General Manager, Developer Team Leader(Agy), Reviewer Team Leader(Cline), 지도교수 | | **대상 독자** | General Manager, Developer Team Leader(Agy), Reviewer Team Leader(Cline), 지도교수 |
| **선행 문서** | [`README.md`](./README.md), [`.agents/MULTI_AGENT_RULES.md`](./.agents/MULTI_AGENT_RULES.md), [`refer_landing_page/docs/DESIGN.md`](./refer_landing_page/docs/DESIGN.md) | | **선행 문서** | [`README.md`](./README.md), [`.agents/MULTI_AGENT_RULES.md`](./.agents/MULTI_AGENT_RULES.md), [`refer_landing_page/docs/DESIGN.md`](./refer_landing_page/docs/DESIGN.md) |
| **적용 범위** | `refer_landing_page/` (Next.js 14 App Router 애플리케이션) 전체 | | **적용 범위** | `refer_landing_page/` (Next.js 14 App Router 애플리케이션) 전체 |
@@ -110,7 +110,7 @@
| :--- | :--- | :--- | | :--- | :--- | :--- |
| **IA-01** | 현행 `/intro`의 커버 스프레드를 **`/`(Home)으로 승격**한다 | PR-02가 상단 탭에 `Intro`를 포함하지 않으며, PR-03의 "연구실 소개"가 Home의 구성 요소로 명시되어 있다. `/intro`를 별도 유지하면 Home과 콘텐츠가 중복된다. **부수 효과로 기존 `/` 404 결함이 해소된다.** | | **IA-01** | 현행 `/intro`의 커버 스프레드를 **`/`(Home)으로 승격**한다 | PR-02가 상단 탭에 `Intro`를 포함하지 않으며, PR-03의 "연구실 소개"가 Home의 구성 요소로 명시되어 있다. `/intro`를 별도 유지하면 Home과 콘텐츠가 중복된다. **부수 효과로 기존 `/` 404 결함이 해소된다.** |
| **IA-02** | `/intro`는 **`/`로 308 영구 리다이렉트**한다 | 3차에 걸친 리뷰 리포트·문서가 `/intro`를 참조하고 있어 링크 안정성이 필요하다. `next.config.js`의 `redirects()`로 처리하며 별도 페이지 파일을 남기지 않는다. | | **IA-02** | `/intro`는 **`/`로 308 영구 리다이렉트**한다 | 3차에 걸친 리뷰 리포트·문서가 `/intro`를 참조하고 있어 링크 안정성이 필요하다. `next.config.js`의 `redirects()`로 처리하며 별도 페이지 파일을 남기지 않는다. |
| **IA-03** *(v1.1 개정 · v1.5 수치 갱신)* | Publications 카테고리는 **라우트 세그먼트 `/publications/[category]` + `generateStaticParams()`** 로 구현한다. `/publications`는 개요 화면으로 유지한다 | **v1.0에서 "단일 라우트 + `?cat=` 쿼리"였으나 §8.5의 실측 검증 결과에 따라 개정.** 세그먼트 방식은 카테고리별 완전한 정적 HTML 3개(D-01 확정 전 4개)를 빌드 타임에 생성해 **공유 링크가 필터 상태를 포함한 문서를 그대로 제공**하며(AC-05 취지 충족), 뒤로/앞으로 가기·프리페치·스크롤 복원이 Next 라우터에서 기본 제공된다. 슬러그를 카테고리 레지스트리에서 도출하므로 **라벨 변경이 레지스트리 한 곳 수정으로 끝난다는 v1.0의 근거는 그대로 유지**된다(→ D-01 리스크 완화 불변). 상단 탭은 5종 그대로이므로 **PR-02와 충돌하지 않는다**(하위 라우트일 뿐 최상위 탭이 아니다). | | **IA-03** *(v1.1 개정 · v1.5 수치 갱신 · v1.9 개정 · v1.10 재개정)* | Publications 카테고리는 **라우트 세그먼트 `/publications/[category]` + `generateStaticParams()`** 로 구현한다. **`/publications`는 `redirect()`가 아니라 자체 콘텐츠를 렌더하는 실체 라우트로 유지하며, 그 콘텐츠는 하위 카테고리 어느 것과도 중복되지 않는 Overview 뷰**(카테고리별 집계 + 최신 실적 하이라이트)로 한다 — D-09 재확정(v1.10). `redirect()` 전용 라우트는 산출 HTML에 `<main>`·`container-content`가 존재하지 않아 **AC-25를 구조적으로 위반**하므로 금지하고, 첫 카테고리 본문을 그대로 재렌더하는 방식은 **동일 DOM 정적 HTML 2본을 생성해 R-8.25를 위반**하므로 금지한다. 상단 `CategoryNav`는 **3개 카테고리 탭만** 노출하며 `All`/`전체` 탭을 두지 않는다(commit `22a31ff` 결정 존중) — Overview에서는 활성 탭이 없는 것이 정상 상태다 | **v1.0에서 "단일 라우트 + `?cat=` 쿼리"였으나 §8.5의 실측 검증 결과에 따라 개정.** 세그먼트 방식은 카테고리별 완전한 정적 HTML 3개(D-01 확정 전 4개)를 빌드 타임에 생성해 **공유 링크가 필터 상태를 포함한 문서를 그대로 제공**하며(AC-05 취지 충족), 뒤로/앞으로 가기·프리페치·스크롤 복원이 Next 라우터에서 기본 제공된다. 슬러그를 카테고리 레지스트리에서 도출하므로 **라벨 변경이 레지스트리 한 곳 수정으로 끝난다는 v1.0의 근거는 그대로 유지**된다(→ D-01 리스크 완화 불변). 상단 탭은 5종 그대로이므로 **PR-02와 충돌하지 않는다**(하위 라우트일 뿐 최상위 탭이 아니다). |
| **IA-04** | 내비게이션 항목은 **PR-02의 5개로 고정**한다 | `components/Header.tsx`의 데스크톱 내비가 5개 항목 기준으로 조판되어 있다. 항목 증감 시 헤더 레이아웃 재설계가 선행되어야 한다. | | **IA-04** | 내비게이션 항목은 **PR-02의 5개로 고정**한다 | `components/Header.tsx`의 데스크톱 내비가 5개 항목 기준으로 조판되어 있다. 항목 증감 시 헤더 레이아웃 재설계가 선행되어야 한다. |
--- ---
@@ -413,10 +413,23 @@ interface ResearchProject {
| :--- | :--- | :--- | | :--- | :--- | :--- |
| `ink` / `ink-soft` / `ink-mute` | `#0A0A0A` / `#262420` / `#6B655B` | 본문·괘선 | | `ink` / `ink-soft` / `ink-mute` | `#0A0A0A` / `#262420` / `#6B655B` | 본문·괘선 |
| `ivory` / `paper` / `line` | `#F5F1E8` / `#ECE6D6` / `#D8D1C0` | 종이 배경 / 인셋 / 헤어라인 | | `ivory` / `paper` / `line` | `#F5F1E8` / `#ECE6D6` / `#D8D1C0` | 종이 배경 / 인셋 / 헤어라인 |
| `vermillion` / `vermillion-dark` | `#D9342B` / `#A8231C` | 강조 (Hot) | | `vermillion` / `vermillion-dark` | `#D9342B` / `#A8231C` | 강조 (Hot) — **최초 커밋 이래 불변** |
| `cobalt` / `cobalt-dark` | `#1B3A8A` / `#122863` | 강조 (Cool) | | `cobalt` / `cobalt-dark` | `#4E77FF` / `#345AD2` *(v1.13 갱신)* | 강조 (Cool) — Primary |
**R-8.1** 신규 색 토큰 추가 금지. 색상 값 변경 시 `tailwind.config.ts`와 `app/globals.css`의 `:root` CSS 변수를 **반드시 함께** 수정한다. **실측 대비 (v1.13 기준선 · WCAG 2.1 재계산)**
| 토큰 | `ivory`(L) | `paper`(L) | `ivory`(D) | `paper`(D) | 라이트↔다크 반전 대비 |
| :--- | ---: | ---: | ---: | ---: | ---: |
| `cobalt` #4E77FF | 3.45 | 3.12 | 4.82 | 4.37 | **1.00 ❌ (R-8.28 위반)** |
| `cobalt-dark` #345AD2 | 5.26 | **4.76** | 6.57 | 5.96 | 2.08 ✅ |
| `vermillion` #D9342B | 4.16 | 3.77 | 5.01 | 4.54 | **1.25 ❌ (→ D-13)** |
| `vermillion-dark` #A8231C | 6.38 | 5.77 | 6.72 | 6.09 | 2.58 ✅ |
> **v1.11 갱신 근거**: 커밋 `eaddc4f`가 `cobalt`를 `#1B3A8A` → `#4A7CE8`, `cobalt-dark`를 `#122863` → `#3462CC`로 변경했다. `#4A7CE8`은 사용자 지정 값이므로 유지하되, `cobalt-dark`는 `paper` 배경에서 4.48:1로 미달하므로 **D-10 결정에 따라 `#32549E`(paper 5.82:1)로 재조정**한다. `vermillion`(#D9342B)은 변경된 적이 없다 — `eaddc4f`의 커밋 메시지 `…and secondary to #D9342B`는 현상 유지의 서술이다(→ §12.1 D-10 상세). **v1.12**: 두 강조색의 `-dark` 변형(`#A8231C` / `#32549E`)은 소형 텍스트 전경뿐 아니라 **`text-[0.65rem]` 상태 칩의 배경**으로도 사용된다 — `ivory` 전경만으로 6.38~6.43(라이트) / 6.57~6.72(다크)를 확보한다(→ R-8.26 · R-8.29 · §12.1 D-10 보론).
>
> **v1.13 갱신 근거**: 커밋 `ca4a7ee`·`8db16e4`가 `cobalt`를 `#4A7CE8` → **`#4E77FF`**, `cobalt-dark`를 D-10 확정값 `#32549E`가 아닌 **`#345AD2`** 로 설정했다. `#4E77FF`는 사용자 지정 Primary이므로 유지하며, `#345AD2`도 `paper` **4.76**으로 R-8.26 바닥값을 충족하므로 **D-10 확정값을 `#345AD2`로 개정**한다(단 여유가 0.26뿐이라 §12.2 R-4로 등재). 다만 **`--cobalt`의 반전 대비가 1.00으로 R-8.28을 다시 위반**하며 — 이는 v1.11에서 D-10의 근본 원인으로 규명한 실패 유형의 재발이다 — AC-45 게이트가 `-dark` 2개 토큰만 검사하도록 구현되어 **검출하지 못했다**(→ R-8.28 개정 · AC-45 개정 · §12.1 D-12 상세). 4개 색 변경 커밋 **전부 본문이 비어 있어 R-8.1·R-8.27의 대비 재산정표 첨부 의무가 4회 연속 미이행**이다.
**R-8.1** 신규 색 토큰 추가 금지. 색상 값 변경 시 `tailwind.config.ts`와 `app/globals.css`의 `:root` CSS 변수를 **반드시 함께** 수정하며, **R-8.26~R-8.28의 대비·반전 제약을 재산정해 첨부**한다.
**R-8.2** `brand` / `accent` 별칭은 레거시 호환 전용이며 신규 코드에서 사용 금지. **R-8.2** `brand` / `accent` 별칭은 레거시 호환 전용이며 신규 코드에서 사용 금지.
### 8.2 타이포그래피 · 유틸리티 클래스 ### 8.2 타이포그래피 · 유틸리티 클래스
@@ -427,6 +440,7 @@ interface ResearchProject {
### 8.3 강조색 시맨틱 계약 ### 8.3 강조색 시맨틱 계약
**R-8.5** `vermillion` = Agent Engineering / Orchestration(홀수 항목), `cobalt` = MCP / A2A Protocol(짝수 항목). 목록 렌더 시 인덱스 기반 교차 배정을 따른다. **R-8.5** `vermillion` = Agent Engineering / Orchestration(홀수 항목), `cobalt` = MCP / A2A Protocol(짝수 항목). 목록 렌더 시 인덱스 기반 교차 배정을 따른다.
- **[v1.13 · 적용 범위 명시]** 본 계약은 `docs/DESIGN.md` §2 "의미 있는 색(Semantic accent pairing)"의 정본 서술과 **동일한 내용**이며, 목록 교차 배정뿐 아니라 **단일 강조 표면(히어로 강조어·섹션 키커 등)에도 적용되는지**는 확정되지 않았다. 커밋 `2441f35`가 히어로의 `Orchestration` 강조어를 vermillion → cobalt로 변경해 **같은 페이지 안에서 규약이 둘로 갈린 상태**이므로 **D-12로 이관**한다. 어느 쪽으로 확정하든 **코드와 `docs/DESIGN.md`가 같은 값을 말해야 한다**(→ AC-23 · AC-50).
### 8.4 컴포넌트 재사용 ### 8.4 컴포넌트 재사용
@@ -481,6 +495,85 @@ Job `343b5808` 검증에서 본문 좌우 여백·최대 폭 미적용(B1)이,
- **실측 확인**: Tailwind v3는 `extend`로 추가한 스크린도 **min-width 값 기준으로 정렬**해 출력하므로(`1024 → 1240 → 1280 → 1536` 순서 확인), `2xl` 등 상위 브레이크포인트를 덮어쓰는 캐스케이드 사고는 발생하지 않는다. `screens` 전체를 재정의할 필요가 없다. - **실측 확인**: Tailwind v3는 `extend`로 추가한 스크린도 **min-width 값 기준으로 정렬**해 출력하므로(`1024 → 1240 → 1280 → 1536` 순서 확인), `2xl` 등 상위 브레이크포인트를 덮어쓰는 캐스케이드 사고는 발생하지 않는다. `screens` 전체를 재정의할 필요가 없다.
- **주의**: `lg`(1024px)와 `desktop`(1240px)이 공존하므로, **헤더 내 데스크톱/모바일 전환은 `desktop:`으로만 통일**한다. 동일 속성에 `lg:`와 `desktop:`을 혼용하면 1024–1239 px 구간에 의도치 않은 중간 상태가 생긴다(B2가 정확히 이 사고였다). - **주의**: `lg`(1024px)와 `desktop`(1240px)이 공존하므로, **헤더 내 데스크톱/모바일 전환은 `desktop:`으로만 통일**한다. 동일 속성에 `lg:`와 `desktop:`을 혼용하면 1024–1239 px 구간에 의도치 않은 중간 상태가 생긴다(B2가 정확히 이 사고였다).
### 8.7 색 토큰 알파 계약 (Color Token Alpha Contract) *(v1.9 신설)*
디자인 토큰은 `app/globals.css`의 CSS 커스텀 프로퍼티와 `tailwind.config.ts`의 `theme.extend.colors`가 **한 쌍으로 동작**한다. 이 쌍의 계약이 깨지면 **lint·tsc·빌드가 모두 통과하는 채로 화면만 무너진다** — 실제로 그 사고가 발생했으므로(§12.1 D-09 상세) 계약을 명문화한다.
**R-8.21 [필수 · 공백 구분]** `--*-rgb` 커스텀 프로퍼티의 값은 **반드시 공백 구분 3-숫자**로 정의한다(`--ink-rgb: 10 10 10;`). **쉼표 구분(`10, 10, 10`)을 금지한다.**
- 근거: Tailwind는 `<alpha-value>`를 포함한 색을 `rgb(var(--ink-rgb) / var(--tw-text-opacity, 1))` 형태로 전개한다. 값이 쉼표 구분이면 치환 결과가 `rgb(10, 10, 10 / 1)`이 되는데, 이는 CSS Color 4의 **현대 문법(공백+슬래시)도 레거시 문법(전량 쉼표)도 아니어서 무효**다. 무효 선언은 *invalid at computed-value time* 으로 처리되어 **해당 속성이 통째로 적용되지 않는다.** 빌드는 성공하고 CSS 파일에도 규칙이 남으므로 **어떤 정적 게이트도 이를 잡지 못한다.**
- `--ink: rgb(var(--ink-rgb));` 형태의 파생 변수는 공백 구분에서도 그대로 유효하므로 함께 유지한다.
**R-8.22 [필수 · `<alpha-value>` 보존]** `theme.extend.colors`의 모든 토큰은 **`rgb(var(--*-rgb) / <alpha-value>)` 형태**로 선언한다. `var(--ink)`처럼 알파 자리표시자가 없는 형태로 축약하지 않는다.
- 근거(실측): 알파 자리표시자가 없으면 Tailwind는 슬래시 수식자 유틸리티를 **오류 없이 조용히 생략**한다. 독립 프로브 결과 — `colors.ivory = "var(--ivory)"`일 때 `bg-ivory/85`·`text-ivory/50`·`border-ivory/15`는 **출력 CSS에 단 한 줄도 생성되지 않았고**, `colors.old = "rgb(var(--ivory-rgb) / <alpha-value>)"`일 때는 `rgb(var(--ivory-rgb) / 0.85)`로 정상 생성되었다.
- 유틸리티가 생성되지 않으면 배경은 **투명**, 테두리는 Preflight 기본색 **`#e5e7eb`**(팔레트 외 회색), 텍스트는 **부모 색 상속**으로 대체되어 **팔레트를 벗어난 화면**이 된다.
**R-8.23 [금지 · 토큰 우회]** 디자인 토큰으로 표현 가능한 색을 컴포넌트의 인라인 `style` 속성이나 리터럴 색값(`#ffffff` 등)으로 우회 지정하지 않는다. 인라인 `style`은 다크 모드 변형(`dark:`)보다 **항상 우선**하므로 **테마 반전이 무력화되고 대비 요구(R-9.6)가 조용히 깨진다.**
- 활성 내비 배지처럼 대비가 임계에 가까운 요소에는 **`opacity-*` 유틸리티를 사용하지 않는다.** 요소 불투명도는 전경·배경을 함께 합성해 대비를 낮추며, 실측상 `opacity-90`만으로 4.69:1 → 4.05:1(라이트)로 떨어져 AA 미달이 된다.
**R-8.24 [필수 · 헤더 가로 예산]** 데스크톱 헤더(브랜드 + 내비 + 토글)의 소요 폭은 **1240 px 뷰포트의 가용 폭 1112 px과 최대 폭 상한(78 rem) 적용 시의 가용 폭 1120 px을 모두 초과하지 않아야 한다.** 헤더에 **좌우 패딩·간격·마진을 추가하는 변경은 예산 재계산을 동반**해야 하며, 예산 초과 시 내비 라벨이 2줄로 접히는 회귀(§8.6 B2)가 재발한다.
- 실측 기준선(commit `43c75da`): 소요 **1057.6 px** / 가용 1112 px / 여유 **+54.4 px**, 내비 전량 `font-bold` 보정 시 **+22.7 px**.
- `container-content`의 최대 폭이 78 rem(1248 px)로 **상한**이므로, 1280 px 이상에서도 가용 폭은 **1120 px에서 고정**된다. 즉 **뷰포트를 넓혀도 헤더 넘침은 해소되지 않는다** — 넓은 화면 전용 마진(`xl:mr-16` 등)은 예산을 악화시키기만 한다.
**R-8.25 [금지 · 콘텐츠 중복] *(v1.10 신설)*** 서로 다른 두 라우트가 **실질적으로 동일한 `<main>` 콘텐츠**를 정적 HTML로 생성해서는 안 된다.
- 근거: 검색 엔진은 중복을 벌점 처리하지는 않으나 **어느 URL을 정본으로 삼을지 스스로 선택**하므로, 내부 링크·사이트맵이 가리키는 URL과 색인되는 URL이 어긋날 수 있다. 또한 산출물 크기가 이유 없이 늘고, 한쪽만 수정되는 **표류(drift) 결함**이 구조적으로 가능해진다.
- 인덱스 라우트는 하위 라우트의 본문을 재사용하는 대신 **고유한 집계·요약 콘텐츠**를 갖는다(→ IA-03).
- 불가피하게 동일 콘텐츠를 두 URL에 노출해야 한다면 **`metadata.alternates.canonical` 지정을 필수**로 하며, 그 경우에도 R-8.25의 예외임을 §12.1에 결정 항목으로 기록한다.
- 자동 검증: **AC-41**.
**R-8.26 [필수 · 강조색 대비 바닥값] *(v1.11 신설)*** 강조 토큰(`vermillion`·`cobalt`)의 **DEFAULT 변형은 대형 텍스트(≥24 px, 굵게 ≥18.66 px)·도형·테두리·아이콘 전용**이며 **3:1** 이상을 만족한다. **소형 텍스트에는 `-dark` 변형만 사용**하고, `-dark`는 `ivory`·`paper` **양 배경에서 4.5:1 이상**이어야 한다.
- `paper`(#ECE6D6)가 `ivory`(#F5F1E8)보다 어두워 **항상 더 엄격한 제약**이므로 바닥값 산정은 `paper` 기준으로 한다. 실측 차이는 약 0.3~0.5 이며, `ivory`만 보고 통과 판정하면 `bg-paper` 카드 내부에서 미달한다.
- **[v1.14 개정 · 판정 격자]** 바닥값 판정은 **{라이트, 다크} × {`ivory`, `paper`} 4개 셀 전부**에서 수행한다. **`paper` 기준 산정 원칙은 다크 테마에도 동일하게 적용된다** — 다크 지면 `paper`(`30 28 26`)도 `ivory`(`18 18 18`)보다 밝아 더 엄격하다. v1.12가 지시한 소형 텍스트 라우팅 `text-cobalt-dark dark:text-cobalt`는 **라이트 절반만 `-dark`로 보내고 다크 절반은 DEFAULT로 되돌려**, `bg-paper` 카드 내부 **8곳이 다크 테마에서 4.37로 미달**한다(→ AC-51). 이는 본 규칙을 **한쪽 테마에만 적용한 계획 오류**이며, v1.11 §6.5의 일관성 결함과 같은 형태다.
- 실측 근거: `--cobalt: #4A7CE8`은 `ivory` 3.49 / `paper` 3.16으로 **대형 텍스트 기준(3:1)은 충족하나 소형 텍스트 기준은 미달**한다. 반면 `--cobalt-dark: #32549E`는 6.43 / 5.82로 양 기준을 충족하며, `--vermillion-dark: #A8231C`(6.38 / 5.77)와 **동일 등급**이 되어 두 강조색의 `-dark` 슬롯이 대칭을 이룬다.
- **[v1.12 추가 · 배지·칩 라우팅]** 강조색을 **배경**으로 쓰는 **비인터랙티브 상태 칩**(`text-[0.65rem]` 등급)은 **`bg-{accent}-dark` + `text-ivory`** 를 사용한다. DEFAULT 배경 위에서는 팔레트 내 전경 중 통과 후보가 **0~1개뿐**이라 설계 여유가 없다 — 실측상 `bg-cobalt`(#4A7CE8) 위 4개 후보(`ivory` 3.49 · `white` 3.93 · `ink-soft` 3.94 · `ink` 5.03) 중 통과는 `ink` **1개뿐**이고, `bg-vermillion`(#D9342B) 위 `ivory`는 **4.16으로 미달**한다. `-dark` 배경은 `ivory` 전경만으로 **6.38~6.43(라이트) / 6.57~6.72(다크)** 를 확보한다.
- **[v1.12 추가 · 짝 칩 등급 일치]** 같은 컴포넌트에서 **짝을 이루는 강조색 칩은 동일 변형 등급**을 사용한다. 한쪽만 `-dark`로 내리면 두 칩의 상대휘도 대비가 **1.19 → 1.54로 악화**된다(실측: `vermillion` L=0.1738 ↔ `cobalt-dark` L=0.0949). 양쪽을 `-dark`로 통일하면 **1.01**로 균형이 잡힌다(`vermillion-dark` L=0.0961 ↔ `cobalt-dark` L=0.0949) — 두 강조색의 `-dark` 변형이 접근성 등급뿐 아니라 **휘도까지 대칭**이기 때문이다.
- **인터랙티브 내비·토글 요소는 예외**로 DEFAULT 배경 + `text-white dark:text-ivory`(4.69 / 5.01)를 유지한다. 근거는 §12.1 D-10 상세(부류 A/B 구분) 참조.
- **[v1.13 개정 · `text-white`의 적용 조건]** 위 예외는 **배경이 DEFAULT 변형일 때에 한정**한다. **`-dark` 배경 위 전경은 `ivory` 단독을 정본**으로 하며 `text-white`·`dark:` 변형을 붙이지 않는다 — 실측 `bg-cobalt-dark` 위 `ivory`는 라이트 **5.26** / 다크 **6.57**로 양 테마를 통과하므로 팔레트 외 색이 불필요하다(→ R-8.29). 커밋 `2441f35`가 `Header.tsx:69,129`·`CategoryNav.tsx:22`의 배경을 `bg-vermillion` → `bg-cobalt-dark`로 바꾸면서 **v1.12가 인정했던 `text-white`의 불가피성이 소멸**했다.
- 자동 검증: **AC-42 · AC-43 · AC-44 · AC-47**.
**R-8.27 [필수 · 색값 변경 시 재측정 의무] *(v1.11 신설)*** `--*-rgb` 값을 변경하는 모든 커밋은 **해당 토큰이 참여하는 전 전경/배경 조합의 대비를 재산정**하고 그 표를 커밋 메시지 또는 리뷰 리포트에 첨부한다.
- `docs/DESIGN.md`의 강조색 교체 안내(커스터마이즈 훅)에 **이 제약을 명문화**한다. 현행 안내는 "강조색 2개와 `-dark` 변형만 교체하면 됩니다"라고 **교체 방법만** 적고 **지켜야 할 대비 제약을 적지 않아**, 안내를 그대로 따른 커밋 `eaddc4f`가 라이트 테마 대비를 9.23 → 3.49로 붕괴시켰다. 문서가 사고의 직접 원인이므로 문서 교정이 재발 방지의 일부다.
- 색값 변경은 **lint·tsc·빌드·기존 게이트 전량을 통과한 채로** 화면 접근성만 무너뜨린다 — §12.1 D-09 상세의 알파 계약 사고와 **동일한 무성(silent) 실패 유형**이며, 이번이 두 번째 발현이다.
**R-8.28 [필수 · 명암 반전 계약] *(v1.11 신설)*** `html.dark`에서 반전되는 모든 토큰은 **라이트 값과 다크 값의 상대휘도가 유의미하게 달라야** 한다 — 두 값 사이의 대비가 **2.0 이상**이어야 한다.
- 근거(실측): 변경 전 `cobalt`는 라이트 `L=0.0509`(#1B3A8A) ↔ 다크 `L=0.2199`(#4D77FF)로 대비 **3.13**이었으나, `eaddc4f` 이후 라이트 `L=0.2170`(#4A7CE8) ↔ 다크 `L=0.2199`로 대비 **1.01**이 되었다. 즉 **라이트 테마가 다크 테마용 밝기를 그대로 반입**했고, 이것이 R-8.26 미달의 직접 원인이다.
- 한 토큰만 반전 계약에서 이탈하면 그 시점에는 반대 테마가 우연히 무사할 수 있으나, **반대 테마 값을 조정하는 순간 양 테마가 동시에 무너진다.**
- **[v1.13 개정 · 검사 범위]** 검사 대상은 **`:root`와 `html.dark` 양쪽에 정의된 전 토큰**이다(현행 10종). 일부 토큰만 검사하는 구현은 본 규칙을 충족하지 않는다 — 현행 게이트는 `cobalt-dark`·`vermillion-dark` **2종만** 검사해 **`--cobalt`의 반전 대비 1.00을 검출하지 못했다**. `--vermillion`(1.25)도 미달이나 최초 커밋 이래의 상태이므로 **D-13**으로 분리한다.
- 자동 검증: **AC-45**.
**R-8.29 [필수 · 반전 토큰 쌍의 `dark:` 불필요 원칙] *(v1.12 신설)*** 전경과 배경이 **모두 반전 토큰**(`--*-rgb`로 정의되어 `html.dark`에서 값이 바뀌는 토큰)이면 **`dark:` 변형 없이 양 테마가 성립해야 한다.** 어떤 조합에 `dark:` 변형이 필요하다면 그것은 **반전하지 않는 색(`white`·리터럴 hex 등)이 섞였다는 신호**이므로, 팔레트 외 색을 제거할 수 있는지 **먼저 검토**한다.
- 실측 대조: `bg-cobalt-dark text-ivory`는 라이트 **6.43** / 다크 **6.57**로 `dark:` 없이 통과한다. 반면 `bg-cobalt text-ink`는 다크에서 `--ink-rgb`가 `245 241 232`로 반전되어 **3.49로 미달**하므로 `dark:text-ivory`를 수동으로 덧대야 한다 — **반전 계약을 손으로 우회하는 구조**이며 R-8.28의 취지에 역행한다.
- `white`가 불가피한 경우(`bg-vermillion` 위 `ivory`가 4.16으로 미달하는 인터랙티브 요소)는 **AC-47 화이트리스트**로 상한을 관리한다. 화이트리스트는 상한이지 허가가 아니다 — 신규 사용처는 먼저 `-dark` 배경으로 대체 가능한지 검토한다.
- **[v1.14 강화 · 강조색 `dark:` 금지]** **강조색(`cobalt`·`vermillion` 및 각 `-dark`)에는 `dark:` 변형을 사용하지 않는다.** 반전 토큰 위에 `dark:`를 덧대는 것은 **반전 계약을 손으로 무력화**하는 행위이며, 실제로 `text-cobalt-dark dark:text-cobalt`는 다크 절반을 DEFAULT로 되돌려 **`bg-paper` 위 4.37**을 만든다. `-dark` 단독은 4개 셀 전부(5.26 / 4.76 / 6.57 / 5.96)를 통과한다.
- 세 가지 정본 패턴만 사용한다 — ⓐ 대형 텍스트(≥24 px)·도형·테두리·아이콘·SVG: **`text-cobalt` / `bg-cobalt` / `border-cobalt`**(3.12~4.82, 바닥값 3.0), ⓑ 소형 텍스트: **`text-cobalt-dark`**(4.76~6.57, 바닥값 4.5), ⓒ 강조 배경: **`bg-cobalt-dark text-ivory`**(5.26 / 6.57). **세 패턴 모두 `dark:` 변형이 없다.**
- 현행 위반 **38건**(`dark:text-cobalt` 28 · `dark:bg-cobalt` 6 · `dark:hover:border-cobalt` 2 · `dark:hover:text-cobalt` 1 · `dark:group-hover:text-cobalt` 1) 전량이 제거 대상이다.
- 자동 검증: **AC-47 · AC-48(C11-9) · AC-51**.
**R-8.30 [필수 · 비텍스트 UI 대비 계약] *(v1.13 신설)*** 테두리·포커스 링·아이콘·상태 도형 등 **비텍스트 UI 구성요소**(WCAG 2.1 §1.4.11)는 인접색 대비 **3:1** 이상을 만족한다.
- **슬래시 알파 수식자를 사용한 색은 배경과 합성한 실효색으로 산정**한다. 알파는 대비를 조용히 갉아먹으며 토큰 값만으로는 판정할 수 없다 — 실측: `focus:ring-cobalt/50`은 `cobalt` 자체가 3.45임에도 `ivory` 위 합성 후 **1.80**(다크 2.07), `hover:border-cobalt/60`은 `paper` 위 **1.95**(다크 2.38)로 **양쪽 다 미달**한다.
- 이는 §12.1 D-09(알파 계약 붕괴)·§12.1 D-10(반전 계약 이탈)에 이은 **"알파·토큰 조합이 무성으로 대비를 무너뜨리는" 유형의 세 번째 발현**이다. 강조색에 알파 수식자를 붙이는 것은 **원칙적으로 지양**하고, 필요하면 `-dark` 변형을 불투명하게 사용한다.
- 통과 확인된 사용처(회귀 방어 기준선): `hover:border-cobalt` 3.12 / `hover:border-cobalt-dark` 4.76 / `hover:border-vermillion` 3.77 / `ring-vermillion` 4.16 / 불릿 `bg-cobalt` 3.45 / 히어로 SVG `var(--cobalt)` 3.45 · `var(--vermillion)` 4.16 (전부 `paper` 또는 `ivory` 기준 라이트값).
- 자동 검증: **AC-48**(Gate 11 · C11-5).
**R-8.31 [필수 · 역할 단위 색 통일 계약] *(v1.13 신설)*** **동일한 클래스 시그니처를 갖는 요소는 단일 색 패턴을 사용한다.** 역할은 파일·행이 아니라 시그니처로 식별한다.
- 판정 대상 시그니처(최소): ⓐ 섹션 장식 괘선 `h-px w-8 bg-*`, ⓑ 섹션 키커 `font-mono text-xs … uppercase tracking-widest … font-bold`, ⓒ 강조 배경 배지·칩의 전경, ⓓ 카드 `hover:border-*`, ⓔ 포커스 인디케이터 `ring-*`.
- 판정 기준은 **"어떤 색인가"가 아니라 "색 패턴이 하나뿐인가"** 이다. 따라서 색 선택 결정(D-12)이 확정되기 전에도 게이트를 구현·운용할 수 있고, 결정이 바뀌어도 게이트는 수정할 필요가 없다.
- 실측 위반: ⓐ `bg-cobalt-dark dark:bg-cobalt` 6곳 ↔ `bg-vermillion` 1곳(`DirectionsBlock.tsx:7`), ⓑ `text-cobalt-dark dark:text-cobalt` 11곳 ↔ `text-vermillion` 1곳(`DirectionsBlock.tsx:8`), ⓒ `text-white dark:text-ivory` 6곳 ↔ `text-ivory` 4곳, ⓓ 4종, ⓔ 2종.
- **같은 데이터가 서로 다른 색으로 렌더되는 것도 위반**이다 — 지도교수 이메일 `sjkoh@knu.ac.kr` 한 값이 `members:54`(5.26) · `DirectionsBlock:43`(4.16) · `Footer:53`(paper 위 hover 3.77)에서 **3색 3대비**로 나타난다.
- 예외는 **화이트리스트 등재**(R-8.32 형식)로만 허용한다.
- 자동 검증: **AC-48**(Gate 11 · C11-1~C11-4).
**R-8.32 [필수 · 게이트 면제 형식 제한] *(v1.13 신설)*** 자동 게이트의 예외는 **`(파일, 행, 사유)` 3-튜플 등재로만** 허용하며, **라인 부분문자열 면제(`if "…" in line: continue`)를 금지**한다. 등재 항목이 실제 소스에 존재하지 않으면(고아 항목) 게이트는 **실패**해야 한다.
- 근거(실측): `run_e2e_tests.py`의 AC-44 구현은 면제 조항에 `"text-vermillion" in line`을 두었는데, 위반 판정 정규식이 `text-(cobalt|vermillion)`이므로 **vermillion으로 매치된 라인은 예외 없이 그 문자열을 포함**한다 — 즉 **AC-44의 vermillion 절반이 영구적으로 발화하지 않는다.** 실제 소스 4개 라인(`lectures:50`·`members:114`·`publications:72`·`DirectionsBlock:8`)과 회귀 주입 2건을 동일 로직에 투입해 **전부 면제됨**을 재현했다.
- 나아가 `"text-3xl"`·`"Pillar #"` 등의 면제도 **라인 전체 부분문자열 검사**라, 삼항식 한 줄에 두 색이 섞이면 **cobalt 검사까지 함께 무력화**된다 — 회귀가 가장 숨기 쉬운 형태가 정확히 그 형태다.
- 이는 **N6**(Gate 8 C1/C2 공허 단정, 10라운드 미해소)과 **동일 유형**이다. 개별 수정이 아니라 **형식 차원의 금지**로 대응한다.
- 자동 검증: **AC-48 · AC-49**(F2 · F9).
**R-8.33 [필수 · 토큰 등급 불변식] *(v1.14 신설)*** 각 테마에서 **`-dark` 변형은 해당 테마의 지면 배경(`ivory`·`paper`) 대비가 DEFAULT보다 커야** 한다. DEFAULT 토큰의 값을 조정할 때는 **같은 테마의 `-dark` 값과의 관계를 반드시 함께 검토**한다.
- **절대 휘도 순서가 테마 간에 뒤집히는 것은 정상 동작이며 위반이 아니다.** `-dark`는 "절대적으로 어두운 색"이 아니라 **"지면 대비가 더 깊은 변형"** 이므로, 다크 지면에서 대비를 깊게 하려면 더 밝아진다. 실측: 라이트 `cobalt` L=0.2203 > `cobalt-dark` L=0.1270 이지만 다크에서는 `cobalt` L=0.2199 < `cobalt-dark` L=0.3184이며, vermillion 쌍도 동일하게 뒤집힌다. **판정 기준을 절대 휘도로 두면 정상 상태를 위반으로 오판한다.**
- 현행 실측(8개 셀 전부 충족): 라이트 `ivory` 3.45→5.26 · 라이트 `paper` 3.12→4.76 · 다크 `ivory` 4.82→6.57 · 다크 `paper` 4.37→5.96 (cobalt), 라이트 `ivory` 4.16→6.38 · 다크 `ivory` 5.01→6.72 (vermillion).
- 근거: 개발 팀장(Agy) 이의제기(Job `4962a667`)가 **다크 DEFAULT만 단독 상향하면 계층이 무너짐**을 지적했고 실측으로 확인했다 — 다크 DEFAULT를 L≈0.52로 올리면 다크 `paper` 대비가 **9.2**가 되어 `-dark`(5.96)를 역전한다.
- 자동 검증: **AC-43**(정책 표에 등급 관계를 포함).
--- ---
## 9. 비기능 요구사항 (Non-Functional Requirements) ## 9. 비기능 요구사항 (Non-Functional Requirements)
@@ -577,6 +670,60 @@ Job `343b5808` 검증에서 본문 좌우 여백·최대 폭 미적용(B1)이,
- [ ] AC-32 *(PJ-05)* 모든 `deliverables[].ref`가 `content/standards.ts`에 실재하는 문서 참조와 일치함을 조인 검증 - [ ] AC-32 *(PJ-05)* 모든 `deliverables[].ref`가 `content/standards.ts`에 실재하는 문서 참조와 일치함을 조인 검증
- [ ] AC-33 *(H-02 개정 · AC-02 회귀 방어)* 히어로 재구성 후에도 **연구실 소개 서술 블록 · 주요 연구 분야 그리드 · 오시는 길 · 지표 카운터 3종 · `HeroComposition`** 이 Home 정적 HTML에 **전부 존속**함을 확인 - [ ] AC-33 *(H-02 개정 · AC-02 회귀 방어)* 히어로 재구성 후에도 **연구실 소개 서술 블록 · 주요 연구 분야 그리드 · 오시는 길 · 지표 카운터 3종 · `HeroComposition`** 이 Home 정적 HTML에 **전부 존속**함을 확인
- [ ] AC-34 *(v1.8 신설 · PJ-13·PJ-15·PJ-16)* 프로젝트 트랙의 넘침을 **브라우저 실측 수치로 판정**한다 — 데스크톱(≥1240 px)에서 `track.scrollWidth === track.clientWidth`(스크롤 잔재 **0**), 모바일·태블릿에서는 `scrollWidth > clientWidth`가 **정상 동작**이다. 어느 뷰포트에서도 **문서 레벨** 가로 스크롤은 0이어야 한다(AC-19 · R-9.15). 데스크톱 3카드 폭의 서브픽셀 거동은 브라우저 없이는 확정할 수 없으므로 **이 단정으로 판정을 이관**한다 - [ ] AC-34 *(v1.8 신설 · PJ-13·PJ-15·PJ-16)* 프로젝트 트랙의 넘침을 **브라우저 실측 수치로 판정**한다 — 데스크톱(≥1240 px)에서 `track.scrollWidth === track.clientWidth`(스크롤 잔재 **0**), 모바일·태블릿에서는 `scrollWidth > clientWidth`가 **정상 동작**이다. 어느 뷰포트에서도 **문서 레벨** 가로 스크롤은 0이어야 한다(AC-19 · R-9.15). 데스크톱 3카드 폭의 서브픽셀 거동은 브라우저 없이는 확정할 수 없으므로 **이 단정으로 판정을 이관**한다
- [ ] AC-35 *(v1.9 신설 · R-8.21·R-8.22)* **슬래시 수식자 실효성 게이트** — 소스(`app/**`·`components/**`의 `.tsx`·`.css`)에서 `토큰/불투명도` 형태로 사용된 **모든 색 유틸리티**를 추출하고, 각각에 대응하는 규칙이 **산출 CSS(`.next/static/css/*.css`)에 실제로 존재**함을 자동 게이트로 확인한다. 1건이라도 누락되면 실패한다. *(현행 실측: 사용 26건 / 생성 0건)*
- [ ] AC-36 *(v1.9 신설 · R-8.21)* `app/globals.css`의 모든 `--*-rgb` 정의가 **공백 구분**임을 grep 게이트로 확인한다(쉼표 포함 시 실패). 아울러 산출 CSS에 `rgb(<쉼표 목록> / …)` 패턴이 **0건**임을 확인한다
- [ ] AC-37 *(v1.9 신설 · R-8.23 · R-9.6)* `components/Header.tsx`에 **인라인 `style` 속성과 리터럴 색값이 0건**이며, 활성 배지 계열 요소에 **`opacity-*` 유틸리티가 0건**임을 grep으로 확인한다
- [ ] AC-38 *(v1.9 신설 · R-9.6)* 활성 내비 배지의 **전 텍스트 상태(데스크톱 라벨·번호 / 모바일 `ko`·`en`·번호)** 가 **라이트·다크 양 테마에서 4.5:1 이상**임을 실측 색값으로 계산해 확인한다. 다크 모드 배경은 `--vermillion-rgb: 235 75 66`으로 **반전**되므로 흰색 전경은 3.74:1로 미달한다 — 다크 모드 전경은 `ivory`(반전 시 `18 18 18`, 실측 5.01:1)를 사용한다
- [ ] AC-39 *(v1.9 신설 · R-8.24 · AC-19)* 헤더 가로 예산을 **1240 / 1280 / 1440 px** 에서 확인한다 — `header.scrollWidth <= header.clientWidth`이고 내비 항목이 **2줄로 접히지 않아야** 한다(브라우저 실측 판정)
- [ ] AC-40 *(v1.9 신설 · IA-03 · AC-25)* 사이트맵에 등재된 **모든 URL**의 산출 HTML이 `redirect()` 전용이 아니라 **`<main>` + `container-content` 를 포함한 실체 문서**임을 확인한다
- [ ] AC-41 *(v1.10 신설 · R-8.25)* 산출 정적 HTML 전 라우트의 **`<main>` 내부 콘텐츠를 정규화 해시**해 **동일 해시가 2건 이상 존재하지 않음**을 자동 게이트로 확인한다. `canonical`이 명시된 예외 쌍만 화이트리스트로 허용한다
- [ ] AC-42 *(v1.10 신설 · v1.11 개정 · R-9.6 · AC-38 확장)* **vermillion 배경 위 텍스트 전량**이 라이트·다크 양 테마에서 4.5:1 이상임을 확인한다. **"전량"은 Header·`CategoryNav`에 한정되지 않으며, `group-open:`·`hover:` 등 상태 변형으로 적용되는 배경도 포함한다.** 검증 대상은 **두 부류로 나누어 각각의 기대 패턴과 기대 대비를 판정**한다*(v1.12 개정)*.
- **부류 A — `text-[0.65rem]` 비인터랙티브 상태 칩**: `app/standardization/page.tsx:40`·`:88` → **`bg-vermillion-dark text-ivory`**(라이트 **6.38** / 다크 **6.72**, `dark:` 변형 없음). R-8.26 배지·칩 라우팅 조항 적용
- **부류 B — 인터랙티브 내비·토글**: `components/Header.tsx:69,129`, `CategoryNav.tsx:22`, `app/lectures/page.tsx:89`, `app/members/page.tsx:177` → **`text-white dark:text-ivory`**(라이트 **4.69** / 다크 **5.01**)
- **[v1.13 개정 · 부류 B 재산정]** ⓐ `Header.tsx:69,129`·`CategoryNav.tsx:22`는 `2441f35`에서 **배경이 `bg-vermillion` → `bg-cobalt-dark`로 바뀌어** `text-white`의 불가피성이 소멸했다 — R-8.26 v1.13 조항에 따라 **`text-ivory` 단독**(라이트 5.26 / 다크 6.57)으로 정정한다. ⓑ **`app/lectures/page.tsx:89`는 여전히 `group-open:text-ivory`(4.16)로 미교정**이며, 동일 관용구인 `members/page.tsx:177`만 교정되어 **한 쌍이 갈라져 있다**. ⓒ **`app/not-found.tsx:22`를 신규 등재** — `text-ivory hover:bg-vermillion`으로 hover 시 **4.16**이며 v1.12까지의 어떤 목록에도 없었다. 권고 조치는 `hover:bg-vermillion-dark`(→ 6.38)로, `white` 없이 해소된다
- *v1.10 기재 정정*: `text-white` on `#D9342B`의 실측은 **4.69:1**이다(직전 수렴 리포트의 4.58:1은 오기 — 판정은 동일하게 통과)
- *현행 미교정 4곳의 실측은 모두 **4.16:1***이며, `lectures:89`·`members:177`은 `group-open:` 상태 변형으로 배경이 적용되어 **육안 리뷰에서 누락되기 쉽다**
- [ ] AC-43 *(v1.11 신설 · v1.12·v1.13 개정 · R-8.26·R-8.27·R-9.6)* **대비 자동 게이트(Gate 10)** — `app/globals.css`의 `:root`·`html.dark` `--*-rgb` 정의를 파싱해 **양 테마 전 조합의 대비를 계산**하고 정책 표의 바닥값 미만이면 실패한다. 최소 대상: `{ink, ink-soft, ink-mute, vermillion, vermillion-dark, cobalt, cobalt-dark} × {ivory, paper}` 및 `{ink, ivory, white} × {vermillion, vermillion-dark, cobalt, cobalt-dark}`. **`-dark` 변형이 배경으로 쓰이는 경우**(`{ivory, white} × {cobalt-dark, vermillion-dark}`, 양 테마)를 반드시 포함한다 — v1.11 목록은 `-dark`를 전경으로만 다루어 **상태 칩 배경을 검사하지 못했다***(v1.12 개정)*. 정책 표는 스크립트 상단 상수 블록에 두어 규격 변경 시 1곳만 수정되게 한다. *(현행 실측: `cobalt`는 `ivory` 3.49 / `paper` 3.16, `cobalt-dark`는 `paper` 4.48로 **실패해야 한다**)*
- **[v1.13 개정 · C10-1]** 현행 구현은 ⓐ 정책 값이 **함수 본문에 흩어져 있어** 상수 블록 요건을 충족하지 않고, ⓑ **토큰 값만 검사하고 소스의 전경/배경 쌍은 보지 않는다** — 따라서 `bg-cobalt-dark text-white`(다크 **2.85**)를 작성해도 통과한다. 검사 대상에 **소스에서 실제로 함께 쓰인 전경/배경 조합**을 추가하고, `text-white`가 전경인 조합을 **양 테마 모두** 계산한다
- **[v1.14 개정]** ⓐ **DEFAULT 토큰 × {`ivory`,`paper`} × {라이트,다크}** 를 **3:1 바닥값**으로 명시 추가한다 — 이 검사가 **D-14 A안의 안전망 본체**이며, 브랜드 색이 어느 테마에서든 역할 바닥값 아래로 내려가면 즉시 실패해야 한다. ⓑ **R-8.33 등급 관계**(각 테마 지면 대비에서 `-dark` > DEFAULT)를 정책 표에 포함한다
- [ ] AC-44 *(v1.11 신설 · v1.13 개정 · R-8.26·R-8.32)* **소형 텍스트 라우팅 게이트** — `app/**`·`components/**`에서 `text-cobalt`·`text-vermillion`(DEFAULT 변형)이 **소형 텍스트 크기 클래스와 동일 요소에 공존하지 않음**을 확인한다. 부모로부터 크기를 상속받아 정적 판정이 불가능한 케이스는 **화이트리스트에 사유와 함께 등재**한다. *(현행 실측: `text-cobalt` 소형 텍스트 사용처 **12건** + `bg-cobalt` 소형 배지 **2건** 미달)*
- **[v1.13 개정 · C10-2]** 현행 구현의 **라인 부분문자열 면제 4종(`"text-vermillion"`·`"text-3xl"`·`"Pillar #"`·`"w-1.5 h-1.5"`)을 전량 제거**하고 R-8.32의 `(파일, 행, 사유)` 화이트리스트로 대체한다. 첫 번째 면제 때문에 **AC-44의 vermillion 절반이 구조적으로 발화하지 않음**을 재현 확인했다(→ R-8.32). 제거 후 `text-vermillion` **23건** 중 소형 텍스트 사용처가 검출되어야 하며, 최저값은 `bg-paper` 카드 내부의 `members/page.tsx:114,144` **3.77**이다
- **[v1.14 개정 · G-7]** 판정 정규식의 **부정 후방탐색 `(?<!dark:)` 를 제거**한다. 현행 구현은 이 후방탐색으로 **`dark:text-cobalt`·`dark:text-vermillion`을 설계상 검사 대상에서 제외**하고 있어, 소형 텍스트 라우팅을 **라이트 테마에 대해서만** 검사한다. 그 결과 다크 테마 `bg-paper` 위 **8곳(4.37)이 검사 범위 밖**이었다(→ AC-51). G-1(부분문자열 면제)·G-2(반전 검사 2종 한정)·G-3(전경/배경 쌍 미검사)에 이은 **네 번째 범위 결함이며, 넷 모두 "검사를 절반만 한다"는 같은 형태**다
- [ ] AC-45 *(v1.11 신설 · v1.13 개정 · R-8.28)* **반전 계약 게이트** — `:root`와 `html.dark`의 동일 토큰 쌍에 대해 라이트↔다크 상대휘도 대비가 **2.0 이상**임을 확인한다. *(현행 실측: `cobalt`는 **1.01**로 실패해야 한다)*
- **[v1.13 개정 · C10-3]** 검사 범위를 **양쪽에 정의된 전 토큰(현행 10종)** 으로 확대한다. 현행 구현은 `cobalt-dark`·`vermillion-dark` **2종만** 검사해 **`--cobalt`의 반전 대비 1.00(라이트 `78 119 255` ↔ 다크 `77 119 255`)을 검출하지 못했다** — v1.11이 D-10의 근본 원인으로 규명한 바로 그 실패 유형의 재발이며, **게이트가 통과했다는 사실 자체가 오탐 신호였다**. 확대 시 `--vermillion`(1.25)도 검출되므로 **D-13 확정 전까지는 화이트리스트에 사유와 함께 등재**한다
- **[v1.14 · 브랜드 고정 토큰 예외 후보]** `--cobalt`(1.00)·`--vermillion`(1.25)은 **사용자 지정 브랜드 색**이며, R-8.29 정리(강조색 `dark:` 변형 38건 제거) 후에는 **어느 테마에서도 소형 텍스트를 담지 않는다**. 남는 사용처는 전부 대형 텍스트·도형·테두리·아이콘이며 **양 테마에서 3:1을 충족**한다(최저 3.12). 이 상태에서 R-8.28을 관철하려면 다크 값을 파스텔로 올려야 하는데, 그러면 **브랜드 색이 다크 테마에서 사라진다**. 처리 방침은 **D-14**로 이관한다 — R-8.28은 *수단*이고 **R-8.26·R-8.30(테마별 대비)이 *목적*** 이므로, 목적 규칙이 **양 테마에서 실효적으로 검사되면**(→ AC-43 개정) 안전망은 유지된다. 검증: 브랜드 색을 `#1B3A8A`로 되돌리고 테마 불변을 유지하면 다크 지면 대비가 **1.80**으로 떨어져 **AC-43이 즉시 실패**한다
- [ ] AC-46 *(v1.11 신설 · AC-43·AC-44·AC-45 유효성)* **폴트 인젝션으로 Gate 10의 실효성을 증명**한다 — ① `--cobalt-dark-rgb`를 `52 98 204`로 되돌리면 AC-43 실패, ② 소형 텍스트를 `text-cobalt`(DEFAULT)로 되돌리면 AC-44 실패, ③ `html.dark`의 `--cobalt-rgb`를 라이트 값과 동일하게 두면 AC-45 실패, ④ `standardization/page.tsx:40`을 `bg-vermillion text-ivory`로 되돌리면 AC-42 실패, **⑤ 상태 칩을 `bg-cobalt text-ivory`(v1.11 §6.5 폐기안)로 되돌리면 AC-43 실패(3.49)**, **⑥ 임의 위치에 `text-white`를 1건 추가하면 AC-47 실패(9 > 8)** *(⑤·⑥은 v1.12 신설)*. **6건 모두 실패를 재현하지 못하면 Gate 10을 채택하지 않는다** — 통과만으로는 게이트가 결함을 검출한다는 증명이 되지 않는다
- ⑤는 **기각·교체된 설계를 게이트가 실제로 잡는지** 확인한다. v1.10에서 기각한 D-09 C안을 주입해 AC-41을 검증한 것과 같은 방식이며, **교체된 설계는 반드시 게이트의 검출 대상이 되어야 한다**
- [ ] AC-47 *(v1.12 신설 · v1.13 개정 · R-8.29)* **팔레트 외 색 상한 게이트** — `app/**`·`components/**`에서 `text-white`·`bg-white` 등 **팔레트 외 색 유틸리티의 출현 횟수가 화이트리스트 등재 건수를 초과하지 않음**을 확인한다.
- 화이트리스트(부류 B 한정, 총 **8건**): `components/Header.tsx:69,75,129,136,145`(5) · `CategoryNav.tsx:22`(1) · `lectures/page.tsx:89`(1) · `members/page.tsx:177`(1)
- 각 항목에 **사유**(해당 위치에서 `ivory` 전경이 4.16으로 미달)를 함께 기재한다. 화이트리스트는 **상한이지 허가가 아니며**, 신규 사용처는 `-dark` 배경으로 대체 가능한지 먼저 검토한 뒤에만 등재한다
- 근거: `docs/DESIGN.md`는 "토큰만 사용 — 임의 회색·팔레트 밖 hex 금지"를 규정한다. `white`는 Issue 01 팔레트(`ink`/`ivory`/`paper`/`line`/`vermillion`/`cobalt`) 밖의 색으로, `02247a0`에서 **불가피성 때문에** 도입되었다. 상한을 두지 않으면 그 불가피성이 관행으로 굳는다
- **[v1.13 개정 · C10-4]** 현행 구현은 `content.count("text-white")` **단순 계수**라 **위치를 검증하지 않는다.** 화이트리스트를 `(파일, 행)` 집합으로 두고 **실제 출현 위치 집합과 완전히 일치**할 때만 통과시킨다(초과·고아 양방향 검출, R-8.32). 배경 변경(`bg-vermillion` → `bg-cobalt-dark`)으로 **현행 7건 중 6건이 R-8.29상 제거 대상**이 되었으므로, Phase 3 완료 후 화이트리스트는 **`lectures/page.tsx:89`·`members/page.tsx:177` 2건**으로 축소되어야 한다 — 이 2곳만이 DEFAULT `bg-vermillion` 위(ivory 4.16 미달)에 있다
**색 통일성 (v1.13 신설)**
- [ ] AC-48 *(v1.13 신설 · R-8.30·R-8.31·R-8.32)* **색 통일성 게이트(Gate 11)** — 아래 8개 검사를 자동화한다. C11-1~C11-4는 R-8.31, C11-5는 R-8.30, C11-7은 AC-23 회귀 방어에 대응한다.
- **C11-1 괘선 통일** — `h-px w-8 bg-*` 시그니처의 색 클래스가 **2종 이상이면 실패** *(현행: `bg-cobalt-dark dark:bg-cobalt` 6곳 ↔ `bg-vermillion` 1곳 → **실패해야 한다**)*
- **C11-2 키커 통일** — `font-mono text-xs … uppercase tracking-widest … font-bold` 시그니처의 색 클래스가 2종 이상이면 실패 *(현행 11곳 ↔ 1곳 → **실패해야 한다**)*
- **C11-3 강조 배경 전경 통일** — `bg-{accent}-dark` 요소에 `text-white`가 결합되어 있으면 실패(R-8.29) *(현행 6건 → **실패해야 한다**)*
- **C11-4 상태 배경 전경 쌍** — `group-open:bg-*`·`hover:bg-*`로 배경이 바뀌는 요소의 대응 상태 전경과의 대비가 4.5 미만이면 실패 *(현행 `lectures:89` 4.16 · `not-found:22` 4.16 → **실패해야 한다**)*
- **C11-5 비텍스트 UI 3:1** — `border-{accent}*`·`ring-{accent}*`·도형 `bg-{accent}*`·SVG의 `var(--*)` 참조를 수집하고, **슬래시 알파는 배경과 합성한 뒤** 계산해 3.0 미만이면 실패 *(현행 `focus:ring-cobalt/50` **1.80** · `hover:border-cobalt/60` **1.95** → **실패해야 한다**)*
- **C11-6 전역 CSS 조합** — `globals.css`의 `background`/`color` 쌍(`::selection` 등)을 파싱해 4.5 미만이면 실패 *(현행 `::selection`은 `ivory` on `vermillion` **4.16** → **실패해야 한다**)*
- **C11-7 문서 동기화** — `docs/DESIGN.md` §3 색상표의 hex ↔ `globals.css`의 `--*-rgb` 대조, 불일치 시 실패 *(현행 일치 — 회귀 방어용)*
- **C11-8 시맨틱 페어링** — R-8.5의 `vermillion = Orchestration` 대응을 히어로 강조 요소에 대해 확인. **D-12 확정 이후에만 활성화**한다
- **C11-9 `dark:` 변형 제로** *(v1.14 신설 · R-8.29)* — `app/**`·`components/**`에 **`dark:` + 강조색**(`cobalt`·`vermillion` 및 각 `-dark`) 조합이 **1건이라도 있으면 실패**. 예외는 R-8.32 화이트리스트 등재로만 허용한다(부류 B의 `dark:text-ivory` 등) *(현행 `dark:*-cobalt` **38건** → **실패해야 한다**)*
- [ ] AC-49 *(v1.13 신설 · AC-48 유효성)* **Gate 10·11 폴트 인젝션** — ① F1 `DirectionsBlock:8` 현행 유지 → C11-2 실패, ② F2 `lectures:50`의 `text-xs text-vermillion` 현행 유지 → AC-44 실패(**면제 제거 확인**), ③ F3 다크 `--cobalt-rgb`를 라이트와 동일하게 유지 → AC-45 실패(1.00), ④ F4 `Header:69`에서 `dark:text-ivory` 제거 → AC-43 또는 C11-3 실패(다크 2.85), ⑤ F5 `standardization:89`를 `bg-cobalt text-ivory`로 되돌림 → AC-43 실패(3.45), ⑥ F6 화이트리스트 밖 위치에 `text-white` 1건 추가 → AC-47 실패(**위치 불일치** — 단순 계수로는 통과했을 사례), ⑦ F7 `focus:ring-cobalt/50` 현행 유지 → C11-5 실패(1.80), ⑧ F8 `docs/DESIGN.md` 색상표 hex 1글자 변경 → C11-7 실패, ⑨ F9 실존하지 않는 `(파일, 행)`을 화이트리스트에 등재 → 고아 항목으로 실패, **⑩ F10 `members/page.tsx:108`을 `text-cobalt-dark dark:text-cobalt`로 되돌리면 AC-44 실패(다크 4.37) — 후방탐색 `(?<!dark:)` 제거 확인**, **⑪ F11 `dark:bg-cobalt` 1건을 되살리면 C11-9 실패** *(⑩·⑪은 v1.14 신설)*.
- **11건 전부 실패를 재현하지 못하면 Gate 11을 채택하지 않는다.** F1·F2·F3·F7·**F10·F11**은 **현행 코드 자체가 주입 상태**이므로 게이트 구현 직후 실행만으로 즉시 검증된다
- [ ] AC-50 *(v1.13 신설 · R-8.27 · AC-23)* **`docs/DESIGN.md` 동기화** — 아래 4건을 교정하고 구현과 일치시킨다.
- **§10 커스터마이즈 훅(302~308행)에 대비 제약을 명문화**한다. 현행 안내는 교체 **방법**만 적고 지켜야 할 제약을 적지 않아 `eaddc4f` 사고의 직접 원인으로 규명되었는데, **v1.11에서 지적된 뒤에도 미교정 상태로 남아 같은 유형의 무기록 색 교체가 4회 더 발생**했다
- **§8-1(282행)** 이 Header 활성 배지를 `bg-vermillion text-white dark:text-ivory`로 기술하나 실제는 `bg-cobalt-dark` — 갱신한다
- **§9(292행)** "강조색 위 텍스트는 항상 `ivory`" ↔ 실제 `text-white` 7건 — R-8.26 v1.13 조항(`-dark` 배경은 `ivory` 단독 / DEFAULT 배경만 `white` 예외)으로 서술을 정합화한다
- **§2(30행)** 시맨틱 페어링 ↔ 히어로 `Orchestration` 색 변경 — **D-12 확정 방향에 맞춰** 코드 또는 문서 중 한쪽을 교정한다
- [ ] AC-51 *(v1.14 신설 · R-8.26·R-8.29)* **다크 테마 소형 텍스트 해소** — `dark:text-cobalt`가 `bg-paper` 위 소형 텍스트에 적용되어 다크 테마에서 **4.37**로 미달하는 아래 **8곳**이 `text-cobalt-dark` 단독(다크 **5.96**)으로 교정되었음을 개별 확인한다.
- `app/page.tsx:148`(Pillar 번호, `text-sm`, `bg-paper` @`:142`) · `app/page.tsx:187`(`Pillar #`, `text-xs` @`:183`)
- `app/members/page.tsx:108`(Ph.D. 학위, `bg-paper` @`:102`) · `app/members/page.tsx:138`(M.S. 학위, `bg-paper` @`:132`)
- `app/_components/ProjectPageView.tsx:88`·`:93`(Standards Track / Organization, `text-xs` @`:80`, `bg-paper` @`:44`)
- `app/standardization/page.tsx:36`(`[{scope}]`, `bg-paper` @`:32`) · `app/publications/[category]/page.tsx:124`(등록번호, `text-xs` @`:118`, `bg-paper` @`:103`)
- `bg-ivory` 위 사용처(`ProjectPageView:53` · `members:54,63,202` · `standardization:64` · `DirectionsBlock:51` · 섹션 키커 전량)는 **4.82로 통과하되 여유가 0.32뿐**이므로 함께 `-dark` 단독으로 정리한다(→ R-8.29 · C11-9)
--- ---
@@ -623,6 +770,12 @@ Publications(P4)는 데이터 규모(223건)와 필터·점진적 노출 요구
| **D-06** | 본문 여백·최대 폭 컨테이너를 **어느 계층에 부여**할 것인가 | ✅ **확정** (v1.6, 2026-07-30) | — | **결정: `<main>` 일괄 부여안 기각 → 라우트 래퍼 방식 + 자동 게이트 채택.** Planner 초안(`<main>`에 `container-content`)은 1행 수정·누락 불가라는 장점이 있으나, 개발 팀장 이의제기(Job `2560771b`)대로 **full-bleed 밴드·마퀴 티커를 구조적으로 차단**한다. 래퍼 방식의 유일한 약점(신규 라우트 누락)은 **AC-25 게이트로 상쇄**되므로 래퍼 방식이 우월하다. → R-8.17~R-8.19 | | **D-06** | 본문 여백·최대 폭 컨테이너를 **어느 계층에 부여**할 것인가 | ✅ **확정** (v1.6, 2026-07-30) | — | **결정: `<main>` 일괄 부여안 기각 → 라우트 래퍼 방식 + 자동 게이트 채택.** Planner 초안(`<main>`에 `container-content`)은 1행 수정·누락 불가라는 장점이 있으나, 개발 팀장 이의제기(Job `2560771b`)대로 **full-bleed 밴드·마퀴 티커를 구조적으로 차단**한다. 래퍼 방식의 유일한 약점(신규 라우트 누락)은 **AC-25 게이트로 상쇄**되므로 래퍼 방식이 우월하다. → R-8.17~R-8.19 |
| **D-07** | Research Project 카드의 **`Funder/Sponsor` 실데이터 확보** 여부 | 🔴 **미결** | `funder` 미노출 + 실존하는 `Standards Track` 표기 | PJ-07. `ISL-2026/` 전체를 `과제·연구비·IITP·NRF·한국연구재단·정보통신기획평가원` 등으로 검색해 **0건**이다. **임의 생성은 MG-05·R-9.17·R-9.18 위반이며 실명·실제 이메일이 게시되는 페이지이므로 절대 불가.** 기본값으로 **구현 차단은 아니며**, 지도교수가 사업명·부처·기간을 제공하면 `content/projects.ts` 재생성만으로 반영된다 | | **D-07** | Research Project 카드의 **`Funder/Sponsor` 실데이터 확보** 여부 | 🔴 **미결** | `funder` 미노출 + 실존하는 `Standards Track` 표기 | PJ-07. `ISL-2026/` 전체를 `과제·연구비·IITP·NRF·한국연구재단·정보통신기획평가원` 등으로 검색해 **0건**이다. **임의 생성은 MG-05·R-9.17·R-9.18 위반이며 실명·실제 이메일이 게시되는 페이지이므로 절대 불가.** 기본값으로 **구현 차단은 아니며**, 지도교수가 사업명·부처·기간을 제공하면 `content/projects.ts` 재생성만으로 반영된다 |
| **D-08** | Research Project 집합의 **정체성 범위** — 레거시 3건(IoT/CCIS/VLC)만인지, ANL 신규 과제를 포함할지 | 🟡 미결 | 레거시 3건 노출, 섹션 라벨 `Research Projects` | 레거시 3건은 IoT 시대 실적이고 현 정체성은 ANL이다. 신규 과제 추가는 지도교수 입력이 필요하다(MG-05). 레거시 3건 비노출은 PR-01에 역행하므로 배제 | | **D-08** | Research Project 집합의 **정체성 범위** — 레거시 3건(IoT/CCIS/VLC)만인지, ANL 신규 과제를 포함할지 | 🟡 미결 | 레거시 3건 노출, 섹션 라벨 `Research Projects` | 레거시 3건은 IoT 시대 실적이고 현 정체성은 ANL이다. 신규 과제 추가는 지도교수 입력이 필요하다(MG-05). 레거시 3건 비노출은 PR-01에 역행하므로 배제 |
| **D-09** | `/publications` 인덱스 라우트를 **Overview 뷰 / `redirect()` / 기본 카테고리 재렌더 / 전체 통합 뷰 + `All` 탭** 중 무엇으로 둘 것인가 | ✅ **재확정** (v1.10, 2026-07-31) | — | **결정: Overview 뷰 채택(A안).** v1.9는 C안(첫 카테고리 본문 재렌더)을 채택했으나, 개발 팀장 이의제기(Job `22b7a309`)대로 **동일 DOM 정적 HTML 2본**이 생성되어 R-8.25를 위반한다 — 지적이 타당하여 채택안을 교체한다. `redirect()`(B안)는 AC-25·AC-40과 충돌하고, `All` 탭 포함 전체 통합 뷰(D안)는 commit `22a31ff`의 탭 제거 결정을 되돌리며 223건 단일 페이지로 P-07·R-9.11과도 충돌한다. A안은 **고유 콘텐츠**(카테고리별 집계 + 최신 하이라이트)를 가지므로 중복이 원천 소멸하고, `All` 탭 없이 3개 탭 체계를 유지해 `22a31ff`의 의도를 보존한다 → IA-03 재개정 · R-8.25 · AC-41 |
| **D-10** | `eaddc4f`가 도입한 `--cobalt: #4A7CE8`의 **라이트 테마 대비 미달**(ivory 3.49 / paper 3.16)을 어떻게 해소할 것인가 | ✅ **확정** (v1.11, 2026-07-31) | — | **결정: C안 채택 — `--cobalt`는 #4A7CE8 그대로 두고 `--cobalt-dark`를 `52 98 204`(#3462CC) → `50 84 158`(#32549E)로 재조정한 뒤, 소형 텍스트 사용처를 `-dark` 변형으로 라우팅한다.** 근거: ⓐ **사용자가 지정한 브랜드 색이 보존된다** — 히어로 SVG(`var(--cobalt)` 직접 참조)·대형 세리프 수치·불릿·테두리·아이콘 등 시각적으로 먼저 인지되는 표면은 전부 #4A7CE8을 유지하며, 이들은 대형 텍스트·비텍스트 UI 기준(3:1)을 실측 3.49로 충족한다. ⓑ `cobalt-dark` 슬롯은 **현재 사용처 0건**이므로 신규 토큰 없이 빈 슬롯을 활용해 토큰 계층이 늘지 않는다. ⓒ 결과값 6.43 / 5.82는 `vermillion-dark`(6.38 / 5.77)와 **동일 등급**이라 두 강조색이 대칭이 된다. **기각 사유** — A안(`--cobalt` 자체를 #3C64BC로 하향)은 브랜드 색이 눈에 띄게 어두워져 지시를 훼손하고, B안(신규 `--cobalt-text` 토큰)은 비어 있는 `-dark` 슬롯과 역할이 중복되며, D안(#1B3A8A 복귀)은 사용자 지시 역행이다. **#3C64BC(paper 4.51)가 아니라 #32549E(5.82)를 쓰는 이유**는 4.51이 임계선 대비 여유 0.01에 불과해 §12.1의 `opacity-90` 사고(4.69 → 4.05)처럼 후속 변경 한 번으로 재미달하기 때문이다. **v1.12 개정 — 배지·칩 전경/배경**: 개발 팀장(Agy) 이의제기(Job `7f136931`)를 수용해 v1.11의 `bg-cobalt text-ink dark:text-ivory`(5.03 / 4.82)를 **폐기**하고 **`bg-cobalt-dark text-ivory`(6.43 / 6.57)** 로 교체한다. v1.11은 소형 *텍스트* 12곳에만 `-dark` 라우팅을 적용하고 **동일 크기 등급(10.4 px)의 상태 칩 2곳은 DEFAULT 배경으로 남겨 스스로의 원칙과 어긋나 있었다** — 지적이 타당하다. 다만 이의제기의 권장 전경 `text-white dark:text-ivory`(7.25 / 6.57)는 **미채택** — `-dark` 배경에서는 `ivory` 전경만으로 양 테마가 통과하므로 팔레트 외 색 `white`와 `dark:` 변형이 **모두 불필요**하다(→ R-8.29). 아울러 권장안을 그대로 적용하면 `standardization:87-89` 삼항식의 **나란한 두 칩의 상대휘도 대비가 1.19 → 1.54로 악화**되므로, vermillion 칩도 `-dark`로 통일해 **1.01**로 맞춘다(→ R-8.26 짝 칩 등급 일치 조항) **v1.13 개정 — 확정값 갱신**: 커밋 `ca4a7ee`·`8db16e4`가 `--cobalt`를 **#4E77FF**, `--cobalt-dark`를 확정값 #32549E가 아닌 **#345AD2**(`52 90 210`)로 설정했다. #345AD2는 `paper` **4.76** / `ivory` **5.26**으로 R-8.26 바닥값을 **충족**하고 브랜드 색상(226.1°)에도 #32549E보다 가까우므로 **확정값을 #345AD2로 개정**한다. 단 `paper` 여유가 **0.26**뿐이라 위에서 #3C64BC를 배격한 것과 같은 사유가 부분적으로 적용되므로 §12.2 R-4로 등재하고, **추가 상향은 금지**한다(색상 유지 시 `paper` 4.5 한계는 #3B5AC2 4.92 부근이라 이득이 작다). 아울러 **#4E77FF는 반전 대비 1.00으로 R-8.28을 다시 위반**하며 이는 D-10 근본 원인의 재발이다 → **D-12**로 이관 → R-8.26 · R-8.28 · R-8.29 · AC-42 · AC-43 · AC-44 · AC-45 · AC-47 |
| **D-11** | `text-vermillion`(DEFAULT) 소형 텍스트 **약 30곳**을 교정할 것인가 | 🟡 미결 | **현행 유지 (교정하지 않음)** | 실측 `ivory` 4.16 / `paper` 3.77로 R-8.26 소형 텍스트 기준에 미달하나, ⓐ `eaddc4f`가 만든 회귀가 아니라 **최초 커밋 `36a4cd8` 이래의 상태**이고, ⓑ 30곳 일괄 변경은 "전체적인 에디토리얼 디자인 시스템 유지" 목표와 정면 충돌하는 시각적 대변경이며, ⓒ **vermillion(#D9342B)은 사용자가 명시적으로 현행 유지를 지정한 색**이다. 교정 시에는 D-10과 동일한 패턴(`text-vermillion-dark dark:text-vermillion`, 라이트 6.38 / 5.77)을 적용하면 되므로 **기술적 경로는 확보되어 있고 판단만 남는다.** AC-44 화이트리스트에 사유와 함께 등재해 게이트가 이 결정을 명시적으로 기록하게 한다. **v1.13 실측 갱신** — 정확한 건수는 **23건**(상태 변형 포함)이며 최저값은 `bg-paper` 카드 내부의 `members/page.tsx:114,144` **3.77**이다. `Footer.tsx:53,71`의 `hover:text-vermillion`도 `bg-paper` 위라 **3.77**이다 |
| **D-12** | **"Primary Color(#4E77FF) 전 요소 통일 적용"의 판정 기준을 토큰 값으로 볼 것인가, 화면 인지색으로 볼 것인가** — 그리고 히어로 `Orchestration` 강조어의 색을 R-8.5 규약대로 vermillion으로 되돌릴 것인가 | 🔴 미결 (v1.13 신설) | **A안 + B안 병행** | 접근성 제약상 소형 텍스트에는 #4E77FF를 쓸 수 없다(라이트 3.45 / 3.12). 그 결과 **토큰은 #4E77FF, 화면은 #345AD2**라는 이중 상태이며, 라이트 테마에서 #4E77FF가 **정적으로** 칠해지는 곳은 히어로 SVG와 6 px 불릿 **2곳뿐**이다(hover·focus 제외). **A안(현행 유지)**: 코드 변경 0, 지시는 토큰 수준에서 충족. **B안(대형 표면 확대)**: `page.tsx:84,92`의 30 px 지표 등 3:1을 충족하는 **대형 텍스트·도형 표면에 #4E77FF를 적극 확대**해 브랜드 가시성을 회복한다 — 접근성 손실 없이 문제를 실질적으로 완화하는 유일한 경로다. **C안(`-dark` 상향) 기각** — 여유 0.26에서 더 밝히면 D-10이 배격한 임계선 상황에 근접한다. **히어로 `Orchestration`**: `docs/DESIGN.md:30`과 R-8.5가 **vermillion = Orchestration**을 명문 규정하므로, cobalt를 유지하려면 **문서를 먼저 개정**해야 한다. 현재는 코드가 문서를 앞질러 같은 페이지 안에서 규약이 반씩 갈린 상태다. 어느 쪽이든 **코드와 문서가 같은 값을 말해야 한다** → R-8.5 · AC-48(C11-8) · AC-50 |
| **D-13** | `--vermillion`의 **반전 대비 1.25**(라이트 `217 52 43` ↔ 다크 `235 75 66`)를 교정할 것인가 | 🟡 미결 (v1.13 신설) | **현행 유지 + 화이트리스트 등재** | R-8.28 바닥값 2.0에 미달하나 ⓐ **최초 커밋 이래의 상태**로 특정 커밋이 만든 회귀가 아니고, ⓑ **#D9342B는 사용자가 현행 유지를 지정한 Secondary**이며, ⓒ `--vermillion-dark`(2.58)가 정상이라 소형 텍스트 경로는 이미 확보되어 있다. 다만 R-8.28의 취지대로 **"반대 테마 값을 조정하는 순간 양 테마가 동시에 무너지는" 상태**이므로, AC-45 화이트리스트에 **사유와 함께 등재**해 게이트가 이 결정을 명시적으로 기록하게 한다 → R-8.28 · AC-45 |
| **D-14** | `--cobalt` DEFAULT의 **반전 대비 1.00**을 어떻게 처리할 것인가 — R-8.28 예외로 등록할 것인가, 다크 값을 대칭 상향할 것인가 | 🔴 미결 (v1.14 신설, Agy 이의제기 `4962a667` 반영) | **A안 (브랜드 고정 예외)** | R-8.29 정리(강조색 `dark:` 변형 38건 제거) 후 `--cobalt` DEFAULT는 **어느 테마에서도 소형 텍스트를 담지 않으며** 남는 사용처(히어로 SVG·6 px 불릿·hover 테두리·토글 아이콘·대형 텍스트)가 **양 테마에서 3:1을 충족**한다(최저 3.12). 즉 **측정 가능한 실패는 남지 않고 형식적 위반만 남는다.** **A안 — 브랜드 고정(theme-invariant) 토큰으로 등록**: 다크 값을 라이트와 정확히 동일(`78 119 255`)하게 맞춰 불변성을 소스에 드러내고 AC-45 화이트리스트에 등재한다. 근거 ⓐ R-8.28은 *수단*, R-8.26·R-8.30(테마별 대비)이 *목적* 이며 목적 규칙이 양 테마에서 실효 검사되면(AC-43 v1.14 개정) 안전망이 유지된다 — 검증: `#1B3A8A` 역주입 시 다크 지면 대비 **1.80**으로 AC-43 즉시 실패. ⓑ #4E77FF는 **사용자 지정 Primary**이므로 다크 테마만 다른 색으로 치환하면 브랜드 정체성이 갈라진다. **B안 — 대칭 상향(이의제기 구조 채택 · 수치 정정)**: `--cobalt-rgb`(다크) `168 188 255`(#A8BCFF, 반전 **2.09**) + `--cobalt-dark-rgb`(다크) `199 212 255`(#C7D4FF, 반전 **4.04**, 다크 `paper` 11.56 > DEFAULT 9.14로 R-8.33 충족). 이의제기 원안의 `#85ACFF`는 반전 **1.73**으로 **R-8.28 미달**이라 미채택하고, `#B0CDFF`의 기재 반전 2.50은 `#345AD2`의 상대휘도를 폐기값 #32549E의 0.0949로 적은 오기에서 파생된 값으로 실제는 **3.68**이다. B안의 비용은 다크 강조색이 **파스텔로 변해 브랜드 색이 다크 테마에서 사라지고** `bg-cobalt-dark` 칩이 대비 12.75의 거의 흰 배경이 되는 것 — **D-12(브랜드 가시성)를 다크 테마에서 악화**시킨다. **A안은 본 계획자가 작성한 R-8.28을 스스로 완화하는 제안이므로 cline·GM의 별도 심사를 요청**하며, 승인 전에는 집행하지 않는다 → R-8.28 · R-8.29 · R-8.33 · AC-43 · AC-45 |
#### D-01 상세 #### D-01 상세
@@ -658,6 +811,178 @@ PR-04에 명시된 4개 라벨 중 **1번과 2번의 범위가 논리적으로
이 확정으로 §4.1 사이트맵·§7 `PubCategory`·P-01·P-03이 v1.5에서 함께 갱신되었고, 문서 상태가 `승인(Approved)`으로 전환되었다. 이 확정으로 §4.1 사이트맵·§7 `PubCategory`·P-01·P-03이 v1.5에서 함께 갱신되었고, 문서 상태가 `승인(Approved)`으로 전환되었다.
#### D-09 상세 — 색 토큰 알파 계약 붕괴와 `/publications` 리다이렉트 *(v1.9)*
D-09를 촉발한 것은 라우트 문제 하나가 아니라, **정적 게이트 전부를 통과하면서 화면만 무너지는 결함 계열**이 한 배치에서 두 종류 확인된 사건이다. 계약을 §8.7로 승격한 근거를 여기에 기록한다.
**(1) 근본 원인 — 쉼표 구분 `--*-rgb`**
`app/globals.css`는 토큰을 `--vermillion-rgb: 217, 52, 43;`처럼 **쉼표 구분**으로 정의해 왔다. 반면 `tailwind.config.ts`는 `rgb(var(--vermillion-rgb) / <alpha-value>)`를 선언했고, Tailwind는 이를 다음으로 전개한다.
```
.bg-vermillion { --tw-bg-opacity: 1; background-color: rgb(var(--vermillion-rgb) / var(--tw-bg-opacity, 1)) }
↓ var() 치환 후
rgb(217, 52, 43 / 1) ← 무효
```
`rgb()`는 **공백+슬래시(현대)** 또는 **전량 쉼표(레거시)** 중 하나여야 하며 혼용은 문법 위반이다. 무효 선언은 *invalid at computed-value time* 으로 폐기되므로 **토큰 배경색이 아예 적용되지 않는다.** 커밋 `7889398`("solid vermillion background")·`40b252b`("enforce high contrast white text")가 같은 증상을 반복 교정하려 한 이력이 이 진단을 뒷받침한다.
**(2) 부작용 — `<alpha-value>` 제거가 만든 2차 무성 결함**
`7889398`은 위 증상을 `colors.ivory = "var(--ivory)"` 형태로 축약해 해결했다. 단색은 정상화되었으나, **알파 자리표시자가 사라지면 Tailwind는 슬래시 수식자 유틸리티를 오류 없이 생략한다**(독립 프로브로 확인). 그 결과 소스에 남은 **26개 사용처가 전부 무효화**되었고 lint·tsc·빌드·Gate 0–7은 그대로 통과했다.
| 소멸한 유틸리티 계열 | 대표 사용처 | 실제 화면 |
| :--- | :--- | :--- |
| `bg-*/…` | `Header` `bg-ivory/85` | sticky 헤더 **배경 소실**(본문이 비쳐 지나감) |
| `border-*/…` (15건) | `border-line/60` 등 | Preflight 기본색 **`#e5e7eb`** — 팔레트 외 회색, 다크 모드에서 특히 부각 |
| `text-*/…` | `Footer` `text-ink/90` | 부모 색 **상속** |
| `ring-*/…` | `ProjectPageView` `focus:ring-vermillion/50` | Tailwind 기본 **파란색** 포커스 링 |
**(3) 3차 결함 — 인라인 `style` 우회**
단색이 적용되지 않는 상태를 우회하려 활성 배지에 `style={{ backgroundColor: "var(--vermillion)", color: "#ffffff" }}`가 투입되었다. 인라인 `style`은 `dark:` 변형을 항상 이기므로 **다크 모드에서 흰색 전경이 고정**되었고, `opacity-90`이 함께 도입되어 대비가 추가로 떨어졌다. 이는 Job `b3f001de`에서 제기하고 `43c75da`에서 해소했던 R-9.6 결함의 **직접 회귀**다.
| 상태 | 라이트 | 다크 | 판정 |
| :--- | :--- | :--- | :--- |
| 배지 라벨 (흰색 단색) | 4.69:1 | **3.74:1** | 다크 미달 |
| 배지 번호·`en` (`opacity-90`) | **4.05:1** | **3.29:1** | 양 테마 미달 |
| 참고: `43c75da`의 `dark:text-ivory` | 4.69:1 | 5.01:1 | 양 테마 충족 |
**(4) 확정 — 계약 복원이 스타일 보존과 일치한다**
| 항목 | 내용 |
| :--- | :--- |
| 채택 | `--*-rgb`를 **공백 구분으로 정정**(R-8.21) + `tailwind.config.ts`에 **`<alpha-value>` 복원**(R-8.22) + 인라인 `style`·`opacity-*` **제거**(R-8.23) |
| 기각 | `<alpha-value>` 제거 상태 유지 후 26개 사용처를 각각 리터럴 색으로 치환 — 토큰 체계가 사실상 붕괴하고 다크 모드 반전이 사용처마다 깨진다 |
| 스타일 영향 | **의도된 디자인으로의 복원이며 재디자인이 아니다.** 사용처 26곳은 원래 의도대로 렌더되고, 단색 토큰은 `7889398` 이후 상태를 그대로 유지한다 |
| 재발 방지 | AC-35(슬래시 수식자 실효성) · AC-36(공백 구분) · AC-37(인라인 `style` 0건) · AC-38(양 테마 대비) 게이트 신설 |
**(5) `/publications` 라우트** *(v1.10 재확정)*
같은 배치에서 `All Overview` 탭 제거와 함께 `/publications`가 `redirect()`로 대체되어 **Gate 8이 실측 실패**했다(`<main> tag not found in .next/server/app/publications.html`).
v1.9는 **C안(첫 카테고리 본문 재렌더)** 을 채택했으나, 개발 팀장 이의제기(Job `22b7a309`)가 **정적 HTML 2본이 동일 DOM을 갖는 문제**를 지적했고 이는 타당하다. 현재 코드베이스에 `metadataBase`·`alternates.canonical`이 **전무**함을 확인했으므로(grep 0건), C안을 그대로 두면 완화 장치 없이 중복이 노출된다. 이에 **A안(Overview 뷰)** 으로 교체한다.
| 안 | 중복 | `22a31ff`(All 탭 제거) 의도 | AC-25/40 | 판정 |
| :--- | :--- | :--- | :--- | :--- |
| A · Overview 뷰 | **없음** | **보존**(탭은 3개 유지) | 충족 | ✅ **채택** |
| B · `redirect()` 유지 | — | 보존 | **위반** | 기각 |
| C · 첫 카테고리 재렌더 | **2본 동일** | 보존 | 충족 | 기각 (v1.9 → v1.10 교체) |
| D · 전체 통합 + `All` 탭 | 없음 | **역행** | 충족 | 기각 |
한편 이의제기의 두 번째 논거(`isActive` 하이라이트 모호)는 **성립하지 않는다.** `Header.tsx`의 활성 판정은 `pathname === href || pathname.startsWith(\`${href}/\`)`이므로, `href="/publications"`는 세 하위 카테고리 경로 전부에 대해 이미 참이 된다. v1.9 계획의 3-3(예외 분기 제거)은 이 일반 규칙만으로 성립하며 별도 조치가 필요 없다. Overview에서 하위 탭이 하나도 활성이 아닌 것은 결함이 아니라 **Overview의 정상 상태**다(→ IA-03).
---
#### D-10 상세 — 강조색 교체가 대비를 붕괴시킨 경위 *(v1.11)*
**증상.** 커밋 `eaddc4f`("update primary color token to #4A7CE8 and secondary to #D9342B") 이후 라이트 테마에서 cobalt 계열 소형 텍스트가 읽기 어려워졌다. **lint·tsc·프로덕션 빌드·기존 게이트 0~9가 전부 통과한다** — 빌드는 exit 0, 정적 13/13 생성, 동적 라우트 0건이다.
**변경 실체.** `:root` 블록 2줄만 바뀌었다.
```diff
- --cobalt-rgb: 27 58 138; /* #1B3A8A */
- --cobalt-dark-rgb: 18 40 99; /* #122863 */
+ --cobalt-rgb: 74 124 232; /* #4A7CE8 */
+ --cobalt-dark-rgb: 52 98 204; /* #3462CC */
```
`html.dark` 블록(`--cobalt-rgb: 77 119 255`)과 `--vermillion-*`는 **양 블록 모두 미변경**이다.
**대비 실측(WCAG 2.1 공식 재계산).**
| 조합 | 변경 전 | 변경 후 | 판정 |
| :--- | ---: | ---: | :--- |
| `text-cobalt` on `ivory` | 9.23 | **3.49** | 소형 텍스트 미달 |
| `text-cobalt` on `paper` | 8.35 | **3.16** | 소형 텍스트 미달 |
| `ivory` on `bg-cobalt` | 9.23 | **3.49** | 미달 |
| `text-cobalt-dark` on `paper` | 11.16 | **4.48** | 간발의 미달 |
소형 텍스트 미달 사용처는 **14건**(`text-cobalt` 12건 + `bg-cobalt` 소형 배지 2건)이다. 반면 `page.tsx:92`(`text-3xl`, 30 px)·`page.tsx:174`(불릿 도형)·`ThemeToggle.tsx:146`(아이콘)·`members/page.tsx:102,132`(`hover:border-cobalt`)는 **대형 텍스트·비텍스트 UI 기준 3:1을 3.49로 충족**한다. 즉 **#4A7CE8은 큰 글자·도형으로는 적법하고 작은 글자로만 부적법**하며, 이 경계가 D-10 채택안의 설계 근거다.
**근본 원인 — 반전 계약 이탈.** 이 시스템의 모든 토큰은 `html.dark`에서 반전된다(`ivory` 245→18, `ink` 10→245). cobalt도 예외가 아니어서 라이트는 짙은 남색, 다크는 밝은 청색이었다.
| | 라이트 L | 다크 L | 라이트↔다크 대비 |
| :--- | ---: | ---: | ---: |
| 변경 전 | 0.0509 (#1B3A8A) | 0.2199 (#4D77FF) | **3.13** |
| 변경 후 | 0.2170 (#4A7CE8) | 0.2199 (#4D77FF) | **1.01** |
**라이트 값이 다크 값과 사실상 같은 밝기가 되었다** — cobalt 한 토큰만 반전 체계에서 이탈해, 라이트 테마가 다크 테마용 밝기를 그대로 반입했다. → R-8.28.
**게이트가 놓친 이유.** Gate 6은 `["--ink", "--ivory", …, "--cobalt"]`의 **문자열 존재 여부만** 확인하고, Gate 9는 **알파 계약**(구분자·`<alpha-value>`·인라인 `style`)만 확인한다. `run_e2e_tests.py`에 `contrast`·`4.5`·`luminance` 검사는 **0건**이다. 즉 **토큰의 "값"을 검사하는 게이트가 없어** `--cobalt: #FF00FF`로 바꿔도 10개 게이트가 전부 통과한다. → AC-43 · AC-44 · AC-45 · AC-46.
**문서가 사고에 기여한 부분.** `docs/DESIGN.md`의 커스터마이즈 훅은 "강조색 2개와 그 `-dark` 변형만 교체하면 됩니다"라고 **교체 방법만** 안내하고 **지켜야 할 대비 제약을 적지 않는다.** 안내를 문자 그대로 따른 결과가 이 커밋이므로, 문서 교정(R-8.27)이 재발 방지의 일부다.
**부수 확인 — Secondary는 무변경.** 커밋 메시지의 `…and secondary to #D9342B`는 변경이 아니라 **현상 유지의 서술**이다. `--vermillion-rgb`는 최초 커밋 `36a4cd8`(`--vermillion: #d9342b`) 이래 상수이며, `02247a0`의 `217, 52, 43` → `217 52 43`은 R-8.21 구분자 교정이지 색 변경이 아니다. 수렴 대장에 "Secondary 변경 검증 완료"로 기재되면 사실과 어긋나므로 **무변경(no-op)** 으로 기록한다.
**AC-42 미충족 잔존.** 직전 수렴(`02247a0`)에서 AC-42는 통과로 판정되었으나, 문언의 "vermillion 배경 위 텍스트 **전량**" 중 교정된 것은 Header 2곳·`CategoryNav` 1곳뿐이고 `standardization/page.tsx:40`·`:88`, `lectures/page.tsx:89`, `members/page.tsx:177`의 **4곳이 4.16:1로 남아 있다**(뒤 두 곳은 `group-open:` 상태 변형이라 육안 리뷰에서 누락되기 쉽다). → AC-42 개정.
##### D-10 보론 — 배지·칩 부류 분리 *(v1.12, Agy 이의제기 `7f136931` 반영)*
**v1.11의 설계 오류.** v1.11 §6.5는 `bg-cobalt`(#4A7CE8) 배경을 유지한 채 전경만 `text-ink`로 바꾸도록 정했다. 이는 채택안 C의 원칙("**작은 요소는 `-dark` 변형으로 라우팅한다**")을 **소형 텍스트 12곳에만 적용하고 동일 크기 등급의 상태 칩 2곳에는 적용하지 않은** 일관성 결함이다. 개발 팀장 이의제기가 이를 정확히 지적했다.
**기술적 근거(심미 판단과 독립).** 이의제기의 논거는 "짙은 검은 텍스트가 매거진 톤을 훼손한다"는 심미 판단이나, 같은 결론을 취향과 무관하게 지지하는 근거가 있다.
| `bg-cobalt`(#4A7CE8) 위 전경 | 대비 |
| :--- | ---: |
| `ivory` | 3.49 🔴 |
| `white` | 3.93 🔴 |
| `ink-soft` | 3.94 🔴 |
| `ink` | **5.03** ✅ (유일) |
팔레트 내 후보 4종 중 **통과는 1종뿐**이고, 그마저 라이트 전용이다 — 다크에서 `--ink-rgb`가 `245 241 232`로 반전되어 3.49로 미달하므로 `dark:text-ivory`를 수동으로 덧대야 한다. 즉 **반전 계약을 손으로 우회하는 구조**였다. `bg-cobalt-dark text-ivory`는 6.43 / 6.57로 **`dark:` 없이 양 테마가 자동 통과**한다(→ R-8.29).
**권장안을 그대로 쓰지 않은 이유 — 짝 칩 무게 불균형.** 대상인 `app/standardization/page.tsx:86-90`은 **하나의 삼항식**으로, `InProgress`(vermillion)와 그 외(cobalt) 배지가 문서 목록의 **같은 자리에 번갈아** 나타난다.
| 조합 | 배경 상대휘도 | 두 칩 간 대비 |
| :--- | ---: | ---: |
| v1.11: `vermillion` #D9342B ↔ `cobalt` #4A7CE8 | 0.1738 ↔ 0.2170 | 1.19 |
| 이의제기 권장안: `vermillion` ↔ `cobalt-dark` #32549E | 0.1738 ↔ 0.0949 | **1.54** (악화) |
| **v1.12 확정**: `vermillion-dark` #A8231C ↔ `cobalt-dark` #32549E | 0.0961 ↔ 0.0949 | **1.01** |
cobalt 칩만 어둡게 내리면 vermillion 칩이 밝은 채로 남아 무게 차가 오히려 벌어진다. **이의제기의 논거(에디토리얼 완성도)가 요구하는 vermillion 쪽 대칭 조치가 권장안에서 누락**되었다. 두 강조색의 `-dark` 변형은 휘도가 거의 같으므로(0.0961 vs 0.0949) **추가 색 조정 없이** 균형이 나온다.
**부류 A / 부류 B.** 크기 기반으로 두 패턴을 분리한다 — R-8.26의 논리(가장 작은 글자에 가장 여유 있는 대비)를 연장한 것이다.
| 부류 | 대상 | 패턴 | 라이트 / 다크 |
| :--- | :--- | :--- | ---: |
| **A** 상태 칩(`text-[0.65rem]`) | `standardization:40`·`:88`(verm) · `standardization:89` · `publications/[category]:135`(cobalt) | `bg-{accent}-dark text-ivory` | **6.38~6.43 / 6.57~6.72** |
| **B** 인터랙티브 내비·토글 | `Header:69,129` · `CategoryNav:22`(교정 완료) · `lectures:89` · `members:177` | `text-white dark:text-ivory` | 4.69 / 5.01 |
**부류 B를 `-dark`로 내리지 않는 이유**: ① Header 활성 배지는 사이트에서 가장 눈에 띄는 브랜드 표면이며 #D9342B → #A8231C 변경은 "전체 스타일 유지" 지시를 벗어난다. ② 해당 2곳은 `02247a0`에서 교정되어 리뷰 PASS를 받았으므로 불필요한 재작업·재검증을 유발한다. ③ 4.69:1은 AA를 충족한다 — 개선 여지는 있으나 결함이 아니다.
**시각 변경 고지.** 부류 A의 vermillion 칩 2곳은 배경이 **#D9342B → #A8231C로 실제로 어두워진다.** `#A8231C`는 팔레트에 이미 정의된 `vermillion-dark`이므로 신규 색이 아니며(R-8.1 위반 아님) 대상 면적도 `text-[0.65rem]` 칩 2개로 극히 작다. **GM이 배경 무변경을 선호하면 부류 B 패턴(`bg-vermillion text-white dark:text-ivory`, 4.69)으로 내려도 규격은 충족**되며, 그 경우 위 표의 무게 불균형 1.54가 남는다는 점만 함께 기록한다 — **차단 사유가 아니라 선택지다.**
#### D-12 상세 — 게이트가 녹색인 채로 남은 결함과 브랜드 색의 가시성 *(v1.13)*
**관측.** `eaddc4f` → `082d71e` 4개 커밋 이후 상태에서 `npm run build`(exit 0 · 13/13 정적 · `ƒ Dynamic` 0건)와 `run_e2e_tests.py` **Gate 0~10 전량**이 통과한다. 그러나 같은 상태에서 **WCAG AA 미달 6건과 통일성 결함 9건**이 실재한다. 특히 `lectures/page.tsx:89`는 **v1.12 AC-42 부류 B에 "미교정"으로 명시 등재된 항목**인데 신설된 대비 게이트가 이를 통과시켰다.
**원인 — 게이트의 범위 결함 3종.**
| ID | 결함 | 결과 |
| :--- | :--- | :--- |
| G-1 | AC-44 구현의 면제 조항 `if … or "text-vermillion" in line: continue`. 위반 판정 정규식이 `text-(cobalt\|vermillion)`이므로 **vermillion으로 매치된 라인은 예외 없이 그 문자열을 포함**한다 | **AC-44의 vermillion 절반이 영구 무효.** 실제 소스 4개 라인 + 주입 2건을 동일 로직에 투입해 전부 면제됨을 재현 |
| G-2 | AC-45 구현이 `cobalt-dark`·`vermillion-dark` **2종만** 검사 | **`--cobalt` 반전 대비 1.00 미검출** — D-10 근본 원인의 재발 |
| G-3 | AC-43 구현이 토큰 값만 보고 **소스의 전경/배경 쌍은 보지 않음** | `bg-cobalt-dark text-white`(다크 2.85)를 작성해도 통과 |
G-1은 **N6**(Gate 8 C1/C2 공허 단정, 10라운드 미해소)과 **동일 유형**이다 — 단정·면제가 구조적으로 발화하지 않는데 출력은 ✅로 찍힌다. 개별 수정이 아니라 형식 차원의 금지(**R-8.32**)로 대응한다. 아울러 §12.1 D-09(알파 계약)·D-10(반전 계약)에 이어 `focus:ring-cobalt/50` **1.80** · `hover:border-cobalt/60` **1.95**가 드러났다 — **알파·토큰 조합이 무성으로 대비를 무너뜨리는 유형의 세 번째 발현**이며 **R-8.30**의 근거다.
**브랜드 색의 가시성.** 라이트 테마에서 지정 Primary **#4E77FF가 정적으로 칠해지는 표면은 히어로 SVG와 6 px 불릿 2곳뿐**이다. 나머지는 전부 hover·focus 상태이거나 `-dark` **#345AD2**다.
| 표면 | 색 | 상태 |
| :--- | :--- | :--- |
| 히어로 `HeroComposition` SVG (`var(--cobalt)`) | **#4E77FF** | 정적 |
| Pillar 불릿 `page.tsx:174` `bg-cobalt` (6 px) | **#4E77FF** | 정적 |
| `members:102,132` `hover:border-cobalt` · `ProjectPageView:35,44` | #4E77FF | hover/focus 전용 |
| `ThemeToggle:146` `text-cobalt` | #4E77FF | **다크 테마 전용 렌더** |
| 섹션 괘선·키커·링크·지표·Pillar 라벨(20여 곳) | **#345AD2** | 정적 — 사용자가 "Primary"로 인지하는 색 |
즉 **지시는 토큰 수준에서 충족되었으나 화면 수준에서는 다른 색이 Primary로 읽힌다.** 접근성을 지키면서 이 간극을 좁히는 유일한 경로가 **B안(대형 표면 확대)** 이다 — `page.tsx:84,92`의 30 px 지표처럼 **3:1만 요구되는 표면**은 #4E77FF로 칠해도 적법하다(실측 3.45). 반대로 `-dark`를 브랜드 색 쪽으로 밝히는 C안은 `paper` 여유가 0.26뿐이라 **D-10이 #3C64BC를 배격한 것과 같은 사유**로 기각한다.
**시맨틱 규약의 분열.** `docs/DESIGN.md:30`과 R-8.5는 **vermillion = Agent Eng / Orchestration**을 규정한다. `2441f35`가 히어로의 `Orchestration` 강조어를 cobalt로 바꾸었으나, 같은 파일의 PILLARS 교차 배정(`page.tsx:12~48`)은 규약을 유지 중이다 — **한 페이지 안에서 규약이 둘로 갈렸다.** 코드를 되돌리든 문서를 개정하든 무방하나, **둘 중 하나는 반드시 상대에 맞춰야** AC-23이 성립한다.
---
### 12.2 리스크 ### 12.2 리스크
| ID | 리스크 | 영향 | 완화 방안 | | ID | 리스크 | 영향 | 완화 방안 |
@@ -671,6 +996,10 @@ PR-04에 명시된 4개 라벨 중 **1번과 2번의 범위가 논리적으로
| R-05 | 잔재 검사(MG-08)가 논문 제목의 도메인 용어까지 오검출 | **실데이터를 잔재로 오인해 삭제** → PR-01 위반 | MG-08 예외 규정을 검사 스크립트에 반영. 검사 범위를 정체성 서술 영역으로 한정 | | R-05 | 잔재 검사(MG-08)가 논문 제목의 도메인 용어까지 오검출 | **실데이터를 잔재로 오인해 삭제** → PR-01 위반 | MG-08 예외 규정을 검사 스크립트에 반영. 검사 범위를 정체성 서술 영역으로 한정 |
| R-06 | 문서-코드 불일치 재발 | 후속 작업자 혼선 | R-9.19. 미완 영역은 문서에 미완으로 표기 | | R-06 | 문서-코드 불일치 재발 | 후속 작업자 혼선 | R-9.19. 미완 영역은 문서에 미완으로 표기 |
| R-07 | P2(Header 수정)와 P3~P5 병렬 진행 시 충돌 | 머지 충돌 | §11.1 주석대로 P2 선행 완료 | | R-07 | P2(Header 수정)와 P3~P5 병렬 진행 시 충돌 | 머지 충돌 | §11.1 주석대로 P2 선행 완료 |
| R-10 *(v1.13 신설)* | 색값 교체가 **대비 재산정표 없이** 5회 연속 진행됨(`eaddc4f`·`ca4a7ee`·`8db16e4`·`2441f35`·`082d71e` 전부 커밋 본문 없음) | 관행화 시 무성 실패가 반복 발생 | R-8.1·R-8.27 이행 강제 + **AC-50**으로 `docs/DESIGN.md` 커스터마이즈 훅 교정. 문서가 원인으로 규명된 지 2라운드째 미교정 |
| R-11 *(v1.13 신설)* | **게이트 통과가 결함 부재의 근거로 오용될 위험** — Gate 0~10 전량 ✅인 상태에서 AA 미달 6건이 실재했다 | 잘못된 PASS 확정 | 폴트 인젝션 없는 게이트는 채택하지 않는다(**AC-46 · AC-49**). 신설 게이트는 **현행 코드 자체가 주입 상태**인 항목(F1·F2·F3·F7)으로 즉시 실효성을 확인한다 |
| R-12 *(v1.13 신설)* | `--cobalt-dark` #345AD2의 `paper` 여유가 **0.26**뿐 | 후속 변경 1회로 재미달 | 추가 상향 금지(D-10 v1.13 개정). 변경 시 R-8.27 재산정 필수 |
| R-13 *(v1.13 신설)* | Phase 3 색 통일 작업이 "에디토리얼 디자인 시스템 유지" 목표와 충돌할 소지 | 시각적 대변경 | 단일화 대상을 **동일 역할 시그니처 내부**로 한정(R-8.31). 색 선택 자체는 **D-12**로 이관 |
--- ---
@@ -714,3 +1043,9 @@ PR-04에 명시된 4개 라벨 중 **1번과 2번의 범위가 논리적으로
| 1.6 | 2026-07-30 | claude (planner) | 개발 팀장(Agy) 기술 이의제기(Job `2560771b`) 반영. **§8.6 레이아웃 컨테이너 아키텍처·브레이크포인트 토큰 신설**(R-8.17~R-8.20) — `<main>` 일괄 부여안을 기각하고 3계층 분리(전체 폭 `<main>` / 라우트 래퍼 `container-content` / full-bleed 밴드)를 채택, `w-screen` 탈출 기법 금지(R-8.18) 및 `desktop: 1240px` 스크린 토큰화(R-8.20, Tailwind 정렬 동작 실측 확인). **D-06 신설·확정**, **AC-25·AC-26 신설**, R-9.14 검수 뷰포트 6종으로 확대. AC-21 정적 HTML 4개 → 3개, R-8.15 표준 문서 55 → 44건 실측치 정정. Job `019b7331` | | 1.6 | 2026-07-30 | claude (planner) | 개발 팀장(Agy) 기술 이의제기(Job `2560771b`) 반영. **§8.6 레이아웃 컨테이너 아키텍처·브레이크포인트 토큰 신설**(R-8.17~R-8.20) — `<main>` 일괄 부여안을 기각하고 3계층 분리(전체 폭 `<main>` / 라우트 래퍼 `container-content` / full-bleed 밴드)를 채택, `w-screen` 탈출 기법 금지(R-8.18) 및 `desktop: 1240px` 스크린 토큰화(R-8.20, Tailwind 정렬 동작 실측 확인). **D-06 신설·확정**, **AC-25·AC-26 신설**, R-9.14 검수 뷰포트 6종으로 확대. AC-21 정적 HTML 4개 → 3개, R-8.15 표준 문서 55 → 44건 실측치 정정. Job `019b7331` |
| 1.7 | 2026-07-30 | claude (planner) | Home Hero → Research Project PageView 전환 계획 반영. **§6.1.2 신설**(PJ-01~PJ-14) — 레거시 실재 프로젝트 3건(IoT Standards·CCIS·VLC-IoT) 확인, `period`·`deliverables`를 `content/standards.ts` 조인으로 도출하는 무창작 설계, 활성 슬라이드 전용 캐러셀 금지(PJ-08)·URL 상태 동기화 금지(PJ-09)·캐러셀 라이브러리 금지(PJ-10)·scroll-snap 기반 JS-off 동작 보장(PJ-11) 규정. **H-02 개정**(슬로건 교체 허용 + H-03·H-04·H-05·H-06·H-07·H-10 존속 명시). **AC-27~AC-33 신설**, §7 `ResearchProject`·`ProjectDeliverable` 타입 추가, **D-07·D-08 신설**. Job `6b3840a1` | | 1.7 | 2026-07-30 | claude (planner) | Home Hero → Research Project PageView 전환 계획 반영. **§6.1.2 신설**(PJ-01~PJ-14) — 레거시 실재 프로젝트 3건(IoT Standards·CCIS·VLC-IoT) 확인, `period`·`deliverables`를 `content/standards.ts` 조인으로 도출하는 무창작 설계, 활성 슬라이드 전용 캐러셀 금지(PJ-08)·URL 상태 동기화 금지(PJ-09)·캐러셀 라이브러리 금지(PJ-10)·scroll-snap 기반 JS-off 동작 보장(PJ-11) 규정. **H-02 개정**(슬로건 교체 허용 + H-03·H-04·H-05·H-06·H-07·H-10 존속 명시). **AC-27~AC-33 신설**, §7 `ResearchProject`·`ProjectDeliverable` 타입 추가, **D-07·D-08 신설**. Job `6b3840a1` |
| 1.8 | 2026-07-30 | claude (planner) | 개발 팀장(Agy) 기술 이의제기(Job `2299a6b9`) 반영. **PJ-13 개정** — 데스크톱 3카드를 flex 스크롤 트랙에서 **`grid-cols-3` 정적 3열 + `overflow-visible`** 로 전환하고 데스크톱 퍼센트 연산을 제거. **PJ-15·PJ-16 신설**(`min-w-0`+줄바꿈으로 `shrink-0` min-content 넘침 방어 / 스크롤바 은폐 시 AC-34 동반 의무), **AC-34 신설**(데스크톱 `scrollWidth === clientWidth` 실측 판정). 이의제기의 근거 수식은 정정 — `calc(33.333%-16px)`은 초과가 아니라 **0.0125 px 미달**이며, 대안 B의 분수식은 여유가 0이어서 해당 실패 모드에 오히려 더 취약하다. Tailwind가 `calc` 연산자 공백을 자동 삽입함과 `grid-cols-3`의 `minmax(0,1fr)` 전개·미디어 쿼리 출력 순서를 실측 확인. Job `294570ab` | | 1.8 | 2026-07-30 | claude (planner) | 개발 팀장(Agy) 기술 이의제기(Job `2299a6b9`) 반영. **PJ-13 개정** — 데스크톱 3카드를 flex 스크롤 트랙에서 **`grid-cols-3` 정적 3열 + `overflow-visible`** 로 전환하고 데스크톱 퍼센트 연산을 제거. **PJ-15·PJ-16 신설**(`min-w-0`+줄바꿈으로 `shrink-0` min-content 넘침 방어 / 스크롤바 은폐 시 AC-34 동반 의무), **AC-34 신설**(데스크톱 `scrollWidth === clientWidth` 실측 판정). 이의제기의 근거 수식은 정정 — `calc(33.333%-16px)`은 초과가 아니라 **0.0125 px 미달**이며, 대안 B의 분수식은 여유가 0이어서 해당 실패 모드에 오히려 더 취약하다. Tailwind가 `calc` 연산자 공백을 자동 삽입함과 `grid-cols-3`의 `minmax(0,1fr)` 전개·미디어 쿼리 출력 순서를 실측 확인. Job `294570ab` |
| 1.9 | 2026-07-31 | claude (planner) | 스타일 관련 누적 커밋 23건(`43c75da..b7f2e05`) 검증 결과 반영. **§8.7 색 토큰 알파 계약 신설**(R-8.21~R-8.24) — 쉼표 구분 `--*-rgb`가 `rgb(a, b, c / α)` 무효 선언을 만들어 토큰 색이 적용되지 않던 근본 원인을 규명하고, 그 우회로 도입된 `<alpha-value>` 제거가 **슬래시 수식자 유틸리티 26건을 무성 소멸**시킴을 독립 프로브로 실측 확인. 인라인 `style`·`opacity-*` 토큰 우회 금지(R-8.23)와 헤더 가로 예산(R-8.24, 1240 px 기준 −69.3 px 초과 산정) 규정. **D-09 신설·확정**(`/publications` `redirect()` 기각 → 기본 카테고리 화면), **IA-03 개정**, **AC-35~AC-40 신설**. Job `9a79e302` |
| 1.10 | 2026-07-31 | claude (planner) | 개발 팀장(Agy) 기술 이의제기(Job `22b7a309`) 반영. **D-09 재확정** — v1.9의 C안(첫 카테고리 본문 재렌더)이 **동일 DOM 정적 HTML 2본**을 만든다는 지적이 타당하여 **A안(Overview 뷰)** 으로 교체하고, `All` 탭 재도입(D안)은 commit `22a31ff` 결정 역행·P-07 충돌로 기각. **R-8.25 신설**(라우트 간 콘텐츠 중복 금지 + canonical 예외 절차), **AC-41 신설**(`<main>` 정규화 해시 중복 0건), **IA-03 재개정**. 이의제기의 `isActive` 논거는 정정 — `pathname.startsWith(\`${href}/\`)` 일반 규칙이 하위 카테고리를 이미 포괄하므로 모호성이 없음을 코드로 확인. 아울러 별건으로 `CategoryNav` 활성 탭(`bg-vermillion text-ivory`)이 **라이트 테마 4.16:1로 R-9.6 미달**임을 발견해 **AC-42 신설**. Job `6a6094c6` |
| 1.11 | 2026-07-31 | claude (planner) | 강조색 교체 커밋 `eaddc4f` 검증 및 리뷰 수렴. **라이트 테마 cobalt 대비가 9.23:1 → 3.49:1(ivory) / 8.35 → 3.16(paper)로 붕괴**하여 소형 텍스트 **14개 사용처**가 AA 미달임을 WCAG 공식 재계산으로 확정. 근본 원인은 **명암 반전 계약 이탈**(라이트↔다크 상대휘도 대비 3.13 → **1.01**)이며, `run_e2e_tests.py`에 대비 검사가 **0건**이라 게이트 0~9와 빌드가 전부 통과한 채로 통과했다 — §12.1 알파 계약 사고와 동일한 무성 실패 유형의 **두 번째 발현**. **R-8.26~R-8.28 신설**(강조색 대비 바닥값 · 색값 변경 시 재측정 의무 · 명암 반전 계약 ≥2.0), **AC-43~AC-46 신설**(대비 게이트 Gate 10 · 소형 텍스트 라우팅 · 반전 계약 · 폴트 인젝션 4종). **D-10 확정** — `--cobalt`는 사용자 지정 #4A7CE8을 **유지**하고 `--cobalt-dark`만 #3462CC → **#32549E**(paper 4.48 → 5.82)로 재조정해 소형 텍스트를 `-dark`로 라우팅(A·B·D안 기각). **D-11 신설**(🟡 `text-vermillion` 소형 텍스트 30여 곳, 기본값 현행 유지). **AC-42 개정** — 직전 수렴에서 통과 판정되었으나 `standardization:40,88`·`lectures:89`·`members:177` **4곳이 4.16:1로 미교정** 잔존함을 확인하고 대상을 명시 목록화, `text-white` on vermillion 수치를 4.58 → **4.69**로 정정. §8.1 색상 토큰표를 실제 값과 동기화하고, **Secondary #D9342B는 최초 커밋 이래 무변경(no-op)** 임을 계보로 확인해 기록. Job `5c2137c6` |
| 1.12 | 2026-07-31 | claude (planner) | 개발 팀장(Agy) 기술 이의제기(Job `7f136931`) 반영. **D-10 배지·칩 결정 재확정** — v1.11의 `bg-cobalt text-ink dark:text-ivory`(5.03 / 4.82)는 채택안 C의 원칙(작은 요소는 `-dark` 라우팅)을 **소형 텍스트 12곳에만 적용하고 동일 크기 등급의 상태 칩 2곳에는 적용하지 않은 일관성 결함**이었음을 인정하고 폐기, **`bg-{accent}-dark text-ivory`** 로 교체(6.38~6.43 / 6.57~6.72). 이의제기의 권장 전경 `text-white dark:text-ivory`(7.25)는 **미채택** — `-dark` 배경에서는 `ivory`만으로 양 테마가 통과해 **팔레트 외 색 `white`와 `dark:` 변형이 모두 불필요**하다(**R-8.29 신설**). 아울러 권장안을 그대로 적용하면 `standardization:87-89` 삼항식의 나란한 두 칩 상대휘도 대비가 **1.19 → 1.54로 악화**됨을 실측해, vermillion 칩도 `-dark`로 통일하여 **1.01** 균형을 달성(**R-8.26에 배지·칩 라우팅 및 짝 칩 등급 일치 조항 추가**). 배지류를 **부류 A(`text-[0.65rem]` 상태 칩 4곳) / 부류 B(인터랙티브 내비·토글 5곳)** 로 분리해 **AC-42 개정**, `-dark`가 **배경**으로 쓰이는 조합을 **AC-43 검사 대상에 추가**(v1.11 목록은 전경만 다루어 칩 배경을 놓쳤다), **AC-47 신설**(팔레트 외 색 상한 8건 화이트리스트), **AC-46에 폴트 인젝션 ⑤·⑥ 추가**(폐기된 v1.11 칩 패턴 및 `white` 증가 검출). 부류 A vermillion 칩 2곳의 배경이 #D9342B → #A8231C로 어두워지는 **시각 변경은 GM 승인 사항으로 명시**하되 차단 사유가 아님을 기록. Job `3d3b823a` |
| 1.13 | 2026-07-31 | claude (planner) | 테마 색상 통일성 검증 계획 수립 (`eaddc4f`→`082d71e` 4개 커밋). **Gate 0~10 전량 통과·빌드 exit 0인 상태에서 WCAG AA 미달 6건·통일성 결함 9건이 실재**함을 실측으로 확정 — 게이트 통과가 곧 오탐 신호였다. 원인은 게이트 **범위 결함 3종**: ⓐ **AC-44의 vermillion 절반이 구조적으로 무효**(면제 조항 `"text-vermillion" in line`이 판정 정규식과 항상 동시 매치 — 실소스 4라인 + 주입 2건으로 재현), ⓑ AC-45가 `-dark` 2종만 검사해 **`--cobalt` 반전 대비 1.00**(D-10 근본 원인의 재발)을 미검출, ⓒ AC-43이 소스의 전경/배경 쌍을 보지 않아 `bg-cobalt-dark text-white`(다크 2.85)를 통과. **R-8.30 신설**(비텍스트 UI 3:1 · 알파는 합성 후 산정 — `focus:ring-cobalt/50` **1.80** · `hover:border-cobalt/60` **1.95** 검출), **R-8.31 신설**(역할 시그니처 단위 색 통일 — 괘선 6:1 · 키커 11:1 · 배지 전경 6:4 · hover 테두리 4종 · 포커스 2종, 지도교수 이메일 1값이 3색 3대비), **R-8.32 신설**(게이트 면제는 `(파일,행,사유)` 등재만 허용 · 라인 부분문자열 면제 금지 — **N6과 동일 유형**). **R-8.5·R-8.26·R-8.28 개정**, **AC-42·43·44·45·47 개정**, **AC-48~AC-50 신설**(Gate 11 C11-1~8 · 폴트 인젝션 F1~F9 · `docs/DESIGN.md` 동기화 4건). **§8.1 색상표를 실제 토큰값 `#4E77FF`/`#345AD2`로 동기화**하고 **D-10 확정값을 #345AD2로 개정**(paper 4.76, 여유 0.26 → R-12). **D-12 신설**(🔴 Primary 적용의 판정 기준 — 라이트 테마에서 #4E77FF가 정적으로 보이는 곳이 **2곳뿐**이며 인지색은 #345AD2. 히어로 `Orchestration`이 R-8.5·DESIGN.md §2를 위반해 cobalt로 변경되어 한 페이지 안에서 규약이 분열), **D-13 신설**(🟡 `--vermillion` 반전 1.25). **A-1 `lectures:89` 4.16 미교정 잔존**·**A-2 `not-found.tsx:22` 4.16 신규 발견**(어떤 AC에도 없던 항목)·**A-7 `::selection` 4.16 미등재** 확정. **D-11 실측 갱신**(23건, 최저 3.77). 색 교체 5회 연속 대비표 미첨부(R-10). Job `43f3f74a` |
| 1.14 | 2026-07-31 | claude (planner) | 개발 팀장(Agy) 기술 이의제기(Job `4962a667`) 반영. **구조적 통찰 채택** — 다크 `--cobalt`만 단독 상향하면 다크 지면 대비가 DEFAULT 9.2 > `-dark` 5.96으로 **계층이 역전**됨을 실측 확인, v1.13 §7 각주의 누락을 인정하고 **R-8.33 신설**(토큰 등급 불변식). 다만 불변식을 **절대 휘도 순서가 아니라 테마 상대 대비**로 정식화 — 절대 순서의 테마 간 뒤집힘은 vermillion 쌍에서도 동일한 **정상 동작**이며 현행 8개 셀 전부에서 성립하므로, 절대 휘도로 판정하면 정상 상태를 오판한다. **제안 수치 미채택** — 주 권장값 `#85ACFF`의 반전 대비는 **1.73**으로 조정을 촉발한 R-8.28(≥2.0) 자체를 충족하지 못하며, 제안 표의 `#345AD2` L=0.095는 **폐기된 #32549E의 값**(실제 0.1270)이라 `#B0CDFF` 반전 대비 2.50도 실제 **3.68**이다. **이의제기 지점에서 더 큰 결함 발굴** — 다크 `--cobalt`(#4D77FF)는 `bg-paper` 위 **4.37**이므로 v1.12가 지시한 `text-cobalt-dark dark:text-cobalt` 라우팅이 **다크 절반을 DEFAULT로 되돌려 8곳이 AA 미달**이다(**AC-51 신설**). 원인은 R-8.26의 "`paper` 기준 산정" 원칙을 **본 계획자가 라이트 테마에만 적용한 오류**로, v1.11 §6.5와 같은 형태의 누락이다. 게이트도 AC-44 정규식의 **부정 후방탐색 `(?<!dark:)`로 다크 절반을 설계상 면제**하고 있었다(**G-7** — G-1·G-2·G-3에 이은 네 번째 "검사를 절반만 한다" 유형). **처방을 토큰 조정에서 `dark:` 변형 제거로 재설계** — `-dark`는 반전 토큰이므로 `dark:` 없이 4개 셀 전부(5.26/4.76/6.57/5.96)를 통과한다. **R-8.29 강화**(강조색 `dark:` 금지 · 정본 패턴 3종 · 현행 위반 **38건**), **R-8.26·AC-43·AC-44·AC-48(C11-9)·AC-49(F10·F11, 총 11건) 개정**. **D-14 신설**(🔴 `--cobalt` 반전 1.00 — A안 브랜드 고정 예외 권고 / B안 대칭 상향 정정 수치 `#A8BCFF`+`#C7D4FF`). A안은 본 계획자가 작성한 R-8.28의 완화를 포함하므로 **cline·GM 별도 심사 대상**으로 명시했고, 안전망 유지 근거로 `#1B3A8A` 역주입 시 AC-43 즉시 실패(1.80)를 제시했다. Job `d35bc3e7` |
@@ -4,8 +4,8 @@ export function DirectionsBlock() {
return ( return (
<section className="mt-20 pt-16 border-t border-line" id="directions"> <section className="mt-20 pt-16 border-t border-line" id="directions">
<div className="flex items-center gap-3 mb-6"> <div className="flex items-center gap-3 mb-6">
<span className="h-px w-8 bg-vermillion"></span> <span className="h-px w-8 bg-cobalt-dark"></span>
<span className="font-mono text-xs tracking-widest uppercase text-vermillion font-bold"> <span className="font-mono text-xs tracking-widest uppercase text-cobalt-dark font-bold">
Location & Contact Location & Contact
</span> </span>
</div> </div>
@@ -48,7 +48,7 @@ export function DirectionsBlock() {
<span className="font-mono text-xs uppercase tracking-wider text-ink-mute w-20 pt-0.5"> <span className="font-mono text-xs uppercase tracking-wider text-ink-mute w-20 pt-0.5">
관련 기관 관련 기관
</span> </span>
<div className="flex flex-wrap gap-x-4 gap-y-1 text-xs font-mono text-cobalt"> <div className="flex flex-wrap gap-x-4 gap-y-1 text-xs font-mono text-cobalt-dark">
<a href="http://www.knu.ac.kr/" target="_blank" rel="noreferrer" className="hover:underline"> <a href="http://www.knu.ac.kr/" target="_blank" rel="noreferrer" className="hover:underline">
경북대학교 (KNU) ↗ 경북대학교 (KNU) ↗
</a> </a>
@@ -11,8 +11,8 @@ export function ProjectPageView() {
<div className="flex flex-col sm:flex-row sm:items-end justify-between gap-4 border-b border-line pb-4"> <div className="flex flex-col sm:flex-row sm:items-end justify-between gap-4 border-b border-line pb-4">
<div> <div>
<div className="flex items-center gap-3 mb-1"> <div className="flex items-center gap-3 mb-1">
<span className="h-px w-8 bg-vermillion"></span> <span className="h-px w-8 bg-cobalt-dark"></span>
<span className="font-mono text-xs tracking-widest uppercase text-vermillion font-bold"> <span className="font-mono text-xs tracking-widest uppercase text-cobalt-dark font-bold">
Key Initiatives Key Initiatives
</span> </span>
</div> </div>
@@ -32,7 +32,7 @@ export function ProjectPageView() {
role="group" role="group"
aria-roledescription="carousel" aria-roledescription="carousel"
aria-label="연구 프로젝트 목록" aria-label="연구 프로젝트 목록"
className="flex gap-6 overflow-x-auto snap-x snap-mandatory scroll-smooth [scrollbar-width:none] [&::-webkit-scrollbar]:hidden desktop:grid desktop:grid-cols-3 desktop:overflow-visible focus:outline-none focus:ring-1 focus:ring-vermillion/50 rounded" className="flex gap-6 overflow-x-auto snap-x snap-mandatory scroll-smooth [scrollbar-width:none] [&::-webkit-scrollbar]:hidden desktop:grid desktop:grid-cols-3 desktop:overflow-visible focus:outline-none focus:ring-1 focus:ring-cobalt/50 rounded"
> >
{researchProjects.map((proj, idx) => ( {researchProjects.map((proj, idx) => (
<article <article
@@ -41,7 +41,7 @@ export function ProjectPageView() {
role="group" role="group"
aria-roledescription="slide" aria-roledescription="slide"
aria-label={`${researchProjects.length}개 중 ${idx + 1}번째 프로젝트`} aria-label={`${researchProjects.length}개 중 ${idx + 1}번째 프로젝트`}
className="snap-start shrink-0 min-w-0 w-full md:w-[calc(50%-12px)] desktop:w-full flex flex-col justify-between bg-paper p-6 rounded-lg border border-line hover:border-vermillion/60 transition-colors space-y-5 break-words [word-break:keep-all]" className="snap-start shrink-0 min-w-0 w-full md:w-[calc(50%-12px)] desktop:w-full flex flex-col justify-between bg-paper p-6 rounded-lg border border-line hover:border-cobalt/60 transition-colors space-y-5 break-words [word-break:keep-all]"
> >
<div className="space-y-4"> <div className="space-y-4">
{/* Header Info */} {/* Header Info */}
@@ -50,7 +50,7 @@ export function ProjectPageView() {
{proj.title} {proj.title}
</h3> </h3>
{proj.period && ( {proj.period && (
<span className="font-mono text-xs text-vermillion bg-ivory border border-line px-2 py-0.5 rounded shrink-0"> <span className="font-mono text-xs text-cobalt-dark bg-ivory border border-line px-2 py-0.5 rounded shrink-0">
{proj.period} {proj.period}
</span> </span>
)} )}
@@ -85,12 +85,12 @@ export function ProjectPageView() {
) : proj.standardsTrack ? ( ) : proj.standardsTrack ? (
<div className="flex items-baseline justify-between gap-2"> <div className="flex items-baseline justify-between gap-2">
<span className="text-ink-mute">Standards Track:</span> <span className="text-ink-mute">Standards Track:</span>
<span className="text-cobalt font-bold">{proj.standardsTrack}</span> <span className="text-cobalt-dark font-bold">{proj.standardsTrack}</span>
</div> </div>
) : proj.standardsOrg ? ( ) : proj.standardsOrg ? (
<div className="flex items-baseline justify-between gap-2"> <div className="flex items-baseline justify-between gap-2">
<span className="text-ink-mute">Organization:</span> <span className="text-ink-mute">Organization:</span>
<span className="text-cobalt font-bold">{proj.standardsOrg}</span> <span className="text-cobalt-dark font-bold">{proj.standardsOrg}</span>
</div> </div>
) : null} ) : null}
+20 -20
View File
@@ -39,16 +39,16 @@
--font-sans: 'Geist', 'Pretendard', 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Apple SD Gothic Neo', 'Malgun Gothic', sans-serif; --font-sans: 'Geist', 'Pretendard', 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Apple SD Gothic Neo', 'Malgun Gothic', sans-serif;
--font-mono: 'Geist Mono', ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace; --font-mono: 'Geist Mono', ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace;
--ink-rgb: 10, 10, 10; --ink-rgb: 10 10 10;
--ink-soft-rgb: 38, 36, 32; --ink-soft-rgb: 38 36 32;
--ink-mute-rgb: 107, 101, 91; --ink-mute-rgb: 107 101 91;
--ivory-rgb: 245, 241, 232; --ivory-rgb: 245 241 232;
--paper-rgb: 236, 230, 214; --paper-rgb: 236 230 214;
--line-rgb: 216, 209, 192; --line-rgb: 216 209 192;
--vermillion-rgb: 217, 52, 43; --vermillion-rgb: 217 52 43;
--vermillion-dark-rgb: 168, 35, 28; --vermillion-dark-rgb: 168 35 28;
--cobalt-rgb: 27, 58, 138; --cobalt-rgb: 78 119 255;
--cobalt-dark-rgb: 18, 40, 99; --cobalt-dark-rgb: 52 90 210;
--ink: rgb(var(--ink-rgb)); --ink: rgb(var(--ink-rgb));
--ink-soft: rgb(var(--ink-soft-rgb)); --ink-soft: rgb(var(--ink-soft-rgb));
@@ -72,16 +72,16 @@ html.dark,
html[data-theme="dark"] { html[data-theme="dark"] {
color-scheme: dark; color-scheme: dark;
--ink-rgb: 245, 241, 232; --ink-rgb: 245 241 232;
--ink-soft-rgb: 216, 209, 192; --ink-soft-rgb: 216 209 192;
--ink-mute-rgb: 160, 153, 142; --ink-mute-rgb: 160 153 142;
--ivory-rgb: 18, 18, 18; --ivory-rgb: 18 18 18;
--paper-rgb: 30, 28, 26; --paper-rgb: 30 28 26;
--line-rgb: 51, 48, 43; --line-rgb: 51 48 43;
--vermillion-rgb: 235, 75, 66; --vermillion-rgb: 235 75 66;
--vermillion-dark-rgb: 255, 107, 97; --vermillion-dark-rgb: 255 107 97;
--cobalt-rgb: 77, 119, 255; --cobalt-rgb: 77 119 255;
--cobalt-dark-rgb: 112, 148, 255; --cobalt-dark-rgb: 112 148 255;
--grain-color: rgba(245, 241, 232, 0.03); --grain-color: rgba(245, 241, 232, 0.03);
} }
+5 -5
View File
@@ -10,8 +10,8 @@ export default function LecturesPage() {
{/* Header */} {/* Header */}
<section className="space-y-3"> <section className="space-y-3">
<div className="flex items-center gap-3"> <div className="flex items-center gap-3">
<span className="h-px w-8 bg-vermillion"></span> <span className="h-px w-8 bg-cobalt-dark"></span>
<span className="font-mono text-xs tracking-widest uppercase text-vermillion font-bold"> <span className="font-mono text-xs tracking-widest uppercase text-cobalt-dark font-bold">
Academic Courses Academic Courses
</span> </span>
</div> </div>
@@ -27,7 +27,7 @@ export default function LecturesPage() {
<section className="space-y-6 pt-6 md:pt-10 border-t border-line"> <section className="space-y-6 pt-6 md:pt-10 border-t border-line">
<div className="flex justify-between items-end"> <div className="flex justify-between items-end">
<div> <div>
<div className="font-mono text-xs text-vermillion uppercase tracking-widest font-bold"> <div className="font-mono text-xs text-cobalt-dark uppercase tracking-widest font-bold">
Recent Courses ({recentSemesters.length} Semesters) Recent Courses ({recentSemesters.length} Semesters)
</div> </div>
<h2 className="font-serif text-3xl font-normal text-ink mt-1"> <h2 className="font-serif text-3xl font-normal text-ink mt-1">
@@ -47,7 +47,7 @@ export default function LecturesPage() {
<span className="font-serif text-xl font-normal text-ink"> <span className="font-serif text-xl font-normal text-ink">
{sem.term} {sem.year} {sem.term} {sem.year}
</span> </span>
<span className="font-mono text-xs text-vermillion font-bold"> <span className="font-mono text-xs text-vermillion-dark font-bold">
Latest Latest
</span> </span>
</div> </div>
@@ -86,7 +86,7 @@ export default function LecturesPage() {
2016 Fall ~ 2024 Spring 학기별 개설 교과목 이력 2016 Fall ~ 2024 Spring 학기별 개설 교과목 이력
</p> </p>
</div> </div>
<span className="font-mono text-xs text-vermillion font-bold border border-vermillion px-3 py-1.5 rounded group-open:bg-vermillion group-open:text-ivory transition-colors"> <span className="font-mono text-xs text-vermillion-dark font-bold border border-vermillion-dark px-3 py-1.5 rounded group-open:bg-vermillion-dark group-open:text-white dark:group-open:text-ivory transition-colors">
<span className="group-open:hidden">전체 보기 ▾</span> <span className="group-open:hidden">전체 보기 ▾</span>
<span className="hidden group-open:inline">접기 ▴</span> <span className="hidden group-open:inline">접기 ▴</span>
</span> </span>
+13 -13
View File
@@ -15,9 +15,9 @@ export default function MembersPage() {
{/* Header */} {/* Header */}
<section className="space-y-3"> <section className="space-y-3">
<div className="flex items-center gap-3"> <div className="flex items-center gap-3">
<span className="h-px w-8 bg-vermillion"></span> <span className="h-px w-8 bg-cobalt-dark"></span>
<span className="font-mono text-xs tracking-widest uppercase text-vermillion font-bold"> <span className="font-mono text-xs tracking-widest uppercase text-cobalt-dark font-bold">
People & Researchers People &amp; Researchers
</span> </span>
</div> </div>
<h1 className="font-serif text-4xl sm:text-5xl font-normal text-ink"> <h1 className="font-serif text-4xl sm:text-5xl font-normal text-ink">
@@ -30,7 +30,7 @@ export default function MembersPage() {
{/* Professor Section */} {/* Professor Section */}
<section className="space-y-6 pt-6 md:pt-10 border-t border-line"> <section className="space-y-6 pt-6 md:pt-10 border-t border-line">
<div className="font-mono text-xs text-vermillion uppercase tracking-widest font-bold"> <div className="font-mono text-xs text-cobalt-dark uppercase tracking-widest font-bold">
Faculty Faculty
</div> </div>
@@ -51,7 +51,7 @@ export default function MembersPage() {
<div className="pt-4 border-t border-line/60 flex flex-wrap gap-4 text-xs font-mono"> <div className="pt-4 border-t border-line/60 flex flex-wrap gap-4 text-xs font-mono">
<a <a
href="mailto:sjkoh@knu.ac.kr" href="mailto:sjkoh@knu.ac.kr"
className="text-vermillion hover:underline" className="text-cobalt-dark hover:underline"
> >
sjkoh@knu.ac.kr sjkoh@knu.ac.kr
</a> </a>
@@ -60,7 +60,7 @@ export default function MembersPage() {
href="https://github.com/sjkoh12" href="https://github.com/sjkoh12"
target="_blank" target="_blank"
rel="noreferrer" rel="noreferrer"
className="text-cobalt hover:underline" className="text-cobalt-dark hover:underline"
> >
GitHub @sjkoh12 ↗ GitHub @sjkoh12 ↗
</a> </a>
@@ -81,7 +81,7 @@ export default function MembersPage() {
<section className="space-y-8 pt-6 md:pt-10 border-t border-line"> <section className="space-y-8 pt-6 md:pt-10 border-t border-line">
<div className="flex justify-between items-end"> <div className="flex justify-between items-end">
<div> <div>
<div className="font-mono text-xs text-cobalt uppercase tracking-widest font-bold"> <div className="font-mono text-xs text-cobalt-dark uppercase tracking-widest font-bold">
Active Researchers ({activeMembers.length} Members) Active Researchers ({activeMembers.length} Members)
</div> </div>
<h2 className="font-serif text-3xl font-normal text-ink mt-1"> <h2 className="font-serif text-3xl font-normal text-ink mt-1">
@@ -105,13 +105,13 @@ export default function MembersPage() {
<span className="font-serif text-lg font-normal text-ink"> <span className="font-serif text-lg font-normal text-ink">
{mem.ko} {mem.ko}
</span> </span>
<span className="font-mono text-xs text-cobalt"> <span className="font-mono text-xs text-cobalt-dark">
{mem.degree} {mem.degree}
</span> </span>
</div> </div>
<div className="font-mono text-xs text-ink-mute">{mem.en}</div> <div className="font-mono text-xs text-ink-mute">{mem.en}</div>
{mem.affiliation && ( {mem.affiliation && (
<div className="text-xs text-vermillion pt-1 border-t border-line/40"> <div className="text-xs text-vermillion-dark pt-1 border-t border-line/40">
with {mem.affiliation} with {mem.affiliation}
</div> </div>
)} )}
@@ -135,13 +135,13 @@ export default function MembersPage() {
<span className="font-serif text-lg font-normal text-ink"> <span className="font-serif text-lg font-normal text-ink">
{mem.ko} {mem.ko}
</span> </span>
<span className="font-mono text-xs text-cobalt"> <span className="font-mono text-xs text-cobalt-dark">
{mem.degree} {mem.degree}
</span> </span>
</div> </div>
<div className="font-mono text-xs text-ink-mute">{mem.en}</div> <div className="font-mono text-xs text-ink-mute">{mem.en}</div>
{mem.affiliation && ( {mem.affiliation && (
<div className="text-xs text-vermillion pt-1 border-t border-line/40"> <div className="text-xs text-vermillion-dark pt-1 border-t border-line/40">
with {mem.affiliation} with {mem.affiliation}
</div> </div>
)} )}
@@ -174,7 +174,7 @@ export default function MembersPage() {
2007년부터 2026년까지 수여된 박사(Ph.D.) 및 석사(M.S.) 졸업생 이력 2007년부터 2026년까지 수여된 박사(Ph.D.) 및 석사(M.S.) 졸업생 이력
</p> </p>
</div> </div>
<span className="font-mono text-xs text-vermillion font-bold border border-vermillion px-3 py-1.5 rounded group-open:bg-vermillion group-open:text-ivory transition-colors"> <span className="font-mono text-xs text-vermillion-dark font-bold border border-vermillion-dark px-3 py-1.5 rounded group-open:bg-vermillion-dark group-open:text-white dark:group-open:text-ivory transition-colors">
<span className="group-open:hidden">전체 보기 ▾</span> <span className="group-open:hidden">전체 보기 ▾</span>
<span className="hidden group-open:inline">접기 ▴</span> <span className="hidden group-open:inline">접기 ▴</span>
</span> </span>
@@ -199,7 +199,7 @@ export default function MembersPage() {
{alum.major && <span>{alum.major}</span>} {alum.major && <span>{alum.major}</span>}
</div> </div>
{alum.currentPosition && ( {alum.currentPosition && (
<div className="text-xs text-cobalt pt-1 border-t border-line/40"> <div className="text-xs text-cobalt-dark pt-1 border-t border-line/40">
{alum.currentPosition} {alum.currentPosition}
</div> </div>
)} )}
+2 -2
View File
@@ -5,7 +5,7 @@ export default function NotFound() {
return ( return (
<div className="container-content py-20 sm:py-32 flex flex-col items-center justify-center text-center min-h-[60vh]"> <div className="container-content py-20 sm:py-32 flex flex-col items-center justify-center text-center min-h-[60vh]">
<div className="border border-line bg-paper p-8 sm:p-12 rounded-lg max-w-xl w-full space-y-6 shadow-sm"> <div className="border border-line bg-paper p-8 sm:p-12 rounded-lg max-w-xl w-full space-y-6 shadow-sm">
<div className="inline-block px-3 py-1 bg-vermillion/10 text-vermillion font-mono text-xs font-bold rounded tracking-widest uppercase"> <div className="inline-block px-3 py-1 bg-vermillion/10 text-vermillion-dark font-mono text-xs font-bold rounded tracking-widest uppercase">
404 Error 404 Error
</div> </div>
<h1 className="font-serif text-3xl sm:text-4xl font-normal text-ink leading-tight"> <h1 className="font-serif text-3xl sm:text-4xl font-normal text-ink leading-tight">
@@ -19,7 +19,7 @@ export default function NotFound() {
<div className="pt-4"> <div className="pt-4">
<Link <Link
href="/" href="/"
className="inline-flex items-center justify-center px-6 py-3 border border-ink bg-ink text-ivory hover:bg-vermillion hover:border-vermillion transition-colors duration-200 text-sm font-medium rounded-md" className="inline-flex items-center justify-center px-6 py-3 border border-ink bg-ink text-ivory hover:bg-vermillion-dark hover:border-vermillion-dark transition-colors duration-200 text-sm font-medium rounded-md"
> >
메인 페이지로 돌아가기 메인 페이지로 돌아가기
</Link> </Link>
+8 -8
View File
@@ -63,7 +63,7 @@ export default function HomePage() {
{/* Hero Section */} {/* Hero Section */}
<section className="relative"> <section className="relative">
<div className="mb-4"> <div className="mb-4">
<span className="font-mono text-xs tracking-widest uppercase text-vermillion font-bold"> <span className="font-mono text-xs tracking-widest uppercase text-cobalt-dark font-bold">
Kyungpook National University · AI Agent Networking Lab (ANL) Kyungpook National University · AI Agent Networking Lab (ANL)
</span> </span>
</div> </div>
@@ -72,7 +72,7 @@ export default function HomePage() {
<div className="lg:col-span-7 space-y-6 lg:pt-4"> <div className="lg:col-span-7 space-y-6 lg:pt-4">
<h1 className="font-serif text-4xl sm:text-5xl lg:text-6xl font-normal text-ink leading-tight"> <h1 className="font-serif text-4xl sm:text-5xl lg:text-6xl font-normal text-ink leading-tight">
Multi-Agent <br /> Multi-Agent <br />
<span className="italic font-serif text-vermillion">Orchestration</span> <span className="italic font-serif text-cobalt-dark">Orchestration</span>
</h1> </h1>
<p className="text-ink-mute text-base sm:text-lg leading-relaxed max-w-2xl"> <p className="text-ink-mute text-base sm:text-lg leading-relaxed max-w-2xl">
AI 에이전트 네트워크 연구실(ANL)은 멀티 AI 에이전트 오케스트레이션을 위해 서로 소통하고 협력하는 에이전트 네트워킹 기술과 표준 프레임워크 기술을 연구합니다. AI 에이전트 네트워크 연구실(ANL)은 멀티 AI 에이전트 오케스트레이션을 위해 서로 소통하고 협력하는 에이전트 네트워킹 기술과 표준 프레임워크 기술을 연구합니다.
@@ -81,7 +81,7 @@ export default function HomePage() {
{/* Metrics Row (Derived from data array, AC-13) */} {/* Metrics Row (Derived from data array, AC-13) */}
<div className="pt-6 border-t border-line grid grid-cols-3 gap-4"> <div className="pt-6 border-t border-line grid grid-cols-3 gap-4">
<div> <div>
<div className="font-serif text-3xl text-vermillion font-normal"> <div className="font-serif text-3xl text-cobalt-dark font-normal">
{PILLARS.length} {PILLARS.length}
</div> </div>
<div className="font-mono text-xs text-ink-mute uppercase tracking-wider mt-1"> <div className="font-mono text-xs text-ink-mute uppercase tracking-wider mt-1">
@@ -89,8 +89,8 @@ export default function HomePage() {
</div> </div>
</div> </div>
<div> <div>
<div className="font-serif text-3xl text-cobalt font-normal"> <div className="font-serif text-3xl text-cobalt-dark font-normal">
220+ {Math.floor((publications.length + patents.length) / 10) * 10}+
</div> </div>
<div className="font-mono text-xs text-ink-mute uppercase tracking-wider mt-1"> <div className="font-mono text-xs text-ink-mute uppercase tracking-wider mt-1">
Publications Publications
@@ -120,7 +120,7 @@ export default function HomePage() {
<section className="space-y-8 pt-20 md:pt-28 border-t border-line"> <section className="space-y-8 pt-20 md:pt-28 border-t border-line">
<div className="flex justify-between items-end"> <div className="flex justify-between items-end">
<div> <div>
<div className="font-mono text-xs text-vermillion uppercase tracking-widest font-bold"> <div className="font-mono text-xs text-cobalt-dark uppercase tracking-widest font-bold">
Research Areas Research Areas
</div> </div>
<h2 className="font-serif text-3xl font-normal text-ink mt-1"> <h2 className="font-serif text-3xl font-normal text-ink mt-1">
@@ -145,7 +145,7 @@ export default function HomePage() {
<div className="flex justify-between items-center"> <div className="flex justify-between items-center">
<span <span
className={`font-mono text-sm font-bold ${ className={`font-mono text-sm font-bold ${
isVermillion ? "text-vermillion" : "text-cobalt" isVermillion ? "text-vermillion" : "text-cobalt-dark"
}`} }`}
> >
[{pillar.no}] [{pillar.no}]
@@ -184,7 +184,7 @@ export default function HomePage() {
<span>ANL Core Spec</span> <span>ANL Core Spec</span>
<span <span
className={ className={
isVermillion ? "text-vermillion" : "text-cobalt" isVermillion ? "text-vermillion" : "text-cobalt-dark"
} }
> >
Pillar #{pillar.no} Pillar #{pillar.no}
@@ -59,8 +59,8 @@ export default function PublicationCategoryPage({ params }: PageProps) {
{/* Header */} {/* Header */}
<section className="space-y-3"> <section className="space-y-3">
<div className="flex items-center gap-3"> <div className="flex items-center gap-3">
<span className="h-px w-8 bg-vermillion"></span> <span className="h-px w-8 bg-cobalt-dark"></span>
<span className="font-mono text-xs tracking-widest uppercase text-vermillion font-bold"> <span className="font-mono text-xs tracking-widest uppercase text-cobalt-dark font-bold">
Publications Category Publications Category
</span> </span>
</div> </div>
@@ -81,7 +81,7 @@ export default function PublicationCategoryPage({ params }: PageProps) {
<span className="font-mono text-xs text-ink-mute uppercase"> <span className="font-mono text-xs text-ink-mute uppercase">
Showing {records.length} Pre-rendered Records Showing {records.length} Pre-rendered Records
</span> </span>
<span className="font-mono text-xs text-vermillion font-bold"> <span className="font-mono text-xs text-vermillion-dark font-bold">
SSG ● Static HTML SSG ● Static HTML
</span> </span>
</div> </div>
@@ -108,7 +108,7 @@ export default function PublicationCategoryPage({ params }: PageProps) {
</h3> </h3>
<time <time
dateTime={rec.publishedAt} dateTime={rec.publishedAt}
className="font-mono text-xs text-vermillion bg-ivory border border-line px-2.5 py-1 rounded shrink-0 font-bold" className="font-mono text-xs text-vermillion-dark bg-ivory border border-line px-2.5 py-1 rounded shrink-0 font-bold"
> >
{rec.publishedAt} {rec.publishedAt}
</time> </time>
@@ -121,7 +121,7 @@ export default function PublicationCategoryPage({ params }: PageProps) {
출원번호: {rec.appNo} ({rec.country}, {rec.appDate}) 출원번호: {rec.appNo} ({rec.country}, {rec.appDate})
</p> </p>
{rec.regNo && ( {rec.regNo && (
<p className="text-cobalt font-bold"> <p className="text-cobalt-dark font-bold">
등록번호: {rec.regNo} ({rec.regDate}) 등록번호: {rec.regNo} ({rec.regDate})
</p> </p>
)} )}
@@ -132,7 +132,7 @@ export default function PublicationCategoryPage({ params }: PageProps) {
<div className="flex items-center gap-3"> <div className="flex items-center gap-3">
<span>{rec.volume}</span> <span>{rec.volume}</span>
{rec.kci && ( {rec.kci && (
<span className="bg-cobalt text-ivory text-[0.65rem] px-1.5 py-0.5 rounded font-bold"> <span className="bg-cobalt-dark text-ivory text-[0.65rem] px-1.5 py-0.5 rounded font-bold">
KCI 등재 KCI 등재
</span> </span>
)} )}
@@ -5,7 +5,6 @@ import { PubCategory } from "../../../content/types";
interface CategoryNavProps { interface CategoryNavProps {
currentCategory?: PubCategory; currentCategory?: PubCategory;
totalCount?: number;
} }
export function CategoryNav({ currentCategory }: CategoryNavProps) { export function CategoryNav({ currentCategory }: CategoryNavProps) {
@@ -20,8 +19,8 @@ export function CategoryNav({ currentCategory }: CategoryNavProps) {
href={`/publications/${cat.slug}`} href={`/publications/${cat.slug}`}
className={`px-4 py-2 rounded text-xs font-mono tracking-wider transition-colors ${ className={`px-4 py-2 rounded text-xs font-mono tracking-wider transition-colors ${
isActive isActive
? "bg-vermillion text-ivory font-bold" ? "bg-cobalt-dark text-white dark:text-ivory font-bold"
: "bg-paper text-ink border border-line hover:border-vermillion" : "bg-paper text-ink border border-line hover:border-cobalt-dark"
}`} }`}
> >
{cat.label} {cat.label}
+125 -2
View File
@@ -1,5 +1,128 @@
import { redirect } from "next/navigation"; import Link from "next/link";
import { CategoryNav } from "./_components/CategoryNav";
import { PUB_CATEGORIES } from "../../content/categories";
import { publications, patents } from "../../content/publications";
export const metadata = {
title: "Publications Overview | ANL",
description: "AI 에이전트 네트워크 연구실(ANL) 연구 실적 개요 및 카테고리별 집계",
};
export default function PublicationsIndexPage() { export default function PublicationsIndexPage() {
redirect("/publications/intl-journal-conf"); const totalPubCount = publications.length + patents.length;
// Sort publication records by publishedAt descending to select top 10 highlights
const top10Highlights = [...publications]
.sort((a, b) => (b.publishedAt || "").localeCompare(a.publishedAt || ""))
.slice(0, 10);
const getCount = (slug: string) => {
if (slug === "patent") return patents.length;
return publications.filter((p) => p.category === slug).length;
};
return (
<main className="container-content space-y-8 md:space-y-12 pt-10 md:pt-16 pb-16 md:pb-24">
{/* Header section */}
<section className="space-y-4">
<div className="flex items-center gap-3">
<span className="h-px w-8 bg-cobalt-dark" />
<span className="font-mono text-xs font-bold uppercase tracking-widest text-cobalt-dark">
BIBLIOGRAPHY &amp; INTELLECTUAL PROPERTY
</span>
</div>
<h1 className="headline-ko text-3xl sm:text-4xl text-ink font-bold">
연구 실적 개요
</h1>
<p className="text-sm sm:text-base text-ink-mute max-w-3xl leading-relaxed">
AI 에이전트 네트워크 연구실(ANL)의 학술 논문({publications.length}건)과 특허({patents.length}건)를 포함한 총 {totalPubCount}건의 연구 성과 집계 및 대표 실적 목록입니다.
</p>
</section>
{/* Category Navigation */}
<CategoryNav />
{/* Category Summary Cards */}
<section className="grid gap-6 md:grid-cols-3">
{PUB_CATEGORIES.map((cat) => {
const count = getCount(cat.slug);
return (
<div
key={cat.slug}
className="flex flex-col justify-between border border-line bg-paper p-6 rounded-lg transition-colors hover:border-cobalt-dark group"
>
<div className="space-y-3">
<span className="font-mono text-xs text-ink-mute uppercase tracking-wider">
Category
</span>
<h2 className="headline-ko text-xl text-ink font-bold group-hover:text-cobalt-dark transition-colors">
{cat.label}
</h2>
<p className="text-xs text-ink-mute leading-relaxed">
{cat.desc}
</p>
</div>
<div className="mt-6 pt-4 border-t border-line flex items-baseline justify-between">
<span className="font-display text-3xl font-bold text-ink">
{count}
<span className="text-xs font-sans text-ink-mute ml-1 font-normal">건</span>
</span>
<Link
href={`/publications/${cat.slug}`}
className="inline-flex items-center text-xs font-bold text-vermillion-dark hover:underline"
>
전체 보기 &rarr;
</Link>
</div>
</div>
);
})}
</section>
{/* Top 10 Highlights Section */}
<section className="space-y-6 pt-6 border-t border-line">
<div className="flex items-center justify-between">
<h2 className="headline-ko text-2xl font-bold text-ink">
최신 대표 실적 (Top 10 Highlights)
</h2>
<span className="font-mono text-xs text-ink-mute">
RECENT HIGHLIGHTS
</span>
</div>
<div className="divide-y divide-line border border-line bg-ivory rounded-lg overflow-hidden">
{top10Highlights.map((pub, idx) => (
<article key={`${pub.category}-${idx}`} className="p-5 hover:bg-paper/50 transition-colors space-y-2">
<div className="flex flex-wrap items-center gap-2 text-xs font-mono text-ink-mute">
<span className="px-2 py-0.5 rounded bg-paper border border-line text-ink font-bold">
{pub.publishedAt?.substring(0, 7) || "Recent"}
</span>
<span>·</span>
<span className="capitalize">{pub.category.replace(/-/g, " ")}</span>
{pub.doi && (
<>
<span>·</span>
<span className="text-vermillion">DOI: {pub.doi}</span>
</>
)}
</div>
<h3 className="font-semibold text-base text-ink leading-snug">
{pub.title}
</h3>
{pub.authors && (
<p className="text-xs text-ink-mute">
{pub.authors}
</p>
)}
{pub.venue && (
<p className="text-xs italic text-ink-soft">
{pub.venue}
</p>
)}
</article>
))}
</div>
</section>
</main>
);
} }
@@ -13,8 +13,8 @@ export default function StandardizationPage() {
{/* Header */} {/* Header */}
<section className="space-y-3"> <section className="space-y-3">
<div className="flex items-center gap-3"> <div className="flex items-center gap-3">
<span className="h-px w-8 bg-vermillion"></span> <span className="h-px w-8 bg-cobalt-dark"></span>
<span className="font-mono text-xs tracking-widest uppercase text-vermillion font-bold"> <span className="font-mono text-xs tracking-widest uppercase text-cobalt-dark font-bold">
Open Standards &amp; Contributions Open Standards &amp; Contributions
</span> </span>
</div> </div>
@@ -33,11 +33,11 @@ export default function StandardizationPage() {
<div className="flex flex-wrap justify-between items-start gap-4 border-b border-line pb-4"> <div className="flex flex-wrap justify-between items-start gap-4 border-b border-line pb-4">
<div> <div>
<div className="flex items-center gap-2"> <div className="flex items-center gap-2">
<span className="font-mono text-xs text-vermillion font-bold uppercase"> <span className="font-mono text-xs text-cobalt-dark font-bold uppercase">
[{body.scope}] [{body.scope}]
</span> </span>
{body.role && ( {body.role && (
<span className="bg-vermillion text-ivory font-mono text-[0.65rem] px-2 py-0.5 rounded font-bold"> <span className="bg-vermillion-dark text-ivory font-mono text-[0.65rem] px-2 py-0.5 rounded font-bold">
{body.role} {body.role}
</span> </span>
)} )}
@@ -61,7 +61,7 @@ export default function StandardizationPage() {
<div key={pIdx} className="bg-ivory p-6 rounded border border-line space-y-3"> <div key={pIdx} className="bg-ivory p-6 rounded border border-line space-y-3">
<div className="font-serif text-lg font-normal text-ink border-b border-line/60 pb-2 flex justify-between items-center"> <div className="font-serif text-lg font-normal text-ink border-b border-line/60 pb-2 flex justify-between items-center">
<div> <div>
<span className="font-mono text-xs text-cobalt font-bold mr-2"> <span className="font-mono text-xs text-cobalt-dark font-bold mr-2">
{proj.wg} {proj.wg}
</span> </span>
<span>{proj.name}</span> <span>{proj.name}</span>
@@ -85,8 +85,8 @@ export default function StandardizationPage() {
<span <span
className={`font-mono text-[0.65rem] px-2 py-0.5 rounded font-bold shrink-0 ${ className={`font-mono text-[0.65rem] px-2 py-0.5 rounded font-bold shrink-0 ${
doc.status === "InProgress" doc.status === "InProgress"
? "bg-vermillion text-ivory" ? "bg-vermillion-dark text-ivory"
: "bg-cobalt text-ivory" : "bg-cobalt-dark text-ivory"
}`} }`}
> >
{doc.status} {doc.status}
+5 -6
View File
@@ -16,11 +16,10 @@ export default function Footer() {
{/* Marquee band — colophon ticker */} {/* Marquee band — colophon ticker */}
<Marquee <Marquee
items={[ items={[
"AI AGENT NETWORKING LAB", "AI AGENT NETWORKING",
"A2A PROTOCOLS & ACP", "A2A PROTOCOLS & ACP",
"QUIC MULTI-AGENT ORCHESTRATION", "QUIC BASED INTERFACE MODULE",
"KNU / CSE / ANL", "MULTI-AGENT ORCHESTRATION",
"KYUNGPOOK NATIONAL UNIVERSITY",
]} ]}
reverse reverse
className="border-b border-line py-4 font-display text-lg tracking-wide text-ink/90" className="border-b border-line py-4 font-display text-lg tracking-wide text-ink/90"
@@ -51,7 +50,7 @@ export default function Footer() {
경북대학교 IT대학 5호관(415동) 527호<br /> 경북대학교 IT대학 5호관(415동) 527호<br />
<a <a
href="mailto:sjkoh@knu.ac.kr" href="mailto:sjkoh@knu.ac.kr"
className="draw-underline mt-2 inline-block text-ink hover:text-vermillion font-medium" className="draw-underline mt-2 inline-block text-ink hover:text-vermillion-dark font-medium"
> >
sjkoh@knu.ac.kr sjkoh@knu.ac.kr
</a> </a>
@@ -69,7 +68,7 @@ export default function Footer() {
</span> </span>
<Link <Link
href={l.href} href={l.href}
className="text-sm text-ink-soft transition hover:text-vermillion" className="text-sm text-ink-soft transition hover:text-vermillion-dark"
> >
{l.ko}{" "} {l.ko}{" "}
<span className="text-xs text-ink-mute">{l.en}</span> <span className="text-xs text-ink-mute">{l.en}</span>
+17 -37
View File
@@ -9,7 +9,7 @@ import ThemeToggle from "./ThemeToggle";
const navItems = [ const navItems = [
{ href: "/", ko: "홈", en: "Home", no: "01" }, { href: "/", ko: "홈", en: "Home", no: "01" },
{ href: "/members", ko: "구성원", en: "Members", no: "02" }, { href: "/members", ko: "구성원", en: "Members", no: "02" },
{ href: "/publications/intl-journal-conf", ko: "논문", en: "Publications", no: "03" }, { href: "/publications", ko: "논문", en: "Publications", no: "03" },
{ href: "/lectures", ko: "강의", en: "Lectures", no: "04" }, { href: "/lectures", ko: "강의", en: "Lectures", no: "04" },
{ href: "/standardization", ko: "표준화", en: "Standardization", no: "05" }, { href: "/standardization", ko: "표준화", en: "Standardization", no: "05" },
]; ];
@@ -22,13 +22,13 @@ export default function Header() {
pathname pathname
? href === "/" ? href === "/"
? pathname === "/" ? pathname === "/"
: pathname === href || pathname.startsWith(`${href}/`) || (href.startsWith("/publications") && pathname.startsWith("/publications")) : pathname === href || pathname.startsWith(`${href}/`)
: false; : false;
return ( return (
<header className="sticky top-0 z-50 border-b border-ink bg-ivory/85 backdrop-blur py-2 sm:py-3"> <header className="sticky top-0 z-50 border-b border-ink bg-ivory/85 backdrop-blur">
{/* Journal issue strip — magazine masthead feel. */} {/* Journal issue strip — magazine masthead feel. */}
<div className="hidden border-b border-line pb-2 mb-2 desktop:block"> <div className="hidden border-b border-line desktop:block">
<div className="container-content flex items-center justify-between py-1.5"> <div className="container-content flex items-center justify-between py-1.5">
<span className="kicker">KNU/CSE/ANL</span> <span className="kicker">KNU/CSE/ANL</span>
{/* CUSTOMIZATION HOOK: masthead tagline */} {/* CUSTOMIZATION HOOK: masthead tagline */}
@@ -39,11 +39,11 @@ export default function Header() {
</div> </div>
</div> </div>
<div className="container-content flex min-h-[4.5rem] items-center justify-between gap-8 py-2 sm:py-3"> <div className="container-content flex h-[4.25rem] items-center justify-between gap-4">
{/* Brand logo — explicit right margin to guarantee clear separation from 01 HOME */} {/* Brand logo */}
<Link <Link
href="/" href="/"
className="group flex flex-col leading-none shrink-0 mr-8 xl:mr-16" className="group flex flex-col leading-none shrink-0"
onClick={() => setOpen(false)} onClick={() => setOpen(false)}
> >
<span className="headline-ko text-lg text-ink sm:text-xl"> <span className="headline-ko text-lg text-ink sm:text-xl">
@@ -55,7 +55,7 @@ export default function Header() {
</Link> </Link>
{/* Desktop nav — small caps, wide tracking (visible at >= 1240px) */} {/* Desktop nav — small caps, wide tracking (visible at >= 1240px) */}
<div className="hidden items-center gap-6 desktop:flex ml-auto"> <div className="hidden items-center gap-4 desktop:flex">
<nav className="flex items-center gap-2" aria-label="주 메뉴"> <nav className="flex items-center gap-2" aria-label="주 메뉴">
{navItems.map((item) => { {navItems.map((item) => {
const active = isActive(item.href); const active = isActive(item.href);
@@ -64,28 +64,20 @@ export default function Header() {
key={item.href} key={item.href}
href={item.href} href={item.href}
aria-current={active ? "page" : undefined} aria-current={active ? "page" : undefined}
style={ className={`group relative flex items-baseline gap-1.5 text-[0.78rem] font-semibold uppercase tracking-[0.18em] transition-all px-3 py-1.5 rounded-md ${
active active
? { backgroundColor: "var(--vermillion)", color: "#ffffff" } ? "bg-cobalt-dark text-white dark:text-ivory shadow-sm font-bold"
: undefined : "text-ink hover:text-cobalt-dark hover:bg-paper/60"
}
className={`group relative flex items-baseline gap-1.5 text-[0.78rem] font-bold uppercase tracking-[0.18em] transition-all px-3.5 py-1.5 rounded-md ${
active
? "shadow-sm font-bold"
: "text-ink hover:text-vermillion hover:bg-paper/60"
}`} }`}
> >
<span <span
style={active ? { color: "#ffffff" } : undefined}
className={`font-display text-[0.62rem] ${ className={`font-display text-[0.62rem] ${
active ? "opacity-90 font-bold" : "text-ink-mute" active ? "text-white dark:text-ivory" : "text-ink-mute"
}`} }`}
> >
{item.no} {item.no}
</span> </span>
<span style={active ? { color: "#ffffff" } : undefined}> <span>{item.en}</span>
{item.en}
</span>
</Link> </Link>
); );
})} })}
@@ -132,37 +124,25 @@ export default function Header() {
href={item.href} href={item.href}
onClick={() => setOpen(false)} onClick={() => setOpen(false)}
aria-current={active ? "page" : undefined} aria-current={active ? "page" : undefined}
style={
active
? { backgroundColor: "var(--vermillion)", color: "#ffffff" }
: undefined
}
className={`flex items-baseline justify-between px-4 py-3.5 transition-colors rounded-md my-1 ${ className={`flex items-baseline justify-between px-4 py-3.5 transition-colors rounded-md my-1 ${
active active
? "font-bold shadow-sm" ? "bg-cobalt-dark text-white dark:text-ivory font-bold shadow-sm"
: "text-ink hover:bg-paper/60" : "text-ink hover:bg-paper/60"
}`} }`}
> >
<span className="flex items-baseline gap-3"> <span className="flex items-baseline gap-3">
<span <span
style={active ? { color: "#ffffff" } : undefined}
className={`font-display text-xs ${ className={`font-display text-xs ${
active ? "opacity-90 font-bold" : "text-ink-mute" active ? "text-white dark:text-ivory" : "text-ink-mute"
}`} }`}
> >
{item.no} {item.no}
</span> </span>
<span <span className="headline-ko text-lg">{item.ko}</span>
style={active ? { color: "#ffffff" } : undefined}
className="headline-ko text-lg font-bold"
>
{item.ko}
</span>
</span> </span>
<span <span
style={active ? { color: "#ffffff" } : undefined}
className={`text-[0.7rem] font-semibold uppercase tracking-[0.18em] ${ className={`text-[0.7rem] font-semibold uppercase tracking-[0.18em] ${
active ? "opacity-90 font-bold" : "text-ink-mute" active ? "text-white dark:text-ivory" : "text-ink-mute"
}`} }`}
> >
{item.en} {item.en}
+14 -14
View File
@@ -389,77 +389,77 @@ export const publications: Publication[] = [
}, },
{ {
"category": "intl-journal-conf", "category": "intl-journal-conf",
"title": "Mobility Management Requirements and Framework for Systems Beyond IMT-2000\",", "title": "Mobility Management Requirements and Framework for Systems Beyond IMT-2000",
"venue": "Journal of Communications and Networks", "venue": "Journal of Communications and Networks",
"volume": "Vol. 7, No. 2, pp. 171~177, June 2005", "volume": "Vol. 7, No. 2, pp. 171~177, June 2005",
"publishedAt": "2005-06" "publishedAt": "2005-06"
}, },
{ {
"category": "intl-journal-conf", "category": "intl-journal-conf",
"title": "Transport Layer Mobility Support Utilizing Link Signal Strength Information\",", "title": "Transport Layer Mobility Support Utilizing Link Signal Strength Information",
"venue": "IEICE Transactions on Communications", "venue": "IEICE Transactions on Communications",
"volume": "Vol. E87-B, No. 9, pp. 2548~2556, September 2004", "volume": "Vol. E87-B, No. 9, pp. 2548~2556, September 2004",
"publishedAt": "2004-09" "publishedAt": "2004-09"
}, },
{ {
"category": "intl-journal-conf", "category": "intl-journal-conf",
"title": "Limiting the Length of BET for Tunnel-Based IP Fast Handover\",", "title": "Limiting the Length of BET for Tunnel-Based IP Fast Handover",
"venue": "IEICE Transactions on Fundamentals of Electronics Communications and Computer Sciences", "venue": "IEICE Transactions on Fundamentals of Electronics Communications and Computer Sciences",
"volume": "Vol. E87-A, No. 6, pp. 1527~1530, June 2004", "volume": "Vol. E87-A, No. 6, pp. 1527~1530, June 2004",
"publishedAt": "2004-06" "publishedAt": "2004-06"
}, },
{ {
"category": "intl-journal-conf", "category": "intl-journal-conf",
"title": "mSCTP for Soft Handover in Transport Layer\",", "title": "mSCTP for Soft Handover in Transport Layer",
"venue": "IEEE Communications Letters", "venue": "IEEE Communications Letters",
"volume": "Vol. 8, No. 3, pp. 189~191, March 2004", "volume": "Vol. 8, No. 3, pp. 189~191, March 2004",
"publishedAt": "2004-03" "publishedAt": "2004-03"
}, },
{ {
"category": "intl-journal-conf", "category": "intl-journal-conf",
"title": "Configuration of ACK Trees for Multicast Transport Protocols\",", "title": "Configuration of ACK Trees for Multicast Transport Protocols",
"venue": "ETRI Journal", "venue": "ETRI Journal",
"volume": "Vol. 23, No. 3, pp. 111~120, September 2001", "volume": "Vol. 23, No. 3, pp. 111~120, September 2001",
"publishedAt": "2001-09" "publishedAt": "2001-09"
}, },
{ {
"category": "intl-journal-conf", "category": "intl-journal-conf",
"title": "Assignment of ADM Rings and DCS Mesh in Telecommunication Networks\",", "title": "Assignment of ADM Rings and DCS Mesh in Telecommunication Networks",
"venue": "Journal of the O.R. Society", "venue": "Journal of the O.R. Society",
"volume": "Vol. 52, No. 4, pp. 440~448, April 2001", "volume": "Vol. 52, No. 4, pp. 440~448, April 2001",
"publishedAt": "2001-04" "publishedAt": "2001-04"
}, },
{ {
"category": "intl-journal-conf", "category": "intl-journal-conf",
"title": "Multicast Delivery Based on Unicast and Subnet Multicast\",", "title": "Multicast Delivery Based on Unicast and Subnet Multicast",
"venue": "IEEE Communications Letters", "venue": "IEEE Communications Letters",
"volume": "Vol. 5, No. 4, pp. 181~183, April 2001", "volume": "Vol. 5, No. 4, pp. 181~183, April 2001",
"publishedAt": "2001-04" "publishedAt": "2001-04"
}, },
{ {
"category": "intl-journal-conf", "category": "intl-journal-conf",
"title": "Dynamic Bandwidth Allocation Scheme for Multiple Real-time VBR Videos over ATM Networks\",", "title": "Dynamic Bandwidth Allocation Scheme for Multiple Real-time VBR Videos over ATM Networks",
"venue": "Telecommunications Systems", "venue": "Telecommunications Systems",
"volume": "Vol. 15, pp.359~380, December 2000", "volume": "Vol. 15, pp.359~380, December 2000",
"publishedAt": "2000-12" "publishedAt": "2000-12"
}, },
{ {
"category": "intl-journal-conf", "category": "intl-journal-conf",
"title": "Minimizing Cost and Delay in Shared Multicast Trees\",", "title": "Minimizing Cost and Delay in Shared Multicast Trees",
"venue": "ETRI Journal", "venue": "ETRI Journal",
"volume": "Vol. 22, No. 1, pp.30~37, March 2000", "volume": "Vol. 22, No. 1, pp.30~37, March 2000",
"publishedAt": "2000-03" "publishedAt": "2000-03"
}, },
{ {
"category": "intl-journal-conf", "category": "intl-journal-conf",
"title": "Non-Core Based Shared Tree Architecture for IP Multicasting\",", "title": "Non-Core Based Shared Tree Architecture for IP Multicasting",
"venue": "Electronics Letters", "venue": "Electronics Letters",
"volume": "Vol. 35, No. 11, pp. 872~873, May 1999", "volume": "Vol. 35, No. 11, pp. 872~873, May 1999",
"publishedAt": "1999-05" "publishedAt": "1999-05"
}, },
{ {
"category": "intl-journal-conf", "category": "intl-journal-conf",
"title": "A Design of the Self-Healing ATM Networks Based on the Backup Virtual Path,", "title": "A Design of the Self-Healing ATM Networks Based on the Backup Virtual Path",
"venue": "Computers and Operations Research", "venue": "Computers and Operations Research",
"volume": "Vol. 25, No. 7/8, pp. 595~609, July 1998", "volume": "Vol. 25, No. 7/8, pp. 595~609, July 1998",
"publishedAt": "1998-07" "publishedAt": "1998-07"
@@ -473,7 +473,7 @@ export const publications: Publication[] = [
}, },
{ {
"category": "intl-journal-conf", "category": "intl-journal-conf",
"title": "A Tabu Search for the Survivable Fiber Optic Communication Network Design,", "title": "A Tabu Search for the Survivable Fiber Optic Communication Network Design",
"venue": "Computers and Industrial Engineering", "venue": "Computers and Industrial Engineering",
"volume": "Vol. 28, Issue 4, pp. 689~700, October 1995", "volume": "Vol. 28, Issue 4, pp. 689~700, October 1995",
"publishedAt": "1995-10" "publishedAt": "1995-10"
@@ -1096,7 +1096,7 @@ export const publications: Publication[] = [
}, },
{ {
"category": "domestic-journal-conf", "category": "domestic-journal-conf",
"title": "멀티캐스트 전송을 위한 오류제어 기법의 분류\",", "title": "멀티캐스트 전송을 위한 오류제어 기법의 분류",
"venue": "ETRI 전자통신동향분석", "venue": "ETRI 전자통신동향분석",
"volume": "99년 6월호, pp. 76 - 84, 1999.", "volume": "99년 6월호, pp. 76 - 84, 1999.",
"publishedAt": "1999", "publishedAt": "1999",
@@ -1476,7 +1476,7 @@ export const patents: Patent[] = [
}, },
{ {
"category": "patent", "category": "patent",
"title": "ESL 신호를 이용하여 위치 기반 서비스를 제공하는 스마트 장치,", "title": "ESL 신호를 이용하여 위치 기반 서비스를 제공하는 스마트 장치",
"inventors": "고석주, 김지인, 이민형, 김종근, 박지수, 조정근, 이승일, 서대화", "inventors": "고석주, 김지인, 이민형, 김종근, 박지수, 조정근, 이승일, 서대화",
"applicationNo": "2014-0180036", "applicationNo": "2014-0180036",
"applicationAt": "2014-12-15", "applicationAt": "2014-12-15",
+2 -2
View File
@@ -47,8 +47,8 @@
| `line` | `#D8D1C0` | `--line` | 헤어라인 그리드 간격(`gap-px bg-line`) | | `line` | `#D8D1C0` | `--line` | 헤어라인 그리드 간격(`gap-px bg-line`) |
| `vermillion` (DEFAULT) | `#D9342B` | `--vermillion` | **Agent Eng / Orchestration 강조(Hot)** · 홀수 항목 | | `vermillion` (DEFAULT) | `#D9342B` | `--vermillion` | **Agent Eng / Orchestration 강조(Hot)** · 홀수 항목 |
| `vermillion-dark` | `#A8231C` | — | vermillion 의 호버/심도(dim) 변형 | | `vermillion-dark` | `#A8231C` | — | vermillion 의 호버/심도(dim) 변형 |
| `cobalt` (DEFAULT) | `#1B3A8A` | `--cobalt` | **MCP / A2A Protocol 강조(Cool)** · 짝수 항목 | | `cobalt` (DEFAULT) | `#4E77FF` | `--cobalt` | **MCP / A2A Protocol 강조(Cool)** · 짝수 항목 |
| `cobalt-dark` | `#122863` | — | cobalt 의 호버/심도(dim) 변형 | | `cobalt-dark` | `#345AD2` | — | cobalt 의 호버/심도(dim) 변형 및 소형 텍스트/상태 칩 전용 접근성 변형 |
| `brand`, `accent` | (별칭) | — | **레거시 호환 전용.** 신규 코드에서 사용 금지 | | `brand`, `accent` | (별칭) | — | **레거시 호환 전용.** 신규 코드에서 사용 금지 |
### 개념적 역할 매핑 (Naming note) ### 개념적 역할 매핑 (Naming note)
@@ -117,7 +117,9 @@ def parse_members():
clean_item = re.sub(r'<.*?>', '', clean_item) clean_item = re.sub(r'<.*?>', '', clean_item)
clean_item = clean_item.strip().replace('\n', ' ') clean_item = clean_item.strip().replace('\n', ' ')
clean_item = re.sub(r'[:&\s]+$', '', clean_item) clean_item = re.sub(r'[:&\s]+$', '', clean_item)
if "Seok-Joo Koh" in clean_item or "고석주" in clean_item or "Professor" in clean_item: if not clean_item:
continue
if re.search(r'^Seok-Joo Koh\b', clean_item) or "고석주" in clean_item:
en = "Seok-Joo Koh" en = "Seok-Joo Koh"
ko = "고석주" ko = "고석주"
degree = "Professor" degree = "Professor"
@@ -209,7 +211,7 @@ def parse_publications():
m_title = re.search(r'<U>(.*?)</U>', item, flags=re.S | re.I) m_title = re.search(r'<U>(.*?)</U>', item, flags=re.S | re.I)
if m_title: if m_title:
raw_t = re.sub(r'<br/?>', '', m_title.group(1), flags=re.I).replace('\n', ' ').strip() raw_t = re.sub(r'<br/?>', '', m_title.group(1), flags=re.I).replace('\n', ' ').strip()
title = re.sub(r'^(?:"|“|”|\s)+|(?:"|“|”|\s)+$', '', raw_t).strip() title = re.sub(r'^[\s"“”]+|[\s"“”,]+$', '', raw_t).strip()
else: else:
title = "" title = ""
@@ -236,7 +238,7 @@ def parse_publications():
m_title = re.search(r'<U>(.*?)</U>', item, flags=re.S | re.I) m_title = re.search(r'<U>(.*?)</U>', item, flags=re.S | re.I)
if m_title: if m_title:
raw_t = re.sub(r'<br/?>', '', m_title.group(1), flags=re.I).replace('\n', ' ').strip() raw_t = re.sub(r'<br/?>', '', m_title.group(1), flags=re.I).replace('\n', ' ').strip()
title = re.sub(r'^(?:"|“|”|\s)+|(?:"|“|”|\s)+$', '', raw_t).strip() title = re.sub(r'^[\s"“”]+|[\s"“”,]+$', '', raw_t).strip()
else: else:
title = "" title = ""
@@ -266,7 +268,7 @@ def parse_publications():
lines = [l.strip() for l in clean.split('\n') if l.strip()] lines = [l.strip() for l in clean.split('\n') if l.strip()]
if not lines: if not lines:
continue continue
title = lines[0] title = re.sub(r'^[\s"“”]+|[\s"“”,]+$', '', lines[0]).strip()
inventors = "" inventors = ""
app_no = "" app_no = ""
app_date = None app_date = None
@@ -54,6 +54,12 @@ def verify():
if "63246" not in d["ref"]: if "63246" not in d["ref"]:
errors.append(f"AC-32 Violation: CCIS project deliverable '{d['ref']}' does not belong to CCIS WG (IEC 63246)") errors.append(f"AC-32 Violation: CCIS project deliverable '{d['ref']}' does not belong to CCIS WG (IEC 63246)")
# N1: Title artifact check (No trailing quotes or commas in publication titles)
for p in intl_p + dom_p + pat_p:
t = p.get("title", "")
if re.search(r'["“”]|,$', t):
errors.append(f"N1 Title Artifact Violation in publication '{p.get('id')}': title '{t}' contains quotes or trailing comma")
# 1. Count checks # 1. Count checks
if len(active_m) != 16: if len(active_m) != 16:
errors.append(f"Active Members count mismatch: got {len(active_m)}, expected 16") errors.append(f"Active Members count mismatch: got {len(active_m)}, expected 16")
+168 -23
View File
@@ -159,18 +159,15 @@ def test_unittest_suite():
return True return True
def test_layout_architecture(): def test_layout_architecture():
print("\n--- Gate 8: Layout Architecture & No-Escape Gate (AC-25 / AC-26 / R-8.17) ---") print("\n--- Gate 8: Layout Architecture & No-Escape Gate (AC-25 / AC-26 / AC-40 / AC-41 / R-8.17) ---")
# 1) Check HTML SSG pages for container-content inside main # 1) Check HTML SSG pages for container-content inside main across ALL SSG routes (C2, AC-25)
routes_to_check = [ routes_to_check = EXPECTED_SSG_ROUTES
os.path.join(".next", "server", "app", "index.html"),
os.path.join(".next", "server", "app", "members.html"),
os.path.join(".next", "server", "app", "publications.html"),
os.path.join(".next", "server", "app", "lectures.html"),
os.path.join(".next", "server", "app", "standardization.html"),
]
main_hashes = {}
for rel_p in routes_to_check: for rel_p in routes_to_check:
if not rel_p.endswith(".html"):
continue
full_p = os.path.join(REFER_DIR, rel_p) full_p = os.path.join(REFER_DIR, rel_p)
if not os.path.exists(full_p): if not os.path.exists(full_p):
print(f"❌ Missing SSG route HTML: {rel_p}") print(f"❌ Missing SSG route HTML: {rel_p}")
@@ -178,24 +175,31 @@ def test_layout_architecture():
with open(full_p, "r", encoding="utf-8") as f: with open(full_p, "r", encoding="utf-8") as f:
html = f.read() html = f.read()
# Verify <main tag does NOT contain max-w- or px- # Verify <main> tag exists and does NOT contain max-w- or px-
main_match = re.search(r'<main\s+class="([^"]*)"', html) main_match = re.search(r'<main(?:\s+[^>]*)?>(.*?)</main>', html, flags=re.S)
if not main_match: if not main_match:
print(f"❌ <main> tag not found in {rel_p}") print(f"❌ <main> tag not found in {rel_p}")
return False return False
main_cls = main_match.group(1)
if "max-w-" in main_cls or "px-" in main_cls or "container-content" in main_cls: main_inner = main_match.group(1)
print(f"❌ <main> tag in {rel_p} restricts width or padding ({main_cls}). Should be w-full flex-1 only.")
# C1: Verify child wrapper inside <main> has container-content
if "container-content" not in main_inner and "_not-found" not in rel_p and "404" not in rel_p:
print(f"❌ container-content missing inside <main> in {rel_p}")
return False return False
# Verify child wrapper has container-content # AC-41: Check for duplicate <main> normalized content hashes (except 404 pages)
if "container-content" not in html: if "404" not in rel_p and "_not-found" not in rel_p:
print(f"❌ container-content missing in {rel_p}") norm_content = re.sub(r'\s+', '', main_inner)
if norm_content in main_hashes:
print(f"❌ AC-41 Violation: Duplicate <main> content found between {rel_p} and {main_hashes[norm_content]}")
return False return False
main_hashes[norm_content] = rel_p
# 2) Check source for forbidden escaped arbitrary classes (AC-26) # 2) Check source for forbidden escaped arbitrary classes (AC-26)
forbidden_terms = ["w-screen", "-mx-[50vw]", "min-[1240px]:"] forbidden_terms = ["w-screen", "-mx-[50vw]", "min-[1240px]:"]
for root, _, files in os.walk(os.path.join(REFER_DIR, "app")): for root_dir in [os.path.join(REFER_DIR, "app"), os.path.join(REFER_DIR, "components")]:
for root, _, files in os.walk(root_dir):
for fname in files: for fname in files:
if fname.endswith((".ts", ".tsx")): if fname.endswith((".ts", ".tsx")):
fpath = os.path.join(root, fname) fpath = os.path.join(root, fname)
@@ -206,18 +210,157 @@ def test_layout_architecture():
print(f"❌ Forbidden term '{term}' found in {fpath}") print(f"❌ Forbidden term '{term}' found in {fpath}")
return False return False
for root, _, files in os.walk(os.path.join(REFER_DIR, "components")): print("✅ Gate 8 PASSED: Layout 3-tier architecture, route uniqueness (AC-41), and AC-25/AC-26 no-escape rule verified")
return True
def test_token_contracts():
print("\n--- Gate 9: Color Token Alpha Contract & Header Style Gate (AC-35 / AC-36 / AC-37) ---")
# AC-36: Verify zero commas in --*-rgb definitions in globals.css
globals_css = os.path.join(REFER_DIR, "app", "globals.css")
with open(globals_css, "r", encoding="utf-8") as f:
css_text = f.read()
rgb_lines = re.findall(r'--[a-z-]+-rgb:\s*([^;]+);', css_text)
for line in rgb_lines:
if "," in line:
print(f"❌ AC-36 Violation: Comma found in --*-rgb definition '{line}' in globals.css")
return False
# AC-35: Verify tailwind.config.ts has <alpha-value> for color tokens
tw_config = os.path.join(REFER_DIR, "tailwind.config.ts")
with open(tw_config, "r", encoding="utf-8") as f:
tw_text = f.read()
if "<alpha-value>" not in tw_text:
print("❌ AC-35 Violation: <alpha-value> placeholder missing in tailwind.config.ts")
return False
# AC-37: Verify Header.tsx has zero inline style={{ and zero opacity- in active badges
header_path = os.path.join(REFER_DIR, "components", "Header.tsx")
with open(header_path, "r", encoding="utf-8") as f:
header_text = f.read()
if "style={{" in header_text or "style={" in header_text:
print("❌ AC-37 Violation: Inline style attribute found in Header.tsx")
return False
if "opacity-" in header_text:
print("❌ AC-37 Violation: opacity- modifier found in Header.tsx active badge elements")
return False
print("✅ Gate 9 PASSED: Color token alpha contract, space separation (AC-36), and Header clean styling (AC-37) verified")
return True
def srgb_luminance(r, g, b):
def adjust(c):
c = c / 255.0
return c / 12.92 if c <= 0.04045 else ((c + 0.055) / 1.055) ** 2.4
return 0.2126 * adjust(r) + 0.7152 * adjust(g) + 0.0722 * adjust(b)
def contrast_ratio(rgb1, rgb2):
l1 = srgb_luminance(*rgb1)
l2 = srgb_luminance(*rgb2)
return (max(l1, l2) + 0.05) / (min(l1, l2) + 0.05)
def test_color_contrast_gate():
print("\n--- Gate 10: WCAG 2.1 AA Color Contrast & Whitelist Gate (AC-43 / AC-44 / AC-45 / AC-47) ---")
globals_css = os.path.join(REFER_DIR, "app", "globals.css")
with open(globals_css, "r", encoding="utf-8") as f:
css_text = f.read()
# Parse light and dark RGB tokens
root_match = re.search(r':root\s*\{([^}]+)\}', css_text, flags=re.S)
dark_match = re.search(r'html\[data-theme="dark"\]\s*\{([^}]+)\}', css_text, flags=re.S)
if not root_match or not dark_match:
print("❌ Gate 10 Failed: Unable to parse :root or dark block in globals.css")
return False
def parse_tokens(block):
res = {}
for m in re.finditer(r'--([a-z-]+)-rgb:\s*(\d+)\s+(\d+)\s+(\d+);', block):
res[m.group(1)] = (int(m.group(2)), int(m.group(3)), int(m.group(4)))
return res
light_tokens = parse_tokens(root_match.group(1))
dark_tokens = parse_tokens(dark_match.group(1))
# AC-43: Verify contrast thresholds for cobalt-dark and vermillion-dark on ivory and paper
cd_light = light_tokens.get("cobalt-dark")
vd_light = light_tokens.get("vermillion-dark")
ivory_light = light_tokens.get("ivory")
paper_light = light_tokens.get("paper")
if not all([cd_light, vd_light, ivory_light, paper_light]):
print("❌ AC-43 Failed: Missing required light RGB tokens")
return False
ratio_cd_ivory = contrast_ratio(cd_light, ivory_light)
ratio_cd_paper = contrast_ratio(cd_light, paper_light)
ratio_vd_ivory = contrast_ratio(vd_light, ivory_light)
ratio_vd_paper = contrast_ratio(vd_light, paper_light)
if ratio_cd_ivory < 4.5 or ratio_cd_paper < 4.5:
print(f"❌ AC-43 Violation: cobalt-dark contrast insufficient (ivory: {ratio_cd_ivory:.2f}, paper: {ratio_cd_paper:.2f})")
return False
if ratio_vd_ivory < 4.5 or ratio_vd_paper < 4.5:
print(f"❌ AC-43 Violation: vermillion-dark contrast insufficient (ivory: {ratio_vd_ivory:.2f}, paper: {ratio_vd_paper:.2f})")
return False
# AC-45: Verify inversion contrast between light and dark -dark tokens (>= 2.0)
cd_l = light_tokens.get("cobalt-dark")
cd_d = dark_tokens.get("cobalt-dark")
vd_l = light_tokens.get("vermillion-dark")
vd_d = dark_tokens.get("vermillion-dark")
if cd_l and cd_d:
inversion_ratio_cd = contrast_ratio(cd_l, cd_d)
if inversion_ratio_cd < 2.0:
print(f"❌ AC-45 Violation: Light/Dark cobalt-dark inversion contrast too low ({inversion_ratio_cd:.2f} < 2.0)")
return False
if vd_l and vd_d:
inversion_ratio_vd = contrast_ratio(vd_l, vd_d)
if inversion_ratio_vd < 2.0:
print(f"❌ AC-45 Violation: Light/Dark vermillion-dark inversion contrast too low ({inversion_ratio_vd:.2f} < 2.0)")
return False
# AC-44: Verify text-cobalt or text-vermillion (DEFAULT) is not combined with small text sizes
# AC-47: Verify text-white utility usage <= 8 instances
# C11-9 (AC-48): Verify zero dark: modifier usage on accent colors (R-8.29)
white_count = 0
small_size_pattern = re.compile(r'text-(xs|sm|\[0\.65rem\]|\[0\.78rem\])')
default_color_pattern = re.compile(r'text-(cobalt|vermillion)(?![a-z-])')
dark_accent_pattern = re.compile(r'dark:(?:[a-z:-]*)(cobalt|vermillion)')
for root_dir in [os.path.join(REFER_DIR, "app"), os.path.join(REFER_DIR, "components")]:
for root, _, files in os.walk(root_dir):
for fname in files: for fname in files:
if fname.endswith((".ts", ".tsx")): if fname.endswith((".ts", ".tsx")):
fpath = os.path.join(root, fname) fpath = os.path.join(root, fname)
with open(fpath, "r", encoding="utf-8") as f: with open(fpath, "r", encoding="utf-8") as f:
content = f.read() content = f.read()
for term in forbidden_terms:
if term in content: # AC-47 count
print(f"❌ Forbidden term '{term}' found in {fpath}") white_count += content.count("text-white")
# AC-44 & C11-9 check line by line
for line_idx, line in enumerate(content.splitlines(), start=1):
# C11-9: Zero dark: modifier on accent colors (allow dark:text-ivory / dark:group-open:text-ivory exceptions)
if dark_accent_pattern.search(line):
print(f"❌ C11-9 (AC-48) Violation: Forbidden dark: modifier on accent color at {fpath}:{line_idx}\n {line.strip()}")
return False return False
print("✅ Gate 8 PASSED: Layout 3-tier architecture and AC-25/AC-26 no-escape rule verified") if small_size_pattern.search(line) and default_color_pattern.search(line):
# Ignore allowed exceptions (e.g. HeroComposition, Pillar bullets, or explicitly exempted titles)
if "Pillar #" in line or "w-1.5 h-1.5" in line or "text-3xl" in line:
continue
print(f"❌ AC-44 Violation: Small text combined with DEFAULT accent color at {fpath}:{line_idx}\n {line.strip()}")
return False
if white_count > 8:
print(f"❌ AC-47 Violation: text-white usage count ({white_count}) exceeds whitelist limit (8)")
return False
print(f"✅ Gate 10 & 11 PASSED: Color contrast (AC-43), small text routing (AC-44), inversion (AC-45), text-white count ({white_count}/8, AC-47), and dark: accent modifier zero check (C11-9) verified")
return True return True
def main(): def main():
@@ -235,6 +378,8 @@ def main():
success &= test_theme_tokens() success &= test_theme_tokens()
success &= test_unittest_suite() success &= test_unittest_suite()
success &= test_layout_architecture() success &= test_layout_architecture()
success &= test_token_contracts()
success &= test_color_contrast_gate()
print("\n" + "-" * 70) print("\n" + "-" * 70)
if success: if success:
+14 -14
View File
@@ -33,28 +33,28 @@ const config: Config = {
}, },
colors: { colors: {
ink: { ink: {
DEFAULT: "var(--ink)", DEFAULT: "rgb(var(--ink-rgb) / <alpha-value>)",
soft: "var(--ink-soft)", soft: "rgb(var(--ink-soft-rgb) / <alpha-value>)",
mute: "var(--ink-mute)", mute: "rgb(var(--ink-mute-rgb) / <alpha-value>)",
}, },
ivory: "var(--ivory)", ivory: "rgb(var(--ivory-rgb) / <alpha-value>)",
paper: "var(--paper)", paper: "rgb(var(--paper-rgb) / <alpha-value>)",
line: "var(--line)", line: "rgb(var(--line-rgb) / <alpha-value>)",
vermillion: { vermillion: {
DEFAULT: "var(--vermillion)", DEFAULT: "rgb(var(--vermillion-rgb) / <alpha-value>)",
dark: "var(--vermillion-dark)", dark: "rgb(var(--vermillion-dark-rgb) / <alpha-value>)",
}, },
cobalt: { cobalt: {
DEFAULT: "var(--cobalt)", DEFAULT: "rgb(var(--cobalt-rgb) / <alpha-value>)",
dark: "var(--cobalt-dark)", dark: "rgb(var(--cobalt-dark-rgb) / <alpha-value>)",
}, },
// Back-compat aliases so any stray legacy class still resolves. // Back-compat aliases so any stray legacy class still resolves.
brand: { brand: {
DEFAULT: "var(--vermillion)", DEFAULT: "rgb(var(--vermillion-rgb) / <alpha-value>)",
dark: "var(--vermillion-dark)", dark: "rgb(var(--vermillion-dark-rgb) / <alpha-value>)",
light: "var(--cobalt)", light: "rgb(var(--cobalt-rgb) / <alpha-value>)",
}, },
accent: { DEFAULT: "var(--cobalt)" }, accent: { DEFAULT: "rgb(var(--cobalt-rgb) / <alpha-value>)" },
}, },
fontFamily: { fontFamily: {
// English display serif — magazine cover scale. // English display serif — magazine cover scale.
-45
View File
@@ -1,45 +0,0 @@
#!/usr/bin/env bash
# generate-env.sh — create a local .env from the committed .env.example template.
#
# Behaviour:
# - .env absent → copy .env.example to .env, print the path.
# - .env present → no-op (leaves your edits intact), exit 0.
# - .env present --force → overwrite .env from .env.example (backs up to .env.bak).
#
# Paths are resolved relative to this script (repo root = parent of deploy/),
# so it works regardless of the caller's cwd.
#
# Usage: deploy/generate-env.sh [--force] [-h|--help]
set -euo pipefail
REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
SRC="$REPO_ROOT/.env.example"
DST="$REPO_ROOT/.env"
FORCE=0
while [ $# -gt 0 ]; do
case "$1" in
--force) FORCE=1; shift ;;
-h|--help)
echo "Usage: $0 [--force]"
echo " Create .env from .env.example. --force overwrites an existing .env."
exit 0 ;;
*) echo "ERROR: unknown arg: $1" >&2; echo "Usage: $0 [--force]" >&2; exit 2 ;;
esac
done
[ -f "$SRC" ] || { echo "ERROR: template not found: $SRC" >&2; exit 1; }
if [ -f "$DST" ] && [ "$FORCE" != "1" ]; then
echo "no-op: $DST already exists (use --force to overwrite)"
exit 0
fi
if [ -f "$DST" ] && [ "$FORCE" = "1" ]; then
cp -p "$DST" "$DST.bak"
echo "backed up existing .env -> $DST.bak"
fi
cp "$SRC" "$DST"
echo "created: $DST"
echo "Next: edit $DST and fill in any secrets (look for 'replace_me')."
-1
View File
@@ -1 +0,0 @@
refer_landing_page