# Datacollector_MAC Project Knowledge Overview

Date: 2026-05-03T11:52:56.124Z
Project: Datacollector_MAC
Repository: `/Volumes/Data/project/Antigravity/Datacollector_MAC`

## Purpose
Datacollector_MAC는 VS Code 안에서 로컬 AI 에이전트, Second Brain, 프로젝트 기록, 에이전트 스킬을 연결하는 개발 보조 프로젝트다.

## Confirmed Structure
- `src/agent.ts`: 에이전트 실행, 로컬 경로 프리플라이트, Second Brain Trace, 액션 실행 흐름의 중심.
- `src/sidebarProvider.ts`: Webview UI, 브레인/모델/프로젝트 선택, 프롬프트 전달, 기록 UI를 담당.
- `src/features/secondBrainTrace.ts`: Second Brain 검색 결과와 근거 정책을 구성.
- `src/features/projectChronicle/`: 프로젝트 기록을 Markdown으로 관리하는 Chronicle 기능.
- `src/core/`: 큐, 이벤트, 트랜잭션, 오류 처리 등 실행 안정성 계층.
- `tests/`: Second Brain, 로컬 경로 프리플라이트, Chronicle, 보안/트랜잭션 회귀 테스트.

## Evidence Files
- `package.json`
- `docs/records/Datacollector_MAC/README.md`
- `README.md`
- `src/App.tsx`
- `src/main.tsx`
- `src/components/AgentDashboard.tsx`
- `src/lib/api.ts`
- `src/lib/diagnostics.ts`
- `src/lib/engine.ts`
- `src/lib/gemini.ts`
- `src/lib/utils.ts`
- `src/store/agentStore.ts`

## Scanned Tree Excerpt
```text
docs/
  docs/records/
    docs/records/Datacollector_MAC/
      docs/records/Datacollector_MAC/bugs/
      docs/records/Datacollector_MAC/decisions/
      docs/records/Datacollector_MAC/development/
      docs/records/Datacollector_MAC/discussions/
      docs/records/Datacollector_MAC/planning/
      docs/records/Datacollector_MAC/retrospectives/
      docs/records/Datacollector_MAC/chronicle.config.json
      docs/records/Datacollector_MAC/project-profile.md
      docs/records/Datacollector_MAC/README.md
      docs/records/Datacollector_MAC/timeline.md
  docs/Autonomous-Polling-Wait-Automation.md
  docs/NotebookLM-Automated-Authentication-CLI.md
  docs/Ontology-Driven-Relevancy-Filtering.md
  docs/Robust-GitHub-Sync-Pipeline.md
  docs/Zustand-Based-Mission-Persistence.md
out_wiki/
  out_wiki/프레임워크별 실전 패턴.md
  out_wiki/Aspect-Oriented Programming (AOP).md
  out_wiki/bulk_process.py
  out_wiki/Clean Architecture.md
  out_wiki/Client Components.md
  out_wiki/Composition API.md
  out_wiki/Cross-Cutting Concerns.md
  out_wiki/Dependency Injection (DI).md
  out_wiki/Design Patterns (디자인 패턴).md
  out_wiki/Domain-Driven Design (DDD).md
  out_wiki/DTO (Data Transfer Object).md
  out_wiki/Hexagonal Architecture.md
  out_wiki/Hydration & Progressive Rendering.md
  out_wiki/JSI (JavaScript Interface).md
  out_wiki/Layered Architecture.md
  out_wiki/Microservices Architecture.md
  out_wiki/Middleware & Interceptors.md
  out_wiki/Next.js App Router.md
  out_wiki/React Suspense.md
  out_wiki/Server Components (RSC).md
  out_wiki/Server Side Rendering (SSR).md
  out_wiki/Spring Boot.md
  out_wiki/State Management Libraries.md
public/
  public/favicon.svg
scripts/
  scripts/mcp_bridge.mjs
  scripts/mcp_caller.py
  scripts/p_reinforce_wikify.py
  scripts/vite-backend-plugin.mjs
src/
  src/components/
    src/components/AgentDashboard.tsx
  src/lib/
    src/lib/api.ts
    src/lib/diagnostics.ts
    src/lib/engine.ts
    src/lib/gemini.ts
    src/lib/utils.ts
  src/store/
    src/store/agentStore.ts
  src/App.tsx
  src/index.css
  src/main.tsx
auth_mac.command
auth_win.bat
bridge.log
index.html
metadata.json
package-lock.json
package.json
README.md
run_app.bat
run_app.sh
run_mac.command
run_win.bat
src.zip
tsconfig.json
vite.config.ts
```

## Current Knowledge Gap
- 전체 아키텍처는 파일 구조와 일부 프리뷰 기준으로 파악 가능하지만, 세부 동작 지식은 `src/agent.ts`, `src/sidebarProvider.ts`, `secondBrainTrace.ts`, `projectChronicle` 순서로 심화 분석해 보강해야 한다.

## Next Records
- `agent.ts` 실행 흐름 상세 분석
- Second Brain Trace 검색 및 근거 정책 분석
- Project Chronicle 기록 생성 흐름 분석

## ✅ 검증 상태 및 신뢰도
-   **상태:** draft
-   **검증 단계:** conceptual
-   **출처 신뢰도:** A (자체 시스템 및 개발 기록 기반)
-   **중복 검사 결과:** 신규 생성

## 🔗 관련 문서 링크 (Related document links)

### 상위/유사 개념
- [[Datacollect Architecture]]
  - 연결 이유: 프로젝트의 핵심 아키텍처 및 시스템 기반.

### 구현/활용 도구
- [[P-Reinforce Engine]]
  - 연결 이유: 워크플로우 자동화 및 데이터 수집 엔진.

### 실무 적용 맥락 (Practical Application Contexts)
- **Operation / Maintenance:** Datacollect 파이프라인의 안정성 및 동기화 유지보수.

## 📝 변경 이력 (Change history)
- 2026-05-19: Initial draft generated via Datacollector P-Reinforce automation.
