명령어 레퍼런스

명령어 구조

lexq <그룹> <액션> [옵션]

한눈에 보기

lexq auth                  login | logout | whoami
lexq status                API 헬스 체크
lexq serve                 MCP stdio 서버 실행 (--mcp)
lexq groups                list | get | create | update | delete
lexq groups ab-test        start | stop | adjust
lexq versions              list | get | create | update | delete | clone
lexq rules                 list | get | create | update | delete | reorder | toggle
lexq facts                 list | create | update | delete | action-metadata | unregistered
lexq domain-templates      list | preview | apply
lexq deploy                publish | live | schedule | unschedule | schedules | rollback | undeploy | history | detail | overview | deployable | diff
lexq analytics             dry-run | dry-run-compare | requirements
lexq analytics simulation  start | status | list | cancel | export
lexq analytics dataset     upload | template
lexq profile               규칙별 지연 프로파일 (--rule 상세)
lexq history               list | get | stats
lexq replay                decision | start | list | get | cancel
lexq provenance            get | reveal-audits
lexq logs                  list | get
lexq webhook-subscriptions list | get | save | delete | test

아래 각 섹션에서 명령어를 자세히 다룹니다.

Auth — 인증

명령어	설명
`lexq auth login`	API 키 저장
`lexq auth logout`	자격 증명 제거
`lexq auth whoami`	인증 정보 표시 (테넌트, 역할, 키 마스크)

Status — 상태 확인

명령어	설명
`lexq status`	API 연결 및 지연 시간 확인

lexq status는 whoami 엔드포인트를 호출하여 API 접속 가능 여부와 키 유효성을 확인하고 지연 시간을 보고합니다. lexq auth whoami는 인증 세부 정보 전체를 반환합니다. 빠른 헬스 체크에는 status, 신원 확인에는 whoami를 사용하세요.

Groups — 정책 그룹

명령어	설명
`lexq groups list`	그룹 목록
`lexq groups get --id <gid>`	그룹 상세
`lexq groups create --json '{...}'`	그룹 생성
`lexq groups update --id <gid> --json '{...}'`	그룹 수정
`lexq groups delete --id <gid>`	그룹 삭제
`lexq groups ab-test start --group-id <gid> --json '{...}'`	A/B 테스트 시작
`lexq groups ab-test stop --group-id <gid>`	A/B 테스트 중지
`lexq groups ab-test adjust --group-id <gid> --json '{...}'`	트래픽 비율 조정

Versions — 정책 버전

명령어	설명
`lexq versions list --group-id <gid>`	버전 목록
`lexq versions get --group-id <gid> --id <vid>`	버전 상세
`lexq versions create --group-id <gid> --json '{...}'`	DRAFT 생성
`lexq versions update --group-id <gid> --id <vid> --json '{...}'`	버전 수정
`lexq versions delete --group-id <gid> --id <vid>`	버전 삭제
`lexq versions clone --group-id <gid> --id <vid>`	새 DRAFT로 복제

Rules — 정책 규칙

명령어	설명
`lexq rules list --group-id <gid> --version-id <vid>`	규칙 목록
`lexq rules get --group-id <gid> --version-id <vid> --id <rid>`	규칙 상세
`lexq rules create --group-id <gid> --version-id <vid> --json '{...}'`	규칙 생성
`lexq rules update --group-id <gid> --version-id <vid> --id <rid> --json '{...}'`	규칙 수정
`lexq rules delete --group-id <gid> --version-id <vid> --id <rid>`	규칙 삭제
`lexq rules reorder --group-id <gid> --version-id <vid> --rule-ids "a,b,c"`	우선순위 재설정
`lexq rules toggle --group-id <gid> --version-id <vid> --id <rid> --enabled true`	활성화/비활성화

예시:

lexq rules create --group-id <gid> --version-id <vid> --json '{
  "name": "VIP 10% 할인",
  "priority": 1,
  "condition": {
    "type": "GROUP", "operator": "AND",
    "children": [
      { "type": "SINGLE", "field": "customerTier", "operator": "EQUALS", "value": "VIP", "valueType": "STRING" },
      { "type": "SINGLE", "field": "paymentAmount", "operator": "GREATER_THAN_OR_EQUAL", "value": 100000, "valueType": "NUMBER" }
    ]
  },
  "actions": [{ "type": "MUTATE_FACT", "parameters": { "targetVar": "paymentAmount", "operator": "SUB", "method": "PERCENTAGE", "operand": 10, "rounding": { "mode": "HALF_UP", "scale": 2 } } }]
}'

paymentAmount는 액션의 targetVar이므로 먼저 fact로 등록되어 있어야 합니다(lexq facts create). 아니면 명령이 ACT-032로 실패합니다.

Facts — fact 정의

