Aggrega Wasm Mutator Socket 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 ID: https://aggrega.ai/schemas/wasm-mutator-v1beta1.schema.json
label-transform 역할에 연결된 거버넌스 플러그인이 소비하는(MutatorInput) 와이어 형태와 내보내는(MutatorOutput) 와이어 형태입니다. 이 역할은 토폴로지 구성 시점, 즉 그래프가 구축된 후 판정되기 전에 실행됩니다. 플러그인은 JSON Patch 문서를 반환하고, 호스트는 이를 노드 레이블에만 적용하며 그 밖의 어떤 것에도 적용하지 않습니다. 그래프의 다른 부분에 닿는 패치가 있으면 빌드를 중단합니다. Go, Rust, TypeScript 페이로드 타입은 이 스키마로부터 plugin-ABI 패키지에 생성되므로 세 언어는 하나의 와이어를 읽고 씁니다. 게스트는 이 타입을 해당 패키지에서, 또는 플러그인 키트가 다시 내보내는 경우 플러그인 키트를 통해 가져옵니다.
다음 형태 중 하나
MutatorInputMutatorOutput
정의
MutatorInput
호스트가 호출마다 mutator 플러그인에 전달하는 페이로드입니다. release 수준의 컴파일 컨텍스트와, 각 노드의 레이블 및 그 인스턴스가 선언하는 값을 담은 토폴로지 그래프의 투영으로 구성됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
compilation_context | CompilationContext | 예 | 빌드에 어떤 컴플라이언스, FinOps 또는 거버넌스 규칙이 적용되는지 결정할 때 mutator가 읽는 Release 수준의 메타데이터입니다. |
graph | MutatorGraph | 예 | mutator 플러그인에 노출되는 토폴로지 그래프의 투영입니다. 각 노드의 Component, 해석된 버전, 레이블, 그리고 그 인스턴스가 선언하는 값으로 구성됩니다. 전체 토폴로지 결과보다 의도적으로 범위가 좁습니다. mutator의 역할은 토폴로지 재구성이 아니라 레이블 지정이므로 엣지와 feature 페이로드는 노출되지 않습니다. 값은 읽기 위해 포함되므로 개발자가 선언한 구성이 레이블을 결정할 수 있습니다. 패치는 레이블에만 닿고 그 밖의 어떤 것에도 닿지 않으므로 플러그인은 값을 변경할 수 없습니다. |
sources | MutatorSource[] | 아니요 | 호스트가 읽어 플러그인에 그대로 전달하는 정의 파일로, 경로순으로 정렬된 목록입니다. 호스트는 바이트를 불투명한 내용으로 읽으며 파싱하지 않습니다. 연결이 소스를 선언하지 않으면 없습니다. |
settings | object | 아니요 | 호스트가 플러그인에 그대로 전달하는 자유 형식 설정 객체입니다. 호스트는 그 내용을 파싱하거나 그에 따라 동작하지 않습니다. 연결이 설정을 선언하지 않으면 없습니다. |
추가 속성은 허용되지 않습니다.
MutatorOutput
mutator 플러그인이 내보내는 응답 형태로, 호스트가 토폴로지 그래프에 적용하는 불투명한 JSON Patch 문서의 목록입니다. 게스트가 이미 구현한 JSON Patch 파서를 호스트가 중복 구현할 필요가 없도록 패치는 스키마 계층에서 불투명하게 유지됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
patches | any[] | 예 | 토폴로지 그래프에 순서대로 적용할 불투명한 JSON Patch 문서입니다. |
error | string | 아니요 | 게스트가 실행되었지만 작업을 완료하지 못했을 때 설정되는 실패 메시지이며, 성공 시에는 없습니다. 호스트는 존재하는 error를 실패한 플러그인 호출로 표시합니다. |
추가 속성은 허용되지 않습니다.
CompilationContext
빌드에 어떤 컴플라이언스, FinOps 또는 거버넌스 규칙이 적용되는지 결정할 때 mutator가 읽는 Release 수준의 메타데이터입니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
release_name | string | 예 | Release의 metadata.name입니다. |
environment | string | 예 | Release가 실행되는 환경 레이블입니다(예: dev, staging, prod). |
추가 속성은 허용되지 않습니다.
MutatorGraph
mutator 플러그인에 노출되는 토폴로지 그래프의 투영입니다. 각 노드의 Component, 해석된 버전, 레이블, 그리고 그 인스턴스가 선언하는 값으로 구성됩니다. 전체 토폴로지 결과보다 의도적으로 범위가 좁습니다. mutator의 역할은 토폴로지 재구성이 아니라 레이블 지정이므로 엣지와 feature 페이로드는 노출되지 않습니다. 값은 읽기 위해 포함되므로 개발자가 선언한 구성이 레이블을 결정할 수 있습니다. 패치는 레이블에만 닿고 그 밖의 어떤 것에도 닿지 않으므로 플러그인은 값을 변경할 수 없습니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
nodes | MutatorNode 맵 | 예 | 절대 노드 ID를 키로 하는 노드입니다. |
추가 속성은 허용되지 않습니다.
MutatorNode
mutator 플러그인이 규칙을 평가하는 대상인 노드별 투영입니다. 노드가 구현하는 Component, 해석된 해당 Component의 버전, 노드가 가진 레이블, 그리고 그 인스턴스가 선언하는 값으로 구성됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
component | string | 예 | 노드가 인스턴스화하는 기반 Component의 이름입니다. |
resolved_version | string | 예 | 리졸버가 이 노드에 고정한 Component의 정확한 Semantic Version입니다. |
labels | string 맵 | 예 | 노드의 덕 타이핑 및 온톨로지 레이블입니다. |
values | object | 아니요 | 노드의 컴포넌트 인스턴스가 Aggregate에서 선언하는 값으로, 작성자가 쓴 키 그대로 작성자의 순서대로 담깁니다. Aggregate의 모든 템플릿은 이미 파라미터에 대해 평가되었으므로, 파라미터로 끌어올린 값은 Release가 제공한 값 또는 파라미터의 기본값으로 도착합니다. 여기에는 인스턴스 자신의 값만 있습니다. Component의 스키마가 선언하는 기본값이나 Recipe 또는 Feature가 기여하는 것은 포함되지 않습니다. Component가 민감하다고 선언한 값은 전체 그래프에 대한 거버넌스 판정이 받는 것과 정확히 같이 가려진 상태로 도착합니다. 그 자리에는 해당 판정이 담는 것과 같은 단일 키의 가림 표시 객체가 놓이며, 선언된 이유를 명시합니다. 어떤 선언도 닿지 않는 형제 값은 쓰인 그대로 도착합니다. 플러그인은 이 값을 읽어 어떤 레이블을 추가할지 결정합니다. 패치는 이 값에 닿을 수 없습니다. 인스턴스가 값을 선언하지 않으면 없습니다. |
추가 속성은 허용되지 않습니다.
MutatorSource
플러그인에 전달되는 정의 파일 하나입니다. 기본 이름 경로와 파일 내용으로 구성됩니다. 둘 다 그대로 전달되며, 호스트는 내용을 파싱하지 않습니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
path | string | 예 | 소스 파일의 기본 이름입니다. 호스트는 절대 호스트 경로가 아닌 기본 이름만 제공하므로 와이어는 이식 가능하고 결정론적입니다. |
content | string | 예 | 불투명한 string으로 그대로 전달되는 소스 파일의 내용입니다. |
추가 속성은 허용되지 않습니다.