명령어 레퍼런스

명령어 구조

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 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 integrations          list | get | save | delete | config-spec
lexq logs                  list | get | action | bulk-action
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": 0,
  "condition": {
    "type": "GROUP", "operator": "AND",
    "children": [
      { "type": "SINGLE", "field": "customer_tier", "operator": "EQUALS", "value": "VIP", "valueType": "STRING" },
      { "type": "SINGLE", "field": "payment_amount", "operator": "GREATER_THAN_OR_EQUAL", "value": 100000, "valueType": "NUMBER" }
    ]
  },
  "actions": [{ "type": "MUTATE_FACT", "parameters": { "refVar": "payment_amount", "operator": "SUB", "method": "PERCENTAGE", "rate": 10 } }]
}'

Facts — 팩트 정의

명령어	설명
`lexq facts list`	팩트 목록
`lexq facts create --key <key> --name <n> --type <type>`	팩트 생성
`lexq facts update --id <fid> --name <n>`	팩트 수정
`lexq facts delete --id <fid>`	팩트 삭제
`lexq facts action-metadata`	액션 타입별 런타임 팩트 메타데이터 조회 (`MUTATE_FACT`, `INCREMENT_FACT`, `EMIT_EVENT` 등이 요구/생성하는 팩트)
`lexq facts unregistered --group-id <gid> --version-id <vid>`	버전의 규칙이 참조하지만 스키마에 정의되지 않은 팩트 목록 (비차단)

lexq facts action-metadata는 읽기 전용이며 세션 내 캐싱됩니다 — 규칙 설계 시 언제든 호출 가능합니다.

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]`	예약 배포 목록 조회(전체 상태)

Analytics — 드라이런

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

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 <vid>(기본값: 운영 중 버전), --from / --to(ISO-8601 시각), --cache HIT|MISS. 측정이 100건 미만인 백분위수는 –로 유보되며, 판정은 상대 기준만 사용합니다. 자세한 동작은 성능 프로파일링 가이드를 참고하세요.

History — 실행 이력

명령어	설명
`lexq history list [--group-id <gid>]`	실행 이력 목록
`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 팩트 마스킹)
`lexq provenance reveal-audits [filters]`	PII 열람 감사 원장 조회 (메타데이터 전용)

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

Integrations — 외부 연동

명령어	설명
`lexq integrations list`	연동 목록
`lexq integrations get --id <iid>`	연동 상세
`lexq integrations save --json '{...}'`	생성 또는 수정
`lexq integrations delete --id <iid>`	삭제
`lexq integrations config-spec --type <type>`	필수 설정 스펙 조회

Logs — 장애 로그

명령어	설명
`lexq logs list [filters]`	장애 로그 목록
`lexq logs get --id <lid>`	상세 조회
`lexq logs action --id <lid> --action <a>`	재시도/건너뜀/해결
`lexq logs bulk-action --json '{...}'`	일괄 처리

Webhook Subscriptions — 웹훅 구독

플랫폼 이벤트 웹훅은 배포 생명주기 알림(VERSION_PUBLISHED, DEPLOYED, ROLLED_BACK, UNDEPLOYED, DEPLOY_SCHEDULED, DEPLOY_SCHEDULE_CANCELED)을 수신합니다. 규칙 단위의 EMIT_WEBHOOK 액션과는 별개입니다.

명령어	설명
`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. 팩트 등록          → 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 --mock --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 — 팩트 정의

​Deploy — 배포

​Analytics — 드라이런

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

​Analytics — 데이터셋

​Profile — 성능 프로파일링

​History — 실행 이력

​Replay — 의사결정 재실행

​Provenance — 의사결정 출처

​Integrations — 외부 연동

​Logs — 장애 로그

​Webhook Subscriptions — 웹훅 구독

​Serve — MCP 서버

​표준 워크플로우

명령어 구조

한눈에 보기

Auth — 인증

Status — 상태 확인

Groups — 정책 그룹

Versions — 정책 버전

Rules — 정책 규칙

Facts — 팩트 정의

Deploy — 배포

Analytics — 드라이런

Analytics — 변경 영향 시뮬레이션

Analytics — 데이터셋

Profile — 성능 프로파일링

History — 실행 이력

Replay — 의사결정 재실행

Provenance — 의사결정 출처

Integrations — 외부 연동

Logs — 장애 로그

Webhook Subscriptions — 웹훅 구독

Serve — MCP 서버

표준 워크플로우