status

등록된 모든 하니스의 설치, 검증, 드리프트 상태를 보고합니다.

개요Copy Anchor Link

apothem status [--profile PATH] [--project PATH]
               [--quiet|-q] [--verbose|-v]
               [--format plain|json] [--json] [--no-color]

status는 읽기 전용 검사 명령입니다. 등록된 모든 하니스 어댑터를 순회하며 하니스마다 세 가지 사실을 보고합니다. 설치되어 있는지, 관리 대상이 검증을 통과하는지, 그리고 설치된 구성이 공유 프로필에서 드리프트되었는지입니다. 디스크에는 아무것도 쓰지 않습니다.

각 하니스에 대해 status는 다음을 보고합니다.

drift 값은 다음 중 하나입니다.

드리프트는 보고될 뿐 절대 오류로 취급되지 않습니다. 하나 이상의 하니스가 drift를 보고하더라도 status는 0으로 종료합니다. 드리프트는 여러분의 설정에 관한 사실이지 명령의 실패가 아닙니다.

기본 공유 프로필을 로드할 수 없으면, 순회를 중단하지 않고 설치된 하니스의 드리프트를 unknown으로 낮춥니다(installed/verified 사실은 계속 보고됨). 반면 명시적으로 지정한 --profile을 로드할 수 없으면 사용자 오류이며, 대신 구조화된 오류와 함께 중단합니다.

이처럼 판정이 낮아진 경우는 항상 보고됩니다. status는 해당 프로필과 해결 방법을 명시한 권고를 출력하고, --json 봉투는 warnings에 이에 대응하는 drift_baseline_unavailable 항목을 담습니다. 이는 설치된 하니스가 없을 때 가장 중요합니다. 이때는 모든 행이 absent로 표시되고 unknown 셀이 없으므로, 기준이 로드되지 않았음을 알리는 신호는 권고뿐입니다.

옵션Copy Anchor Link

JSON 출력Copy Anchor Link

--json 봉투는 등록된 하니스마다 결과 행 하나를 담습니다. 각 행은 문서화된 키 harness, installed, verified, drift를 담습니다. 문제가 없는 순회에서는 warnings가 비어 있으며, 기본 프로필을 로드할 수 없었을 때는 path, code, reason, fix를 가진 drift_baseline_unavailable 항목 하나를 담습니다.

{
  "schema_version": 1,
  "status": "success",
  "command": "status",
  "action": "status",
  "harness": "all",
  "files_written": [],
  "results": [
    {
      "harness": "claude-code",
      "installed": true,
      "verified": true,
      "drift": "in-sync"
    },
    {
      "harness": "cursor",
      "installed": false,
      "verified": false,
      "drift": "needs-project"
    }
  ],
  "warnings": [],
  "error": null
}

어댑터별 장애 격리: 단일 어댑터가 상태를 보고하는 중에 예외를 발생시키면, 해당 하니스의 행은 outcome: "error"와 message를 담고, 나머지 하니스는 계속 정상적으로 보고하며, 프로세스는 코드 2로 종료합니다.

예시Copy Anchor Link

apothem status
apothem status --project .
apothem status --json

종료 코드Copy Anchor Link

함께 보기Copy Anchor Link

• apothem verify — 하니스 어댑터 설치를 검증합니다
• apothem diff — 하니스의 대기 중인 변경 사항을 미리 봅니다
• apothem harnesses — 등록된 하니스를 나열하고 검사합니다