시맨틱 파이프라인

시맨틱 파이프라인은 계약으로 정의한 데이터가 Guida 안에서 이동하는 방식을 설명합니다. 데이터 원본 또는 추출기를 검증 게이트, 매퍼, 대상에 연결하고 실제 실행 전에 제안된 작업을 검토할 수 있게 합니다.

파이프라인은 워크플로 폴더, 워커 풀 또는 무인 스케줄러가 아닙니다. 워크플로는 운영 범위를 활성화하고, 프로세스는 큐를 소비하며, 워크플로 원장은 실행과 항목의 영구 기록을 보관합니다. 파이프라인은 명시적인 출처 정보로 이러한 영역을 연결합니다.

단계 모델

단계	책임
Source	입력 형식 또는 스키마 선언
Extractor	이름으로 지정한 추출기 계약 실행
Validator	스키마와 항목별 제한 규칙 적용
Mapper	선언된 계약을 다른 계약으로 변환
Destination	큐 또는 지원되는 다른 대상 지정

검증 게이트, 매퍼, 대상은 각각 재사용 가능한 카탈로그입니다. 데이터 형식과 운영 규칙을 개별 스크립트 안에 숨기지 않아도 됩니다.

{
  "id": "careers.example.discovery-to-fetch",
  "workflowName": "careers-crawl",
  "status": "draft",
  "stages": [
    { "id": "discover", "kind": "extractor", "extractorId": "careers.example.jobs" },
    { "id": "validate", "kind": "validator", "schema": "schemas/career-job-output.schema.json" },
    { "id": "map", "kind": "mapper", "mapperId": "careers.example.jobs.fetchPayload" },
    { "id": "enqueue", "kind": "queue", "destinationId": "careers.fetch.queue" }
  ]
}

파이프라인은 직접 작성하거나 템플릿과 설명자 선택 규칙으로 생성할 수 있습니다. 생성된 변형은 "extractorId": "$extractor.id"처럼 값을 명시적으로 연결합니다. Guida는 ID, 경로, 파일명에서 회사, 대상, 계약을 추측하지 않습니다.

안전한 실행 절차

Draft와 diff에서 실제 정의를 확인하고 파일 변경 제안을 봅니다.
Validate에서 구조, 참조, 계약, 그래프 규칙을 검사합니다.
Preflight에서 현재 워크스페이스와 운영 전제 조건을 확인합니다.
Plan에서 단계, 연결, 예상 변경, 필요한 기능, 정책, 인증 정보, 출처, 복구 정보, 차단 요인, 경고를 확인합니다.
Preview에서 정확한 제안의 해시와 실행 준비 여부를 확인합니다.
Start에서는 입력과 큐 한도를 명시합니다. 영향이 큰 작업에는 확인과 정책이 적용됩니다.

저장, 삭제, 실행은 서로 다른 작업입니다. 초안을 열거나 저장했다고 실행이 자동으로 시작되지 않습니다.

실행할 때 워크플로 실행과의 관계를 명시적으로 생성합니다. 큐 대상은 격리된 실행을 새로 만들지 기존 실행을 사용할지 선언합니다. Guida는 단계 상태, 의존성, 출력 참조, 중복 제거 결정, 운영 결과를 기록합니다.

workspace.pipelines.execution.lifecycle.get은 파이프라인이 관리하는 실행 상태와 단계 진행 상황을 반환합니다. 후속 작업의 미리 보기, 시작, 제어는 별도 호출입니다. 큐와 원장 결과는 명시적으로 조정되므로 큐가 비었다는 사실만으로 성공을 판단할 수 없습니다.

Remote Ops API는 목록, 초안, 차이, 검증, preflight, 계획, 미리 보기, 시작, 결과, 근거, 후속 작업, 제어 계약을 제공합니다. Guida Control은 이러한 계약을 사용하며 초안을 저장하는 것만으로 파이프라인을 시작하지 않습니다.