open-index/open-npm huggingface dataset:
npm package: @supercogent/single-model-orchestrator
Description: Single-model multi-role orchestration engine for coding tasks
Latest version: 0.1.6

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

## 설치
전역 설치:
```bash
npm i -g @supercogent/single-model-orchestrator
smo role list
```

일회성 실행:
```bash
npx @supercogent/single-model-orchestrator role list
```

소스 개발:
```bash
npm install
npm run build
node dist/cli.js role list
```

## 기본 설정 파일
- 기본 경로: `config/agent.config.json`
- 없으면 CLI가 자동 생성합니다.

검증:
```bash
smo config validate
```

## 핵심 커맨드
```bash
# 워크플로우 선택 실행
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 허용:
```bash
set SMO_ALLOW_PAID_FALLBACK=true
smo role run architecture_debug "원인 분석" . codex+openai
```

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

## npm 배포 (메인테이너)
```bash
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
```

버전 컷 자동화:
```bash
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`