CLI 명령어 레퍼런스 — Altifigence Documentation

CLI 출력과 리시트, 구조화된 오류, 종료 상태를 읽는 방법을 설명합니다.

개요

검증과 설치 후 설치된 실행 파일을 사용하세요. 이 레퍼런스는 명령 탐색, 실행 결과, 사전 검사 영수증, 서비스 응답을 구분합니다.

액션 매니페스트

성공하면 JSON 배열 하나를 출력합니다. 각 항목에는 name, description, inputSchema, executes, class가 있습니다. 내장 고객 manifest에는 액션 25개가 있고 그중 22개는 executes: true입니다. altifigence.analyze.run, altifigence.evolve.launch, altifigence.verify.run은 계획 전용입니다. 네이티브 CLI 하위 명령은 이 고객 manifest와 별도로 개별 도움말을 제공합니다. 서비스 작업의 권한과 준비 상태는 서버 응답이 결정합니다.

네이티브 인수는 개별 명령의 도움말로 확인하세요.

alti commands

alti xls upstream run --help
alti compute rtl-evolve --help
alti ide workspace hierarchy-plan --help
alti ide cloud search --help
alti ide service workspace replace --help

오프라인 작업 사전 점검

CLI 첫 실행의 소스와 요청을 준비한 뒤 실행하세요.

성공 스키마는 altifigence.cli.engine-job-preflight.v1입니다. submitted: false와 server_authority_verified: false가 필수입니다. 소스 해시와 작업 형식은 로컬에서 확인했지만 작업을 제출하거나 실행하지는 않았습니다. 요청의 execution_placement 값도 이를 바꾸지 않습니다.

alti --json job validate \
  --job "$ALTI_WORKSPACE/job.json" \
  --workspace-root "$ALTI_WORKSPACE" \
  --source rtl/top.sv

JSON 오류 계약

--json job validate가 실패하면 stdout에 성공 영수증을 쓰지 않고 stderr에 altifigence.cli.error.v1 객체를 출력합니다.

가능하면 error.code를 사용하세요. 다른 명령군은 자체 오류 스키마를 사용하므로 이 형식이 모든 CLI 명령에 적용된다고 가정하지 마세요.

{
  "schema": "altifigence.cli.error.v1",
  "error": {
    "code": "ENGINE_JOB_JSON_INVALID",
    "message": "The engine job JSON is invalid.",
    "retryable": false
  }
}

종료 상태

상태	통역
`0`	선택한 명령이 완료됨. 결과가 준비 상태·사전 검사·계획·실행 중 무엇을 보고하는지 확인하세요.
`1`	CLI 런타임·검증·통신·설치 실패. 서비스 실패에는 HTTP 응답이 포함될 수 있습니다.
`2`	잘못된 인수 또는 통신·엔진 실행 전 요청 거부. 엔진도 이 상태를 반환할 수 있습니다.
`3`	고객 manifest 경로에서 예약된 클래스 거부. 엔진은 같은 숫자를 다른 의미로 사용할 수 있습니다.
`4`	사용 불가능한 최상위 로그인·식별 정보나 소스 업로드 동의 누락 등을 포함한 고객 manifest 거부
`126`	엔진 시작 또는 설치 인증 실패
`127`	필요한 엔진 실행 파일을 사용할 수 없음
그 밖의 0이 아닌 값	자식 엔진의 자체 상태가 그대로 전달된 값일 수 있음

stdout을 파싱하기 전에 항상 종료 상태를 확인하고 stderr를 분리하세요. 비어 있거나 일부만 기록된 출력 파일은 성공 결과가 아닙니다. 저장된 계획은 적용된 트랜잭션이 아니며, 서버의 접수는 작업 완료가 아닙니다.

엔진 명령: 실제로 실행되는 것

XLS, compute, 네이티브 DDS 어댑터는 패키지에 고정된 형제 실행 파일을 사용합니다. 설치된 실행은 해당 실행기를 서명된 릴리스 기록과 대조해 인증합니다. 다른 실행 파일을 PATH에 추가해도 필요한 형제 파일의 누락은 해결되지 않습니다. 일부 이전 호환 명령은 문서에 명시된 탐색 동작을 유지합니다. 명령 인터페이스를 참조하세요.

--json이 없으면 엔진 stdout을 그대로 전달해 네이티브 계획을 직접 저장할 수 있습니다. --json을 사용하면 엔진 호출은 일반적으로 altifigence.local-engine-execution.v1을 출력합니다. 이 객체의 stdout, stderr에는 자식 프로세스의 출력이 문자열로 들어갑니다. 내부 결과는 별도로 파싱하세요.

파일·계층 계획은 전체 네이티브 계획 결과를 대응하는 적용 명령에 전달하세요. 바깥 CLI 응답이나 계획 다이제스트만 전달하지 마세요. 네이티브 백엔드는 현재 파일 해시와 트랜잭션 조건을 검증합니다.

서비스 및 스트리밍 출력

ide service는 operation, ok, httpStatus, 크기가 제한된 응답 body를 포함한 altifigence.dds.service-receipt.v1을 반환합니다. 바꾸기의 HTTP 409는 충돌로 유지하며 재시도하지 않습니다. 성공한 DELETE의 빈 응답은 그대로 보존하고 서버 JSON 객체를 임의로 만들지 않습니다.

네이티브 DDS 검색과 Cloud 검색은 각자의 일치 항목·내용 증거를 제공합니다. 쓰기 대상 백엔드에서 제공한 식별 정보를 사용하세요. 다른 검색 백엔드에서 계산한 해시가 자동으로 유효한 CAS 토큰이 되지는 않습니다.

ide cloud terminal은 터미널 바이트를 stdout에, 연결 상태를 stderr에 스트리밍합니다. 전역 --json을 사용해도 단일 JSON 영수증이 아닙니다. 연결 시간을 제한하고 다시 연결할 계획이라면 커서를 보관하세요.

--json release install과 --json release uninstall은 operation, ok, exitCode를 포함한 altifigence.cli.release-bootstrap.v1을 출력합니다. 설치 진단은 stderr로 보냅니다. 성공 응답이 생성되기 전에 검증이나 권한 검사가 실패할 수 있습니다.

자동화 결과 저장

호출마다 새 출력 디렉터리를 선택하세요. 표준 출력·오류를 별도로 저장하고 종료 상태를 즉시 기록한 뒤 0일 때만 성공 스키마를 해석합니다. 엔진 봉투의 stdout 문자열은 해당 명령 계약이 JSON이라고 명시한 경우에만 native 문서로 해석합니다.

계획/적용 작업은 전체 원본 native 계획을 보관하고 같은 프로젝트를 사용하세요. 적용 전에 대상 파일·현재 해시를 검토합니다. 충돌이 나면 다시 읽고 새 계획을 검토해야 하며 해시 검사를 없애면 안 됩니다. 재현 가능한 로컬 검사는 자동화와 CI를 참고하세요.