# 고정된 원본으로 웨이퍼를 접합하고 갱신 비교하기 [색인](/llms.txt) · [공정](/docs/agents/processes.md) · [구조 검사](/docs/agents/tasks/inspection.md) BONDING v2는 선택한 원본 프로젝트의 계산 구조와 재료 의미를 고정해 현재 구조에 배치합니다. 원본 프로젝트 ID 하나만 기록하는 기능이 아니며, 원본의 변경이 기존 접합에 자동 반영되는 방식도 아닙니다. ## 지원 경로 | 경로 | 현재 범위 | | --- | --- | | 일반 웹 UI | 현재 소스의 본딩 기능 플래그는 활성. BONDING 인스펙터의 원본 선택·배치 검토·적용·명시적 갱신 사용 | | 브라우저 Flow 1.0 | BONDING JSON·외부 asset 작성 입력은 `validate`·`setFlow`에서 거부 | | 선택적 브라우저 본딩 API | `capabilities.bonding` 확인 후 새 본딩 준비·적용·계산, 본딩 뒤 공정 이어 붙이기, 저장 고정본 재검증·최신 원본 갱신. 모듈 그룹이 있는 문서도 지원. 아래 지원 범위 확인 | | 연결된 MCP | Flow 1.0 도구는 BONDING 단계를 거부. 원본 접근·고정 자산·배치 승인 도구 없음. 웹 UI 사용 | | 저장소 개발 경로 | 실제 v2 커널·원본 갱신 테스트로 작은 고정 fixture 비교 가능. 내부 함수는 공개 브라우저 API가 아님 | 배포된 화면이 다르면 빌드와 기능 노출을 먼저 확인합니다. 이 안내서의 소스 동작이 과거 배포에도 있었다고 단정하지 마세요. ## 원본 선택과 변경 관리 1. 원본 프로젝트의 최종 계산 단계와 접근 권한을 확인합니다. 유효한 기존 계산 결과를 사용할 수 있는지, 원본과 캐시가 일치하는지 확인합니다. 2. BONDING 인스펙터에서 원본을 선택합니다. 비공개·초대 범위 원본은 구조를 대상에 포함하는 데 필요한 공개 범위 안내를 읽고 해당 UI 절차를 완료합니다. 프로젝트 읽기 권한과 대상 공유 권한은 같은 의미가 아닙니다. 3. 배치 중 **가져온 재료 → 재료 매핑**에서 연결을 검토하고 변경했다면 **미리보기 갱신**을 선택합니다. 실제 격자, 뒤집기, 위치, 접촉면과 채움 옵션을 확인합니다. 원본의 사용자 재료 ID를 대상에 그대로 덮어쓰지 마세요. 4. 미리보기의 접합 결과를 검토한 뒤 Apply를 실행합니다. 취소·원본 읽기 실패·오래된 캐시에서는 기존 공정과 재료가 유지되어야 합니다. 5. 원본을 수정했다면 명시적 갱신을 사용합니다. 새 원본을 다시 검토하고 적용해야 하며, 단순히 원본이 변경됐다는 이유로 기존 고정 구조를 자동 교체하지 않습니다. 이미 적용한 본딩의 연결만 바꾸려면 해당 카드에서 **가져온 재료 → 재료 매핑 → 매핑 적용**을 사용하고 재계산 결과를 확인합니다. 현재 저장 필드에는 원본 프로젝트·단계·리비전·digest와 고정 자산, 재료 매핑, 가져온 시각이 포함됩니다. Undo는 이전 원본과 재료 쌍을 복원할 수 있어야 합니다. 수동으로 digest만 바꿔 캐시 검사를 우회하지 마세요. ## 브라우저에서 준비·검토·적용·계산 새 본딩은 편집 가능한 Flow 1.0 프로젝트에서 최종 활성 단계를 선택·계산한 뒤 추가합니다. 모듈 그룹(GROUPSTART/GROUPEND)이 있는 문서도 됩니다. 저장 본딩은 아래 재개 검증·원본 갱신 경로를 사용합니다. 반복 그룹(`cycleCount` 2 이상) 안에 든 본딩, 고급 배치, 다른 원본으로 교체는 UI를 사용하세요. 새 원본 자료는 현재 계정에서 읽을 수 있는 프로젝트 ID 하나에서 준비하며 공식 예제 선택이나 원본 배열·asset 직접 주입은 제공하지 않습니다. 계정 저장·원본 문서·공유 권한을 자동 변경하지 않습니다. ```js const A = window.arpelier; if (!A?.capabilities?.bonding) throw new Error('Bonding API unavailable'); const state = await A.status(); if (!state.computedUpTo) throw new Error('Select and compute the final enabled step first'); // 실제 읽을 수 있는 계정 프로젝트 ID와 현재 완료된 최종 단계 ID를 사용합니다. const prepared = await A.prepareBonding({ sourceProjectId: 'READABLE_ACCOUNT_PROJECT_ID', afterStepId: state.computedUpTo, stepId: 'bonding-1', name: 'Pinned wafer bonding', // 공정 메모: 무엇을 왜 붙이는지, 치수 출처(링크), 이 구조에서의 위험. note: 'Device wafer flipped on x and fusion-bonded SiCN to SiCN onto the carrier. Source: ... Risk: ...', // 선택: 본딩 단계 하나를 감싼 모듈 그룹. 끝 단계 ID는 'g-bond-end'. group: { id: 'g-bond', name: 'Wafer bonding', note: 'Module note: purpose, sources, risks.' }, placement: { offsetX: 0, offsetY: 0, flipSource: true, flipAxis: 'x' }, }, { timeoutMs: 120_000 }); if (!prepared.prepared) { throw new Error('원본 구조 복사·노출 범위에 대한 사용자 승인이 필요합니다.'); } console.log(prepared.source, prepared.placement, prepared.materialChanges); ``` 비공개·초대 원본이면 구조 준비 전 `requiresSourceDisclosure:true`로 멈춥니다. 복사된 구조가 대상과 함께 공유될 수 있다는 점을 사용자가 승인한 경우에만 `acceptSourceDisclosure:true`를 넣어 다시 준비하세요. AI가 읽기 권한만으로 그 동의를 대신 수락하면 안 됩니다. 반환된 원본 리비전·digest, 실제 출력 격자, 접촉과 재료 매핑을 검토한 뒤 별도로 적용합니다. ```js // private 원본은 사용자 승인에 근거해 acceptSourceDisclosure:true도 명시합니다. const applied = await A.applyBonding({ token: prepared.token }); if (!applied.applied || !applied.undoable) throw new Error('Apply failed'); const computed = await A.computeBonding(applied.stepId, { timeoutMs: 120_000 }); if (!computed.computed || computed.computedUpTo !== applied.stepId) { throw new Error('Bonding calculation did not complete'); } // 적용하지 않기로 했다면 apply 대신 await A.cancelBonding({ token: prepared.token }); // 본딩 뒤 모듈(박막화, 후면 배선 등)은 appendFlow로 이어 붙입니다. // 원본에서 가져온 재료 ID는 (await A.getFlow()).materials에서 확인하세요. await A.appendFlow({ processes: [ { id: 'g-thin', kind: 'GROUPSTART', name: 'Backside thinning', note: '...' }, { id: 'thin-cmp', kind: 'CMP', /* ... */ note: '...' }, { id: 'g-thin-end', kind: 'GROUPEND' }, ] }, { expectedLastStepId: applied.lastStepId }); await A.computeTo('thin-cmp'); // 승인된 본딩은 그대로 유지되므로 resumeBonding이 필요 없음 ``` 준비는 대상 선택·문서·재료·계산 결과를 바꾸지 않고, 적용은 Undo 한 단계로 공정·재료·표시 설정을 함께 추가합니다. 계산과 저장은 별도입니다. 적용 직전 원본 접근·리비전·최종 구조와 대상 구조를 다시 확인하므로 원본이나 대상이 바뀌면 같은 토큰으로 강제 적용하지 말고 새로 준비하세요. 토큰은 하나만 유지하며 5분 후 또는 프로젝트 문맥 변경·취소 때 해제되고 적용 시도 한 번으로 소비됩니다. 초기 경로는 기존 XY/Z 격자를 유지하며 세분화·영역 확장·배열 반복·이름 병합은 거부합니다. 뒤집기·오프셋과 선택적 양면 평탄화만 지원하며 평탄화에는 대상에 등록된 padding 재료가 필요합니다. compact 입력 복사 각 16 MiB와 저장 구조 복원·격리 계산·검토 작업 각 64 MiB 등 [본딩 API 한도와 취소 범위](/docs/agents/api.md#본딩-전용-api)를 확인하세요. 이 한도는 UI 본딩의 일반 출력 정책이나 전체 탭 RAM 보장이 아닙니다. 큰 작업은 해상도를 임의로 바꾸지 말고 UI로 검토합니다. ## 저장본 재개와 최신 원본 갱신 프로젝트를 다시 열었거나 새 API 인스턴스라면 고정본을 먼저 재검증합니다. 이 작업은 선택·문서·재료를 바꾸지 않고 저장된 자산·매핑·배치를 격리 계산으로 확인합니다. 저장 flag나 임의 JSON을 계산 승인으로 사용하지 않습니다. `resumeBonding`은 지정 단계까지 앞선 활성 본딩도 함께 검증하므로, 반환된 `authorizedStepIds`가 실행 범위의 모든 활성 본딩을 포함하는지 확인하고 부족한 범위만 추가로 검증하세요. 아래는 본딩 한 개 뒤의 일반 공정까지 완료하는 흐름입니다. ```js if (!A.capabilities.bonding.resumePinned || !A.capabilities.bonding.computeTo) { throw new Error('Pinned continuation unavailable'); } const resumed = await A.resumeBonding({ stepId: 'bonding-1' }); if (!resumed.authorized || !resumed.authorizedStepIds?.includes('bonding-1')) { throw new Error('Pinned validation failed'); } // 예제 ID와 간격을 현재 프로젝트의 실제 최종 공정 ID·요청 해상도로 바꾸세요. const expectedFinalStepId = 'after-cmp'; const expectedGridNm = { x: 5, y: 5 }; const completed = await A.computeTo('final', { timeoutMs: 600_000 }); const { gridNm } = await A.status(); if (!completed.computed || completed.computedUpTo !== expectedFinalStepId || gridNm?.x !== expectedGridNm.x || gridNm?.y !== expectedGridNm.y) { throw new Error('Final step or requested grid did not match'); } // 필요한 구조 검사와 save()를 별도로 완료합니다. // 본딩 단계까지만 계산하려면 computeBonding('bonding-1')을 사용합니다. ``` 원본이 변경·삭제되었거나 접근할 수 없어도 대상에 포함된 유효한 고정본은 계산할 수 있습니다. 이 재개 과정에서 원본 조회나 private 복사 동의를 다시 요구하지 않습니다. `resumeBonding({ stepId, compareSource:true })`로 metadata 비교를 명시할 수 있으며 `sourceStatus: "unavailable"`은 원본 조회 불가 관측이지 고정본 손상의 증거가 아닙니다. 비교는 고정본을 갱신하지 않습니다. 최신 원본을 새로 복사하려는 경우에만 별도로 준비·검토·적용합니다. ```js if (!A.capabilities.bonding.updatePinned) throw new Error('Pinned update unavailable'); const update = await A.prepareBondingUpdate({ stepId: 'bonding-1' }); if (!update.prepared) throw new Error('새 원본 복사에 대한 사용자 승인이 필요합니다.'); console.log(update.previousSource, update.source, update.placement, update.materialChanges); // 검토 뒤 별도 실행. private 원본은 사용자 승인에 근거한 확인 인자도 필요합니다. await A.applyBonding({ token: update.token }); await A.computeBonding('bonding-1'); ``` 새 원본 복사에는 현재 읽기 권한과 private 공개 범위 승인이 다시 필요합니다. 갱신은 기존 공정 ID·이름·메모를 유지하고 고정 자산과 재료를 Undo 한 단계로 교체합니다. 취소·오류·원본/대상 변경으로 실패하면 이전 고정본은 유지됩니다. 갱신 계산, 필요한 단면·접촉·재료 확인, 계정 저장과 재열기 확인은 각각 별도 완료 조건입니다. ## 형상과 메모리의 실제 범위 v2는 맞지 않는 격자의 정수 세분화와 출력 영역 확장을 검토하는 경로가 있습니다. 같은 크기 영역에서도 오프셋이 가장자리를 넘으면 확장을 허용해야 하며 위치는 출력 격자에 맞춰집니다. 지원 범위를 넘는 격자 비율을 임의 보간하지 않습니다. X/Y 뒤집기 선택을 지원합니다. 저장값 `bondingFlipSource`와 `bondingFlipAxis: x/y/xy`의 조합은 방향과 Z 반전을 함께 결정하므로 “항상 Z만 반전” 또는 “xy도 단일 축과 같은 반전”으로 해석하지 마세요. 비평탄 접촉면의 높이 차이와 빈 column을 검사하고 선택한 배치·채움 규칙으로 합성합니다. 실제 Cu 열팽창, 접합 어닐, 기계적 응력이나 접합 수율을 계산하는 모델은 아닙니다. 현재 v2의 기본 출력 제한은 과거 경로의 256 MiB 고정값이 아닙니다. 주소 지정 가능한 배열 크기와 실제 할당 성공을 검사하며, 작업 typed-array 추정이 768 MiB를 넘으면 주의를 표시하는 경로가 있습니다. 이 값은 사용 가능한 RAM 측정이나 무제한 계산 보장이 아닙니다. 큰 영역·세분화·많은 층·채움 작업은 여전히 실패할 수 있으므로 출력 열 수와 층 용량, 추정 범위를 먼저 확인하세요. 기존 문서의 레거시 본딩 경로는 별도 호환 의미를 유지합니다. ## 실행 비교: 완료 흐름과 원본 갱신 아래 명령은 저장소 루트에서 설치된 Node.js와 프로젝트 의존성으로 실행합니다. 프로젝트·서비스 호출을 로컬 fixture로 대체하되 실제 원본 자산, 편집기, 합성 커널, 재료 매핑과 이력 경로를 사용합니다. 원격 읽기·쓰기와 브라우저 렌더 검증은 하지 않습니다. ```powershell npm run verify:bonding-workflow node dev/src/features/process/__tests__/bonding-source-update.verify.mjs node dev/src/features/engine/__tests__/bonding-contact-surfaces.verify.mjs ``` | 비교 | 확인하는 결과 | | --- | --- | | 저장 고정본 재개부터 최종 공정·검사·저장·재열기 | 첫 명령은 실제 API·코덱·History·Grid를 사용해 5nm 격자와 최종 구조를 대조하며, 계정 서비스 호출은 로컬 fixture로 확인 | | 기존 원본 vs 갱신 원본 | 이전 고정 자산을 보존한 채 새 원본·digest·재료를 적용. Undo 이력에는 이전 자산·재료 유지 | | 적용 vs 취소 | 적용은 이력 1회와 원본 변경, 취소는 공정·재료 무변경 | | 접근 불가·오래된 캐시 | 실패를 표시하고 기존 구조 유지 | | 비공개·초대 원본 | 안내 승인 전 배치 준비 금지; 취소 시 변경 없음 | | 평탄·단차·하부 빈 공간 | 선택 방향의 실제 접촉면 flat/relief/empty 판정 비교; 입력 배열 불변 | | Worker 할당 실패 | 의미 있는 메모리 오류를 반환하고 불완전 결과를 전송하지 않음 | 이 비교에서 PASS는 해당 고정 입력과 코드 경로의 계약을 검증한 결과입니다. 사용자의 제품 크기 구조가 같은 메모리에서 성공하거나 최종 화면과 실제 접합이 검증됐다는 뜻은 아닙니다. 근거: `AppFeatureFlags.js`, `InspectorController._editBondingV2`, `BondingAsset.js`, `BondingOrientation.js`, `WaferBondingV2.js`, `BondingMemory.js`, 위의 실행 검증 파일.