프로젝트 소개

A3S Cloud는 셀프 호스팅 방식의 Agent-first 개발자 플랫폼입니다. README에 따르면 제품 및 희망 상태(desired-state)의 진실원은 Cloud에 유지되며, 내구성이 필요한 작업은 A3S Flow가 조정하고, 라이프사이클 계약은 A3S Runtime이 정의하며, 실행은 A3S Box가 처리하고, A3S Gateway가 유일한 공개 엣지 역할을 수행합니다. 이 저장소는 MIT 라이선스를 따르며 Rust 1.88 이상, PostgreSQL 17 또는 호환 릴리스, A3S Box, 고정된 A3S Gateway 리비전, 그리고 프로덕션의 모든 Worker 또는 Relay 역할을 위한 NATS JetStream을 대상으로 합니다. Bun은 TypeScript 클라이언트 또는 CLI 개발 용도로만 나열되어 있습니다. 아키텍처는 모든 서비스에 대해 단일 경로를 따릅니다. Gateway와 Identity를 통해 공개 트래픽을 수용하고, A3S ORM을 통해 PostgreSQL에 희망 상태, 멱등성, 감사 증거 및 Outbox 팩트를 커밋하며, A3S Flow 및 Operations를 통해 내구성 있는 대기, 재시도, 재생, 승인, 보상 및 취소를 조정합니다. 이후 Box 상의 Runtime Task 또는 Service 유닛을 통해 Workloads 및 Fleet에서 배치 및 실행하며, Edge와 Gateway를 통해 버전 관리된 경로 스냅샷을 게시합니다. Cloud는 결코 보조 요청 바이트 프록시가 되지 않습니다. 여섯 가지 제품 결과물은 두 가지 실행 클래스를 공유합니다. AaaS는 대화, 실행, 이벤트, 승인, 체크포인트, 포크 및 제공자 바인딩을 다룹니다. WaaS는 온톨로지, 불변 정의 및 계획, WorkflowRun, HumanTask 및 유형화된 노드 순서를 다룹니다. FaaS는 불변의 Function 릴리스 프로필을 소유하며 호출을 Executions, Workloads 또는 Connectors에 위임합니다. Durable Cell는 사람과 여러 Agent를 위해 이름이 지정되고 직렬화 가능하며 하이버네이션(hibernatable)이 가능한 상태 공간을 제공합니다. Model Inference는 모델 리비전, 배포, 라우팅 정책, 사용량 및 평가를 소유하며, 독립적인 복제본과 멀티 노드 프리필/디코드 그룹을 갖습니다. Static Web은 Gateway에서 불변의 React, Vue 및 기타 승인된 릴리스를 직접 제공하며, SSR은 일반 Service 프로필로 처리됩니다. 일반적인 실행 클래스는 Task와 Service뿐입니다. 빠른 시작은 종속성을 위한 up과 분리된 제어 평면을 사용하며, /api/v1/health/live 및 /api/v1/health/ready에 상태 확인 엔드포인트가 있고, /api/v1/openapi.json에 OpenAPI 엔드포인트가 있으며, 서비스 프로세스 실행 전에 반드시 실행해야 하는 일회성 마이그레이터가 포함됩니다. Bootstrap은 첫 번째 Organization, 서비스 Principal, 소유자 Membership, API 토큰, 기본 플랫폼 역할 정책 및 PlatformOwner 바인딩을 생성합니다. 뮤테이션(Mutations)은 Bearer 인증과 멱등성 키를 사용합니다. CLI는 Bun으로 실행되며 자격 증명을 CLI 컨텍스트 파일이 아닌 환경 변수나 표준 입력에서 읽습니다. 프로덕션에서는 API를 A3S Gateway를 통해서만 게시합니다. README에 설명된 플랫폼 기능에는 호스팅된 Git 권한 및 외부 소스 리비전, 웹훅, 재현 가능한 Box 빌드, 프로비넌스(provenance), 풀 리퀘스트 미리보기, 불변 아티팩트 및 다이제스트 보존 프로모션이 포함됩니다. Supply는 Git, OCI Registry 및 A3S Use Registry 권한을 분리합니다. 실행 및 확장은 CPU 풀, GPU 풀, 가속기 및 토폴로지 제약, Claims, 안티-어피니티(anti-affinity), 갱 배치(gang placement), 유지보수, 쿼터 및 선점(preemption)을 위한 단일 이기종 스케줄러를 사용하며, 상태 없는 scale-to-zero와 상태 있는 드레인, 펜싱, 체크포인트 및 복구를 지원합니다. 저장 및 제공은 외부 S3 호환 스토리지 기반의 단일 유형 불변 객체 클라이언트, Gateway 소유의 TLS 및 라우팅, 그리고 로그, 메트릭, 트레이스, SLO 및 인시던트를 위한 OpenTelemetry를 사용합니다. 거버넌스는 테넌트 격리, 멤버십, Resource Grants, 쿼터, 자격 증명, 감사, Outbox, 라이프사이클 정리, 시스템 관리자 RBAC 평면, 단기 지원 권한 부여 및 워크로드 ID 리비전을 다룹니다. README에 따르면 A3S Cloud는 관리 대시보드를 제공하지 않습니다. 대신 애플리케이션과 Agent를 위한 불변의 React/Vue 및 기타 테넌트 웹 릴리스를 호스팅하며, 이는 다른 클라이언트와 동일한 Gateway 및 API를 사용합니다. 자동 CI 및 Box 적합성 검사는 릴리스로의 푸시 및 릴리스를 대상으로 하는 풀 리퀘스트에 대해서만 실행되며, main 브랜치는 이러한 워크플로우를 자동으로 시작하지 않습니다. 전달 상태는 백분율이 아닌 게이트(gate) 기반으로 결정됩니다. 2026-09-06 기준, README는 테넌트 범위의 Identity, PostgreSQL/A3S ORM, Operations/Flow, Outbox, 공개 API 및 마이그레이션을 Verified 기반으로 나열합니다. 설치 범위와 시스템 관리자 RBAC은 Verified 코어이며 더 넓은 게이트가 진행 중입니다. Workloads, Fleet, Runtime/Box, Gateway, supply, 협업 및 엔터프라이즈 제어는 진행 중이며, A0.4 실제 제공자 게이트가 검증되었습니다. Agent 및 호스팅 MCP 제품 라인은 진행 중이며 A0.4가 검증되었습니다. 온톨로지 워크플로우와 AI 애플리케이션/파일은 진행 중입니다. 자동화는 컴포넌트 기반이 진행 중입니다. Data/S0 및 Durable Cell은 기반 구축이 진행 중입니다. 워크로드 ID는 검증된 신뢰 및 WI2-C1/C2/C3a/C3b 기반을 갖추었으며, 플릿 하드웨어 증명 및 전체 발행은 아직 미결 상태입니다. FaaS, 분산 추론, 모델 공급, Static Web, Runtime CI/CD 및 전체 HA 운영은 계획 중이거나 초기 기반 단계입니다. 아키텍처 목표는 가용성 주장이 아니며, 기능은 ROADMAP.md에서 실제 제공자, 실패, 복구, 정리, 업그레이드 및 릴리스 게이트가 Verified로 표시된 후에만 릴리스됩니다.