docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거
Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를 Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류. - 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로 자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거, 동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거. - 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming, Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business, Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로, 나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는 title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백). 원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지. - 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서. - 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는 지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지. - Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경. - 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
This commit is contained in:
Antigravity Agent
@@ -0,0 +1,135 @@
|
||||
---
|
||||
id: wiki-2026-0508-orinoco-프로젝트
|
||||
title: Orinoco 프로젝트
|
||||
category: 10_Wiki/Topics
|
||||
status: verified
|
||||
canonical_id: self
|
||||
aliases: [Orinoco, V8 Orinoco]
|
||||
duplicate_of: none
|
||||
source_trust_level: A
|
||||
confidence_score: 0.9
|
||||
verification_status: applied
|
||||
tags: [v8, gc, performance]
|
||||
raw_sources: []
|
||||
last_reinforced: 2026-05-10
|
||||
github_commit: pending
|
||||
tech_stack:
|
||||
language: C++
|
||||
framework: V8 12+
|
||||
---
|
||||
|
||||
# Orinoco 프로젝트
|
||||
|
||||
## 매 한 줄
|
||||
> **"매 V8 의 GC 의 mostly-parallel, mostly-concurrent 의 evolution"**. 2016 발표된 Orinoco initiative 가 V8 의 stop-the-world phase 를 minimize — incremental marking, parallel scavenge, concurrent sweeping, compaction 의 background offload. 2026 현재 V8 12+ 의 default. Main thread pause time 이 100ms+ → sub-10ms 로 reduce.
|
||||
|
||||
## 매 핵심
|
||||
|
||||
### 매 design pillars
|
||||
- **Parallelism**: 동시 main thread 를 멈추고 worker thread 다수 사용 (parallel scavenge, parallel compaction).
|
||||
- **Concurrency**: main thread 는 mutator 의 user code 실행, GC thread 가 background marking/sweeping.
|
||||
- **Incremental**: long pause 를 작은 step 으로 split, frame 사이 의 짤끔.
|
||||
- **Idle-time GC**: main thread idle window (rAF gap) 의 활용.
|
||||
|
||||
### 매 collector phases
|
||||
- **Young (Scavenger)**: parallel copying, 보통 <1ms.
|
||||
- **Old marking**: incremental + concurrent (mutator 동시 실행).
|
||||
- **Old sweeping**: concurrent free-list rebuild.
|
||||
- **Old compaction**: parallel evacuation, 매 page-level.
|
||||
- **Write barrier**: 매 mutator 가 mark 와 race 의 prevent.
|
||||
|
||||
### 매 응용
|
||||
1. Chrome / Edge / Brave (V8 host).
|
||||
2. Node.js / Deno / Bun (runtime GC 의 같은 Orinoco 기반, Bun 은 JSC 라 다름).
|
||||
3. Electron, VS Code (V8 backend).
|
||||
|
||||
## 💻 패턴
|
||||
|
||||
### Orinoco trace 보기
|
||||
```bash
|
||||
node --trace-gc --trace-gc-verbose app.js
|
||||
# [Mark-Compact (incremental) ...]
|
||||
# [Scavenge (parallel) ...]
|
||||
```
|
||||
|
||||
### Heap stats with v8 module
|
||||
```javascript
|
||||
const v8 = require('v8')
|
||||
const stats = v8.getHeapStatistics()
|
||||
console.log({
|
||||
used: stats.used_heap_size,
|
||||
total: stats.total_heap_size,
|
||||
limit: stats.heap_size_limit,
|
||||
})
|
||||
const spaces = v8.getHeapSpaceStatistics()
|
||||
spaces.forEach(s => console.log(s.space_name, s.space_used_size))
|
||||
```
|
||||
|
||||
### Triggering Orinoco-friendly allocation
|
||||
```javascript
|
||||
// O — short-lived 의 young space 에 머무름
|
||||
function processBatch(items) {
|
||||
return items.map(i => ({ id: i.id, val: i.val * 2 })) // returns die fast
|
||||
}
|
||||
|
||||
// X — large pre-allocated buffer 의 old promotion 강제
|
||||
const giant = new Array(1e7).fill(0) // bypasses young entirely
|
||||
```
|
||||
|
||||
### --max-old-space-size tuning
|
||||
```bash
|
||||
node --max-old-space-size=4096 app.js # 4GB old space ceiling
|
||||
```
|
||||
|
||||
### Idle-time GC hint
|
||||
```javascript
|
||||
// Chrome internal — webpages cannot directly trigger,
|
||||
// but rAF-aligned work 의 GC 가 idle gap 을 활용
|
||||
requestIdleCallback((deadline) => {
|
||||
while (deadline.timeRemaining() > 0 && tasks.length) doWork(tasks.pop())
|
||||
})
|
||||
```
|
||||
|
||||
### Heap snapshot diff
|
||||
```javascript
|
||||
const v8 = require('v8'); const fs = require('fs')
|
||||
v8.writeHeapSnapshot('before.heapsnapshot')
|
||||
runWorkload()
|
||||
v8.writeHeapSnapshot('after.heapsnapshot')
|
||||
// Chrome DevTools → Memory → Comparison
|
||||
```
|
||||
|
||||
## 매 결정 기준
|
||||
| 상황 | Approach |
|
||||
|---|---|
|
||||
| Browser frame budget (16.6ms) | Orinoco 의 default 충분 |
|
||||
| Large heap (4GB+) | --max-old-space-size + monitoring |
|
||||
| Latency-critical (game, RT) | Object pool + young-friendly allocation |
|
||||
| Server long-running | --gc-interval + heap dump 주기 |
|
||||
|
||||
**기본값**: 매 V8 default Orinoco + workload 의 short-lived bias.
|
||||
|
||||
## 🔗 Graph
|
||||
- 부모: [[V8 엔진 힙 아키텍처]]
|
||||
- 변형: [[Orinoco 가비지 컬렉터]]
|
||||
- 응용: [[Incremental_Marking|Incremental Marking]] · [[Mark-Sweep-Compact 알고리즘]]
|
||||
- Adjacent: [[Garbage Collection|Generational Hypothesis]] · [[Old_Space|Old Space]] · [[Write Barrier]]
|
||||
|
||||
## 🤖 LLM 활용
|
||||
**언제**: V8 GC 의 internals 설명, Node.js / Chrome heap tuning, `--trace-gc` 분석.
|
||||
**언제 X**: 다른 engine (JSC, SpiderMonkey, Hermes) 의 GC.
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **`global.gc()` 강제**: 매 production 의 X. Orinoco 가 의 better job 의 함.
|
||||
- **--expose-gc 의 production**: 매 attack surface 와 perf degradation.
|
||||
- **Heavy sync work**: incremental marking 의 main thread 가 idle 해야 진행 → tight loop 의 GC 의 starve.
|
||||
|
||||
## 🧪 검증 / 중복
|
||||
- Verified (V8 blog "Orinoco" 2016, "Concurrent marking" 2017, V8 12.x release notes).
|
||||
- 신뢰도 A.
|
||||
|
||||
## 🕓 Changelog
|
||||
| 날짜 | 변경 |
|
||||
|---|---|
|
||||
| 2026-05-08 | Phase 1 |
|
||||
| 2026-05-10 | Manual cleanup — Orinoco design pillars + tracing patterns |
|
||||
Reference in New Issue
Block a user