명령어	설명
`lexq facts list`	fact 목록
`lexq facts create --key <key> --name <n> --type <type>`	fact 생성
`lexq facts update --id <fid> --name <n>`	fact 수정. 준 플래그만 바뀝니다. 값 제약이 바뀌면 새 제약 밖의 값을 쓰는 규칙을 stderr에 알립니다(자세히)
`lexq facts delete --id <fid>`	fact 삭제
`lexq facts action-metadata`	액션 타입별 런타임 fact 메타데이터 조회 (`MUTATE_FACT`, `SET_FACT`, `BLOCK`이 요구·생성하는 fact)
`lexq facts unregistered --group-id <gid> --version-id <vid>`	버전의 규칙이 참조하지만 스키마에 정의되지 않은 fact 목록 (조회 전용)

lexq facts action-metadata는 읽기 전용이며 세션 내 캐싱됩니다. 규칙 설계 시 언제든 호출할 수 있습니다.

Domain Templates — 도메인 템플릿

명령	설명
`lexq domain-templates list`	사용 가능한 도메인 템플릿 목록
`lexq domain-templates preview --template <key>`	템플릿이 생성할 내용 미리보기
`lexq domain-templates apply --template <key> [--name <n>]`	현재 테넌트에 템플릿 적용

apply는 큐레이션된 fact 정의와 샘플 규칙을 담은 정책 그룹을 만듭니다. --name으로 생성될 그룹 이름을 지정하고, --force로 확인 프롬프트를 건너뜁니다. preview를 먼저 실행하세요. 아무것도 바꾸지 않고 생성될 내용만 보여줍니다. 각 템플릿의 구성은 도메인 템플릿을 참고하세요.

Deploy — 배포

명령어	설명
`lexq deploy publish --group-id <gid> --version-id <vid> --memo "..."`	DRAFT → ACTIVE
`lexq deploy live --group-id <gid> --version-id <vid> --memo "..."`	프로덕션 배포
`lexq deploy rollback --group-id <gid> --memo "..."`	이전 버전으로 롤백
`lexq deploy undeploy --group-id <gid> --memo "..."`	라이브 버전 해제
`lexq deploy history [--group-id <gid>]`	배포 이력 목록
`lexq deploy detail --deployment-id <id>`	배포 상세
`lexq deploy overview`	모든 그룹의 배포 현황
`lexq deploy deployable --group-id <gid>`	배포 가능한 ACTIVE 버전 목록
`lexq deploy diff --base-version-id <vid> --target-version-id <vid>`	두 버전의 규칙 스냅샷 비교
`lexq deploy schedule --group-id <gid> --version-id <vid> --memo "..."`	미래 유효 시작일의 발행됨 버전을 자동 배포로 예약
`lexq deploy unschedule --group-id <gid>`	대기 중인 예약 배포 취소
`lexq deploy schedules [--format table]`	예약 배포 목록 조회(전체 상태)

rollback은 --expected-current-version-id와 --expected-current-deployment-id도 받습니다. lexq groups get이 돌려준 currentVersionId와 currentDeploymentId를 넘기면, 읽은 뒤 그룹이 바뀌었을 때 롤백이 거절됩니다. 롤백을 참고하세요.

Analytics — 드라이런

명령어	설명
`lexq analytics dry-run --version-id <vid> --json '{...}'`	드라이런 실행
`lexq analytics dry-run-compare --json '{...}'`	두 버전 비교
`lexq analytics requirements --group-id <gid> --version-id <vid>`	필수 fact 확인

Analytics — 변경 영향 시뮬레이션

명령어	설명
`lexq analytics simulation start --json '{...}'`	시뮬레이션 시작
`lexq analytics simulation status --id <simId>`	결과 폴링
`lexq analytics simulation list [--status <s>]`	시뮬레이션 목록
`lexq analytics simulation cancel --id <simId>`	취소
`lexq analytics simulation export --id <simId> --format json\|csv`	결과 내보내기

Analytics — 데이터셋

명령어	설명
`lexq analytics dataset upload --file <path>`	CSV/JSON 데이터셋 업로드
`lexq analytics dataset template --group-id <gid> --version-id <vid>`	템플릿 다운로드

Profile — 성능 프로파일링

명령어	설명
`lexq profile <groupId>`	그룹 지연 개요. 규칙별 백분위수와 상대 기준 느림 판정
`lexq profile <groupId> --rule <ruleId>`	규칙 상세. 구간 × 캐시 상태별 요약과 60초 구간 시계열

필터: --version-id <vid>(기본값: 운영 중 버전), --from / --to(ISO-8601 시각), --cache HIT|MISS. 버전을 지정한 호출(특정 버전 실행, 드라이런, 변경 영향 시뮬레이션, 의사결정 재실행)은 어느 버전으로 조회해도 들어 있지 않습니다. 백분위수는 표본이 충분히 쌓일 때까지 –로 나오고, p99처럼 높은 백분위수일수록 표본이 더 많이 필요합니다. 규칙이 느린지는 같은 그룹, 버전, 구간(Phase), 캐시 상태 안에서 규칙별 p50의 중앙값과 비교해 판정합니다. 고정된 밀리초 기준은 없습니다. 백분위수마다 필요한 최소 표본 수와 비교 방식은 성능 프로파일링 가이드를 참고하세요.

History — 실행 이력

