개발 현황 - Algora

이 파일은 세션 간 개발 연속성을 위해 현재 개발 진행 상황을 추적합니다.

최종 업데이트: 2026-02-01 현재 버전: 0.13.1 프로덕션 URL: https://algora.moss.land

현재 단계: Algora v2.0 업그레이드 - Agentic Governance OS

v2.0 업그레이드 계획

전체 업그레이드 계획은 docs/algora-v2-upgrade-plan.ko.md를 참조하세요.

Phase 1: Safe Autonomy 기반 (완료)

@algora/safe-autonomy 패키지 생성
Risk Classifier - 작업 리스크 분류 (LOW/MID/HIGH)
Lock Manager - 위험 작업 LOCK/UNLOCK 메커니즘
Approval Router - Director 3 우선 인간 검토 라우팅
Passive Consensus - 자동 승인 타임아웃 Opt-out 승인 모델
Retry Handler - 지수 백오프 재시도
Safe Autonomy 계층 전체 TypeScript 타입
개발용 In-memory 스토리지 구현

Phase 2: Orchestrator + 상태 머신 (완료)

@algora/orchestrator 패키지 생성
Primary Orchestrator 클래스 - 거버넌스 워크플로 중앙 조정자
워크플로 상태 머신 - 12개 상태 (INTAKE → OUTCOME_PROOF)
TODO Manager - 지수 백오프 포함 지속적 작업 관리
Specialist Manager - 품질 게이트 포함 서브에이전트 조정
워크플로, 이슈, 스페셜리스트 전체 TypeScript 타입
워크플로 모니터링용 이벤트 시스템
개발용 In-memory 스토리지 구현

Phase 3: Document Registry (완료)

@algora/document-registry 패키지 생성
Document Manager - 15개 공식 문서 유형 CRUD 작업
Version Manager - 시맨틱 버전 관리, 차이점 추적, 브랜치
Provenance Manager - 출처 추적, 에이전트 기여, 무결성 증명
Audit Manager - 불변 감사 추적, 규정 준수 보고
문서, 버전, 출처, 감사 전체 TypeScript 타입
문서 상태 머신 (draft → pending_review → in_review → approved → published)
개발용 In-memory 스토리지 구현

Phase 4: Model Router (완료)

@algora/model-router 패키지 생성
Model Registry - 헬스 체크 포함 모델 관리
Task Difficulty Classifier - 5단계 난이도 분류 (trivial → critical)
Model Router - 폴백 포함 지능형 작업-모델 라우팅
Quality Gate - 커스텀 검증기 포함 출력 검증
Embedding Service - 캐싱 포함 RAG용 텍스트 임베딩
Reranker Service - 검색 품질 향상을 위한 문서 재순위
Tier 1 (로컬) 및 Tier 2 (외부) 기본 모델 라인업
일일 한도 및 경고 포함 예산 관리

Phase 5: Dual-House Governance (완료)

Phase 6: Governance OS 통합 (완료)

Phase 7: 워크플로 구현 및 API 통합 (완료)

Step 1: API 통합 (완료)

apps/api 통합을 위한 GovernanceOSBridge 서비스
Governance OS REST API 엔드포인트:
- 파이프라인 엔드포인트: /governance-os/pipeline/run, /governance-os/pipeline/issue/:id
- 문서 엔드포인트: /governance-os/documents, /governance-os/documents/:id, /governance-os/documents/type/:type
- 투표 엔드포인트: /governance-os/voting, /governance-os/voting/:id, /governance-os/voting/:id/vote
- 승인 엔드포인트: /governance-os/approvals, /governance-os/approvals/:id/approve
- 리스크/잠금 엔드포인트: /governance-os/risk/classify, /governance-os/locks/:id
- 모델 라우터 엔드포인트: /governance-os/model-router/execute
- 통계/헬스 엔드포인트: /governance-os/stats, /governance-os/health, /governance-os/config

Step 2: 워크플로 핸들러 (완료)

전체 Orchestrator 테스트: 96개 통과

