Connect the browser adapter to existing Chemvas editing services

.gitattributes

@@ -1,3 +1,7 @@
 # Historical documents are byte fixtures; checkout must preserve their hashes.
 tests/fixtures/document-v7/*.chemvas -text
 tests/fixtures/document-v8/*.chemvas -text
+
+# Contract snapshot assets are pinned to exact upstream bytes; line-ending
+# conversion would invalidate the SHA-256 provenance digests.
+contracts/machine-observation/** -text

.github/workflows/ci.yml

@@ -33,7 +33,6 @@ jobs:
         python-version: ["3.12", "3.13"]
     env:
       QT_QPA_PLATFORM: offscreen
-      FACTORY_MACHINE_CONTRACT_VALIDATOR: ${{ github.workspace }}/.machine-contracts/scripts/validate.py
     steps:
       - name: Check out repository
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
@@ -63,14 +62,6 @@ jobs:
           python -m pip install --upgrade pip
           python -m pip install -e ".[dev]"
 
-      - name: Check out machine observation contract
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
-        with:
-          repository: dhsohn/machine-contracts
-          ref: 38581a7737cd0521bb3d50b59115eefe3c9254ca
-          path: .machine-contracts
-          persist-credentials: false
-
       - name: Lint
         run: python -m ruff check .
 
@@ -163,11 +154,15 @@ jobs:
             tests/test_windows_installer.py \
             tests/test_application_cli.py
 
+      - name: Compare browser font sizes with the Windows font engine
+        shell: bash
+        env:
+          QT_QPA_PLATFORM: windows
+        run: python -m pytest -q tests/test_web_adapter.py -k browser_font_pixels_match_pinned_native_font
+
   rdkit-smoke:
     name: RDKit smoke tests
     runs-on: ubuntu-latest
-    env:
-      FACTORY_MACHINE_CONTRACT_VALIDATOR: ${{ github.workspace }}/.machine-contracts/scripts/validate.py
     steps:
       - name: Check out repository
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
@@ -188,16 +183,6 @@ jobs:
           python -m pip install --upgrade pip
           python -m pip install -e ".[dev,rdkit]"
 
-      - name: Check out machine observation contract
-        # Real-RDKit pack-step tests validate their machine.json against the
-        # same pinned contract as the main test job.
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
-        with:
-          repository: dhsohn/machine-contracts
-          ref: 38581a7737cd0521bb3d50b59115eefe3c9254ca
-          path: .machine-contracts
-          persist-credentials: false
-
       - name: Verify RDKit import
         run: |
           python - <<'PY'
@@ -235,7 +220,8 @@ jobs:
             tests/test_rdkit_hypercoordinate_geometry.py \
             tests/test_macrocycle_depiction_evaluation.py \
             tests/test_rdkit_real_use.py \
-            tests/test_rdkit_smiles_hydrogens.py
+            tests/test_rdkit_smiles_hydrogens.py \
+            tests/test_web_adapter.py
 
       - name: Report coverage
         if: ${{ !cancelled() && steps.tests.outcome != 'skipped' }}

.github/workflows/platform.yml

@@ -35,15 +35,7 @@ jobs:
       - name: Install Python dependencies
         run: python -m pip install -e ".[dev]"
 
-      - name: Check out machine observation contract
-        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
-        with:
-          repository: dhsohn/machine-contracts
-          ref: 38581a7737cd0521bb3d50b59115eefe3c9254ca
-          path: .machine-contracts
-          persist-credentials: false
-
       - name: Run the host platform gate
         shell: bash
         run: |
-          FACTORY_MACHINE_CONTRACT_REPO="$PWD/.machine-contracts" bash scripts/check.sh
+          bash scripts/check.sh

AGENTS.md

@@ -1,8 +1,9 @@
 # 작업자 진입점 — Chemvas
 
-공장 공통 규칙은 `~/manual/AGENTS.md`가 지정하는 순서를 따른다(`FACTORY_MANUAL.md` →
-자기 사이트 장부 → 이 파일). 여기에는 그 규칙을 복제하지 않고, **이 레포에만 해당하는
-운영 사실**만 둔다.
+공장 작업자는 `~/manual/AGENTS.md`가 지정하는 순서를 따른다(`FACTORY_MANUAL.md` →
+자기 사이트 장부 → 이 파일). 일반 기여자는 이 레포만으로 개발·검증할 수 있으며
+[CONTRIBUTING.md](CONTRIBUTING.md)가 안내한다. 여기에는 공장 규칙을 복제하지 않고,
+**이 레포에만 해당하는 운영 사실**만 둔다.
 
 ## 이 레포가 무엇인가
 
@@ -51,9 +52,9 @@ worktree에서도 준비 없이 돌고, 맞는 인터프리터가 없거나 `.ve
 `.venv`를 지우거나 `PYTHON_BIN`을 지정한다. 테스트는 `PYTHONPATH=app`으로 설치본이
 아닌 이 체크아웃의 코드를 쓴다. Qt가 모듈 간에 완전히 리셋되지 않는 전역 상태를 유지하므로, 전체를
 한 프로세스에 몰아넣은 실행은 통과해도 CI를 대표하지 않는다 — 이 루프가 게이트다.
-`machine.json` 적합성 검증은 게이트가 `~/machine_contracts`의 정본 validator를 직접
-연결한다(`FACTORY_MACHINE_CONTRACT_REPO`로 위치 변경 가능). 해당 테스트를 직접 돌릴
-때도 validator 경로가 없으면 검증 없이 성공하지 않고 실패한다. 만진 파일만 좁혀 돌리려면:
+`machine.json` 적합성 검증은 `contracts/machine-observation/`의 프로젝트 로컬
+validator를 직접 사용한다. 외부 클론이나 환경변수 없이 동작하며, validator가 없으면
+검증 없이 성공하지 않고 실패한다. 만진 파일만 좁혀 돌리려면:
 
 ```bash
 bash scripts/check.sh tests/test_<area>.py
@@ -70,10 +71,14 @@ macOS와 네이티브 Windows에서만 지원하며, 기존 편집·텍스트·
 | 모듈 경계·리팩터링·테스트 관례 | [CONTRIBUTING.md](CONTRIBUTING.md) 및 [ADR 0005](docs/adr/0005-responsibility-based-editor-boundaries.md) — 구조 변경 전 필독. 구조 검사는 소유권과 의존 경계 계약을 보호한다 |
 | 설계 결정 기록 — 공개 계약·메이저 버전·기능 제거·상태 소유권 이동·외부 동작 의존은 같은 PR에 ADR을 쓴다 | [ADR 안내](docs/adr/README.md) |
 | 릴리스 절차 | [RELEASING.md](RELEASING.md) |
-| `machine.json` 공통 봉투 | `~/machine_contracts`의 `COMPATIBILITY.md`(v1 동결) |
+| `machine.json` 공통 봉투 | `contracts/machine-observation/NOTICE.md`(v1 동결, 프로젝트 로컬 스냅샷) |
 
-`machine.json` 표면을 바꾸려면 `machine-contracts`에 먼저 랜딩·릴리스하고, 이 레포 CI의
-pin(`.github/workflows/ci.yml`의 `ref:`)을 의도적으로 전진시킨다.
+`machine.json` 봉투 표면 변경은 이 프로젝트의 메인테이너가 소유한다. 변경 시
+출처·타입·스키마/의미 회귀 커버리지를 기록하고, 공개 계약 변경에는 ADR과 버전 관리를
+적용한다. upstream `machine-contracts`의 새 핀을 동기화하는 것은 선택적 호환 경로이며,
+필수 선행 조건이 아니다. 동기화할 경우 `NOTICE.md`의 커밋 SHA, `PROVENANCE.json`의
+해시, `tests/test_contract_compatibility.py`의 `PIN_HASHES`·`REGISTRY_HASH`를
+함께 전진시키고, 복사한 파일의 원본 스키마/의미 호환성과 출처를 보존한다.
 
 ## `make check`가 흡수하지 못하는 것