명령어	설명
`lexq history list [--group-id <gid>] [--version-id <vid>]`	실행 이력 목록
`lexq history get --id <eid>`	실행 상세
`lexq history stats [--group-id <gid>]`	집계 통계

Replay — 의사결정 재실행

명령어	설명
`lexq replay decision --trace-id <tid> --version-id <vid>`	결정 하나를 후보 버전으로 재실행 (무과금)
`lexq replay start --version-id <vid> --from <date> --to <date>`	윈도우 재실행 job 제출 (과금, `--max-records`로 표본 상한)
`lexq replay list`	재실행 job 목록
`lexq replay get --id <jobId>`	job 상태·요약·변경 샘플 폴링
`lexq replay cancel --id <jobId>`	대기·실행 중 job 취소

Provenance — 의사결정 출처

명령어	설명
`lexq provenance get --trace-id <tid>`	결정의 출처 조회 (PII fact 마스킹)
`lexq provenance reveal-audits [filters]`	PII 열람 감사 원장 조회 (메타데이터 전용)

reveal 명령은 없습니다. PII 평문 열람은 설계상 콘솔 전용이며, 콘솔의 모든 열람은 값이 보이기 전에 감사 행을 먼저 기록합니다.

Logs — 실패 로그

명령어	설명
`lexq logs list [filters]`	실패 로그 목록
`lexq logs get --id <lid>`	상세 조회

실패 로그의 해결과 무시는 콘솔 전용입니다. 조직의 관리자(Admin)가 관리 → 실패 로그에서 처리합니다. CLI가 쓰는 API 키로는 실패 로그를 조회만 할 수 있고 상태는 바꿀 수 없습니다.

Webhook Subscriptions — 웹훅 구독

플랫폼 이벤트 웹훅은 배포 생명주기 알림(VERSION_PUBLISHED, DEPLOYED, ROLLED_BACK, UNDEPLOYED, DEPLOY_SCHEDULED, DEPLOY_SCHEDULE_CANCELED)을 수신합니다. 플랫폼 층위의 기능이며, 규칙이 직접 웹훅을 발송하지는 않습니다.

명령어	설명
`lexq webhook-subscriptions list`	웹훅 구독 목록
`lexq webhook-subscriptions get --id <wid>`	구독 상세
`lexq webhook-subscriptions save --json '{...}'`	생성 또는 수정 (생성 시 `id` 생략)
`lexq webhook-subscriptions delete --id <wid>`	구독 삭제
`lexq webhook-subscriptions test --id <wid>`	연결 확인용 테스트 이벤트 전송

예시:

lexq webhook-subscriptions save --json '{
  "name": "slack-deploy-alerts",
  "webhookUrl": "https://hooks.slack.com/services/...",
  "subscribedEvents": ["DEPLOYED", "ROLLED_BACK"],
  "payloadFormat": "SLACK",
  "secret": "your-hmac-secret",
  "isActive": true
}'

Serve — MCP 서버

명령어	설명
`lexq serve --mcp`	stdio MCP 서버 시작

→ MCP 서버 설정 가이드

표준 워크플로우

# 1. 그룹 생성          → lexq groups create --json '{...}'
# 2. 버전 생성          → lexq versions create --group-id <gid> --json '{...}'
# 3. fact 등록          → lexq facts create --key ... --name ... --type ...
# 4. 규칙 추가          → lexq rules create --group-id <gid> --version-id <vid> --json '{...}'
# 5. 드라이런 검증      → lexq analytics dry-run --version-id <vid> --debug --json '{...}'
# 6. 발행               → lexq deploy publish --group-id <gid> --version-id <vid> --memo "..."
# 7. 배포               → lexq deploy live --group-id <gid> --version-id <vid> --memo "..."

DRAFT 버전 없이 규칙 생성 불가. 규칙 없이 발행 불가. DRAFT는 배포 불가. 발행 전 항상 드라이런.

​명령어 구조

​한눈에 보기

​Auth — 인증

​Status — 상태 확인

​Groups — 정책 그룹

​Versions — 정책 버전

​Rules — 정책 규칙

​Facts — fact 정의

​Domain Templates — 도메인 템플릿

​Deploy — 배포

​Analytics — 드라이런

​Analytics — 변경 영향 시뮬레이션

​Analytics — 데이터셋

​Profile — 성능 프로파일링

​History — 실행 이력

​Replay — 의사결정 재실행

​Provenance — 의사결정 출처

​Logs — 실패 로그

​Webhook Subscriptions — 웹훅 구독

​Serve — MCP 서버

​표준 워크플로우

명령어 구조

한눈에 보기

Auth — 인증

Status — 상태 확인

Groups — 정책 그룹

Versions — 정책 버전

Rules — 정책 규칙

Facts — fact 정의

Domain Templates — 도메인 템플릿

Deploy — 배포

Analytics — 드라이런

Analytics — 변경 영향 시뮬레이션

Analytics — 데이터셋

Profile — 성능 프로파일링

History — 실행 이력

Replay — 의사결정 재실행

Provenance — 의사결정 출처

Logs — 실패 로그

Webhook Subscriptions — 웹훅 구독

Serve — MCP 서버

표준 워크플로우