Phase 8: 프론트엔드 UI 통합 및 v2.0 완료 (완료)

Phase 11: Shadcn UI 통합 및 모바일 반응형 (완료)

Phase 9: 프로덕션 배포 (완료)

Phase 9.5: 시스템 개선 (완료)

이전 단계: 토큰 통합 (v0.8.0) - 완료

완료된 기능

인프라 (100%)

모노레포 설정 (pnpm workspaces + Turborepo)
TypeScript 설정
ESLint + Prettier 설정
환경 변수 템플릿 (.env.example)
Git 저장소 초기화

백엔드 - apps/api (100%)

프론트엔드 - apps/web (100%)

에이전트 시스템 (100%)

신호 수집 (100%)

이슈 탐지 (100%)

휴먼 거버넌스 (100%)

결과 증명 (100%)

토큰 통합 (100%)

공유 패키지

문서화 (100%)

README.md / README.ko.md
ARCHITECTURE.md / ARCHITECTURE.ko.md
CONTRIBUTING.md / CONTRIBUTING.ko.md
ALGORA_PROJECT_SPEC.md / ALGORA_PROJECT_SPEC.ko.md
USER_GUIDE.md / USER_GUIDE.ko.md
CLAUDE.md
CHANGELOG.md
DEVELOPMENT_STATUS.md (이 파일)

Phase 10: 토큰 UI 및 거버넌스 기능 (진행 중)

Step 1: 지갑 연결 UI (완료)

MetaMask/WalletConnect/Coinbase 지원 WalletConnect v2 모달
잔액과 주소를 표시하는 ConnectedWallet 헤더 컴포넌트
지갑 검증 플로우가 있는 프로필 페이지
실시간 업데이트가 되는 MOC 토큰 잔액 표시
토큰 잔액에서 투표권 계산
지갑 UI i18n 번역 (EN/KO)

Step 2: 트레저리 대시보드 개선 (완료)

Step 3: 투표권 위임 UI (완료)

Step 4: 토큰 가중 투표 UI (대기)

연결된 지갑으로 제안 투표
투표권 표시와 함께 투표 확인
위임된 투표 자동 적용
프로필 페이지에 투표 이력

Phase 10.6: 운영 데이터 분석 및 개선 (완료)

13일간의 프로덕션 데이터 기준 (2026-01-09 ~ 2026-01-21):

데이터 분석 결과

activity_log: 129,974 레코드 (~10,000/일)
agent_chatter: 32,900 레코드 (~2,500/일)
agora_messages: 21,983 레코드 (~1,700/일)
signals: 14,935 레코드 (~1,150/일)
데이터베이스 크기: 141MB (정리 없이 연간 ~4GB 예상)

LLM 비용 추적 (P0) - 완료

apps/api/src/index.ts에 generation 이벤트 리스너 추가
모든 LLM 호출을 budget_usage 테이블에 기록
provider, tier, 토큰, 예상 비용 추적
provider/tier/date/hour 기준 집계를 위한 Upsert 패턴

Ollama 타임아웃 최적화 (P0) - 완료

qwen2.5:32b 같은 대형 모델을 위해 타임아웃을 60초에서 120초로 증가
하이브리드 모델 전략 검증:
- Chatter는 complexity: 'fast' 사용 → llama3.2:3b
- Agora는 complexity: 'balanced' 사용 → qwen2.5:32b

데이터 보존 서비스 (P1) - 완료

새 서비스: apps/api/src/services/data-retention.ts
표준 30일 보존 정책:
- activity_log: 30일 (HEARTBEAT: 7일)
- agent_chatter: 90일
- signals: 90일
- agora_messages, issues, proposals, votes: 영구 (거버넌스 기록)
- budget_usage: 365일
스케줄러 통합 (매일 03:00)
triggerDataCleanup()으로 수동 정리 트리거

모니터링 API 확장 (P2) - 완료

GET /api/stats/llm-usage - tier/provider별 LLM 사용량, Tier 1 비율, 비용
GET /api/stats/data-growth - 행 수, 일일 평균, 성장 추세
GET /api/stats/system-health - 헬스 점수, 오류 수, 예산 상태

