maestro-coding/.env.example at main · redsunjin/maestro-coding · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
# Maestro Coding — 환경변수 예시
# 이 파일을 복사하여 .env 파일을 만들고 실제 값으로 채워주세요.
# cp .env.example .env
#
# ⚠️ 실제 .env 파일은 절대 Git에 커밋하지 마세요!

# 프로젝트 표시 이름 (선택)
MAESTRO_PROJECT_NAME=my-main-repo

# 현재 프로젝트 승인 레인 수 (기본 4, 최소 1, 최대 8)
MAESTRO_PROJECT_LANE_COUNT=4

# git merge / git reset을 실행할 메인 레포지토리의 로컬 경로 (필수 권장)
MAIN_REPO_PATH=/path/to/your/main/repo

# 서버 리스닝 포트 (기본: 8080)
PORT=8080

# 서버 바인딩 호스트 (기본: 127.0.0.1)
# 외부 접근이 필요하지 않다면 기본값 유지 권장
HOST=127.0.0.1

# 허용 Origin 목록 (쉼표 구분)
# 기본값: 로컬 Vite 개발/프리뷰 Origin
# 예시: http://localhost:5173,http://127.0.0.1:5173
ALLOWED_ORIGINS=http://localhost:5173,http://127.0.0.1:5173,http://localhost:4173,http://127.0.0.1:4173

# 인증 토큰 — 설정 시 요청에 Authorization: Bearer <token> 헤더 필요
# 빈 값으로 두면 인증 없이 동작합니다.
MAESTRO_SERVER_TOKEN=your-secret-token-here

# 프론트엔드가 연결할 WebSocket 주소 (기본: ws://localhost:8080)
VITE_WS_URL=ws://localhost:8080

# 조건부 자동승인 (기본 OFF)
# true/false, 1/0, on/off
MAESTRO_AUTO_APPROVE_ENABLED=false

# 자동승인 허용 agentId 목록 (쉼표 구분, 빈 값이면 모든 agent 허용)
MAESTRO_AUTO_APPROVE_TRUSTED_AGENTS=

# 자동승인 허용 브랜치 접두사 (예: feature/auto/)
# 빈 값이면 접두사 제한 없음
MAESTRO_AUTO_APPROVE_BRANCH_PREFIX=

# 자동승인 허용 diffSummary.shortDescription 최대 길이
MAESTRO_AUTO_APPROVE_MAX_DESC_LENGTH=180

# true면 요청 본문에 autoApprove=true가 명시된 경우에만 자동승인 시도
MAESTRO_AUTO_APPROVE_REQUIRE_EXPLICIT=false

# 자동승인 시도 간 최소 간격(ms). 0이면 비활성
MAESTRO_AUTO_APPROVE_COOLDOWN_MS=0

# true면 정책 매칭/이벤트만 수행하고 실제 git merge는 실행하지 않음
MAESTRO_AUTO_APPROVE_DRY_RUN=false

# 자동승인 정책/실행 이벤트 로그 최대 저장 개수 (기본 500, 최소 50, 최대 5000)
MAESTRO_AUTO_APPROVE_LOG_MAX_ITEMS=500

# 승인 이력 링버퍼 최대 저장 개수 (기본 300, 최소 40, 최대 2000)
MAESTRO_HISTORY_MAX_ITEMS=300

# 승인 이력 영속 저장 파일 경로 (기본: .maestro-history.json)
MAESTRO_HISTORY_STORE_PATH=.maestro-history.json

# Work Console / Work Session / Work Request 영속 저장 파일 경로 (기본: .maestro-workflows.json)
MAESTRO_WORKFLOW_STORE_PATH=.maestro-workflows.json

# VU-001 Work Request Intake (Phase A) 기능 플래그 (기본 OFF)
# true면 대시보드 헤더에 Requests 토글과 작업 요청 API(/api/work-requests)가 노출됩니다.
MAESTRO_WORKFLOW_ENABLED=false

# 에이전트 레지스트리 + 승인 요청/결정 영속 저장 파일 경로 (기본: .maestro-agents.json)
# 서버 재시작 후 연결된 에이전트와 pull 대기 중인 승인 결정을 복구합니다.
MAESTRO_AGENT_STORE_PATH=.maestro-agents.json

# Per-agent 인증 엄격 모드 (기본 false = 관대)
# MAESTRO_SERVER_TOKEN 설정 시: 에이전트 등록(register) 응답으로 per-agent 토큰이
# 1회 발급되며(서버는 sha256 해시만 저장), 에이전트 운영 엔드포인트(heartbeat/
# approval-requests/decision/ack)는 그 토큰으로 호출합니다.
# - false(관대): 에이전트 토큰이 없는 레거시 에이전트는 서버 토큰으로도 통과(grace).
#   단, grace 경로에는 agentId 일치 검증이 적용되지 않습니다.
# - true(엄격): 에이전트 엔드포인트는 반드시 유효한 per-agent 토큰을 요구합니다.
# 주의: 같은 agentId로 재등록하면 토큰이 무조건 회전되어 기존 토큰은 즉시 무효화됩니다.
MAESTRO_AGENT_AUTH_ENFORCE=false