Single Model Orchestrator (SMO)

Codex 중심 단일 모델로 멀티 역할 오케스트레이션을 수행하는 TypeScript 라이브러리 + CLI입니다.

설치

전역 설치:

npm i -g @supercogent/single-model-orchestrator
smo role list

일회성 실행:

npx @supercogent/single-model-orchestrator role list

소스 개발:

npm install
npm run build
node dist/cli.js role list

기본 설정 파일

• 기본 경로: config/agent.config.json
• 없으면 CLI가 자동 생성합니다.

검증:

smo config validate

핵심 커맨드

# 워크플로우 선택 실행
smo start codex

# 동기 역할 실행
smo role run main_orchestrator "로그인 버그 수정" . codex

# 비동기 역할 제출/처리
smo role submit docs_research "OAuth 공식 문서 확인" . codex
smo role worker codex config/agent.config.json .smo/jobs 5

역할 (기본)

1. main_orchestrator (Sync, Read+Write)
2. architecture_debug (Sync, Read Only)
3. docs_research (Async, Read Only)
4. codebase_explorer (Async, Read Only, 기본 비활성)
5. frontend_dev (Async, Read+Write)
6. docs_writer (Async, Read+Write)
7. multimodal_analyst (Async, Read Only)

파일 기반 커스텀 포인트

config/agent.config.json에서 직접 수정:

• agent.enabledRoles
• agent.rolePrompts
• codex.model/profile/command
• orchestrator.defaultBudget
• openai.roleSettings

Codex + OpenAI fallback

Codex 실패/한도 시 OpenAI fallback 허용:

set SMO_ALLOW_PAID_FALLBACK=true
smo role run architecture_debug "원인 분석" . codex+openai

주의: fallback 활성화 시 API 비용이 발생할 수 있습니다.

npm 배포 (메인테이너)

npm run typecheck
npm run build
npm run bench:gate
npm run pack:dry
npm run release:notes
npm run release:prepare
npm publish --access public

버전 컷 자동화:

npm run release:cut -- patch

문서

• docs/roles.md
• docs/integration.md
• docs/distribution.md
• docs/release.md
• docs/architecture.md
• docs/benchmark.md
• docs/mvp-spec.md
• docs/one-week-plan.md