다음 단계 (우선순위 순)

Phase 10 나머지

제안의 토큰 가중 투표 UI
토큰 이벤트를 위한 실시간 WebSocket 통합

Phase 11: 프로덕션 강화

메인넷 컨트랙트 통합
보안 감사
성능 최적화
모니터링 및 알림 (pm2 monit, 로그 로테이션)

Phase 12: 고급 기능

packages/reality-oracle - 신호 수집 리팩토링
packages/inference-mining - 이슈 탐지 리팩토링
packages/agentic-consensus - 에이전트 시스템 리팩토링
packages/human-governance - 투표 리팩토링
packages/proof-of-outcome - 결과 추적 리팩토링

프로젝트 실행

개발 모드

# 의존성 설치
pnpm install

# 프론트엔드와 백엔드 동시 실행
pnpm dev

# 또는 개별 실행:
cd apps/api && pnpm dev   # 백엔드 :3201
cd apps/web && pnpm dev   # 프론트엔드 :3200

프로덕션 모드 (pm2)

# 모든 패키지 빌드
pnpm build

# pm2로 시작
pm2 start ecosystem.config.cjs

# 관리 명령어
pm2 status              # 상태 확인
pm2 logs algora-api     # API 로그
pm2 logs algora-web     # 웹 로그
pm2 restart all         # 전체 재시작
pm2 stop all            # 전체 중지

# 재부팅 시 자동 시작
pm2 save
pm2 startup

프로덕션 URL

프로덕션: https://algora.moss.land
로컬 개발: http://localhost:3200 (web), http://localhost:3201 (api)

Git 커밋 히스토리 (최근)

568ec18 feat: Add voting delegation UI with stats, list, and modal components
0461d1c feat: Enhance Treasury Dashboard with visualization and components
9475650 feat: Implement wallet connection UI with MOC token display and verification
3086f08 docs: Update USER_GUIDE.md and USER_GUIDE.ko.md with v2.0 features
2568ccd feat: Add production deployment with pm2 and nginx reverse proxy
bafeae9 test: Add comprehensive tests for v2.0 packages and fix exports

알려진 이슈

Next.js 14.1.0이 구버전임 (경미한 경고)
서버 재시작 시 에이전트 상태가 유지되지 않음 (초기화 필요)
스키마 변경 후 데이터베이스 재초기화 필요 (algora.db 삭제 후 db:init 실행)
프로덕션 API 연결 시 localhost CORS 이슈 (예상된 동작)

환경 설정 참고

Node.js v20.19.6
pnpm (모노레포용)
SQLite 데이터베이스: apps/api/data/algora.db
첫 실행 시 데이터베이스 자동 초기화
Tier 1 LLM을 위해 Ollama 필요 (http://localhost:11434)

AI 어시스턴트를 위한 안내

개발 계속 시:

이 파일을 먼저 읽어 현재 상태 파악
CLAUDE.md에서 프로젝트 컨텍스트와 가이드라인 확인
git log --oneline -10으로 최근 변경사항 확인
pnpm dev로 개발 서버 시작 (또는 프로덕션에서는 pm2 start ecosystem.config.cjs)
중요한 변경 후 이 파일과 CHANGELOG.md 업데이트
문서 변경 시 한국어 번역 (*.ko.md) 업데이트

알아야 할 주요 파일

ecosystem.config.cjs - pm2 설정
apps/web/src/middleware.ts - Next.js i18n 미들웨어 (_next 경로 제외)
apps/web/.env.local - 프론트엔드 환경 (NEXT_PUBLIC_API_URL)
apps/api/.env - 백엔드 환경

현재 아키텍처

인터넷 → algora.moss.land (DNS)
       → Lightsail 13.209.131.190 (nginx + SSL)
       → 로컬 211.196.73.206 (pm2: api:3201, web:3200)

Uh oh!

FilesExpand file tree

DEVELOPMENT_STATUS.ko.md

Latest commit

History