콘텐츠로 이동

업데이트 로그

1.2.1(2026/08/07)

이번 릴리스는 핫픽스 수정이며, 내용은 다음과 같습니다.

문제 수정

  • data 유형 도구가 생성한 결과 파일의 ID가 너무 긴 문제를 수정했습니다. 새 파일은 22자리 URL-safe 무작위 ID를 사용하여 긴 매개변수로 인한 파일명 및 경로 길이 초과 위험을 줄이고, Agent가 이후 명령에서 더 쉽게 참조할 수 있도록 했습니다. (#8)
  • owl.data.simple_queryowl.data.simple_query_file이 매개변수 schema만 검증하고 자동 생성된 DQL은 검증하지 않던 문제를 수정했습니다. 이제 실행 전에 동등한 DQL을 구성하고 Registry의 DQL 검증 기능을 호출하여 유효하지 않은 쿼리 조각을 사전에 차단합니다. (#7)

기능 최적화

  • simple query의 생성 DQL 검증 실패 시 구조화된 generated_dql / dql.builderError 문제를 반환하여 Agent가 where_clause, select_clause, group_by_clause 등의 매개변수를 찾아 수정할 수 있도록 합니다. (#7)

호환성 조정

  • data 파일 인덱스 형식과 안정적인 queryKey는 변경되지 않으므로 기존 인덱스 및 결과 파일을 계속 읽을 수 있습니다. 새로 생성된 파일의 ID와 파일명만 짧아집니다. (#8)
  • 유효한 simple query 호출 방식과 원격 실행 체인은 변경되지 않습니다. 유효하지 않은 DQL만 요청이 전송되기 전에 더 일찍 실패합니다. (#7)

1.2.0(2026/08/05)

이번 릴리스는 기능 개선 릴리스이며, 주요 업데이트는 다음과 같습니다.

새로운 기능

  • CLI에 owl validate, owl tool validateowl capabilities가 추가되어, 대상 도구를 실행하지 않고도 매개변수 schema와 도구 전용 구문을 검증하고 구조화된 결과를 Agent가 판단 및 수정할 수 있도록 합니다. (#6)
  • 계정 워크스페이스 및 로컬 profile 관리 기능이 추가되었습니다. 여기에는 워크스페이스 목록, 액세스 키 획득, 워크스페이스 전환 및 현재 컨텍스트 확인이 포함됩니다. profile은 워크스페이스 자격 증명과 현재 컨텍스트를 관리하는 데 사용되며, 캐시 및 data 파일은 계속해서 구성된 공유 경로를 사용합니다. (3da3e8e)
  • 동일 조직 내 워크스페이스 검색 기능이 추가되어, 데이터 쿼리 시 same_org_workspace_uuids를 통해 동일 조직의 여러 워크스페이스를 조회할 수 있으며, 이를 통해 워크스페이스 간 Trace 검색이 가능합니다. (71fa73e)
  • owl exec에 버전 업데이트 알림이 추가되었습니다. CLI는 업데이트 채널에 따라 제한적으로 새 버전을 확인하고, JSON 출력에서 기존 파싱에 영향을 주지 않는 notice 필드를 통해 업그레이드를 알립니다. (7c7113c)
  • 공용 도구 디렉터리에 mdsearch 문서 검색 및 SLO 목록 기능이 추가되었습니다. (135c8ff, 18f87b0)
  • 공용 도구 디렉터리에 Studio Notes V2 노트 목록, 추가, 수정 및 삭제 기능이 추가되었습니다. (a72af5f)
  • 공용 도구 디렉터리에 데이터 전송 규칙 검색 및 비동기 쿼리 기능이 추가되었습니다. (6c37c93, c6dcd80)
  • 공용 도구 디렉터리에 Dashboard 목록 기능이 추가되었습니다. (6c98f0b)
  • Linux, macOS, Windows 5개 플랫폼을 위한 OSS 자동 릴리스 파이프라인이 추가되었습니다. 테스트 채널에서 검증이 완료되면 동일한 빌드 산출물을 프로덕션 채널로 승격할 수 있습니다. (9fba8e2)

문제 수정

  • HTTP 도구의 상위에서 클라이언트 오류 반환 시 Registry가 원래 상태와 오류 정보를 유실하던 문제를 수정했습니다. 이제 CLI가 더 정확하고 실행 가능한 실패 원인을 얻을 수 있습니다. (e1267e0)
  • Dashboard의 대량 결과가 여전히 text 경로로 반환되던 문제를 수정했습니다. 관련 도구는 이제 data 파일을 사용하여 결과를 저장하므로 대용량 페이로드가 Agent 컨텍스트를 차지하지 않습니다. (68cac16)
  • 데이터 전송 쿼리 결과가 여전히 text 경로로 반환되던 문제를 수정했습니다. 쿼리 결과는 이제 data 파일에 기록됩니다. (30aa6fc)
  • 워크스페이스 자격 증명 전환 및 표시 과정에서 계정 정보가 혼동될 가능성이 있는 문제를 수정했습니다. 구성 출력은 기본적으로 키를 숨기며, 명시적으로 요청한 경우에만 원본 secret을 표시합니다. (3da3e8e)
  • Streamable MCP 세션은 이제 설정 전에 인증을 완료하므로, 인증되지 않은 요청은 세션 상태를 생성하지 않습니다. (2a5d8e9)

기능 최적화

  • owl execowl validate의 매개변수 파싱 및 사전 검증 로직을 통합하여 한 번에 모든 매개변수 문제를 반환할 수 있도록 했습니다. 검증 전에는 정상적인 첫 사용 또는 캐시 만료 자동 동기화가 수행되며, 여전히 tool_not_found가 반환되는 경우 명시적으로 owl sync를 실행한 후 재시도해야 합니다. (#6)
  • CLI 작업은 안정적인 operation ID를 전달하며, Registry 요청과 상위 실패 간에 추적 정보를 전달하여 계층 간 문제 위치 파악을 용이하게 합니다. (386abc0)
  • 로그의 민감한 token은 문제 연결에 사용할 수 있는 처음과 끝 문자만 유지하고 중간 내용은 마스킹 처리하여 전체 자격 증명이 로그에 기록되지 않도록 합니다. (6a6d0ad)

호환성 조정

  • list, show, exec, schema 등의 기존 단축 명령어와 tool / tools 네임스페이스는 계속 호환됩니다. validatecapabilities는 새로 추가된 진입점입니다. (#6)
  • 이전 버전의 token, auth.token, workspaces.<name>.tokenauth.token_file 구성은 계속 읽을 수 있습니다. 새로 기록되는 자격 증명은 통일적으로 api-key를 사용하며, 기존 구성을 자동으로 삭제하지 않습니다. (3da3e8e)
  • owl.data.query의 PromQL 모드는 DQL 검증기에 포함되지 않습니다. 기존의 유효한 쿼리와 MCP 도구 호출 방식은 변경되지 않습니다. (#6)

1.0.11(2026/05/25)

이번 릴리스는 반복 릴리스이며, 주요 업데이트는 다음과 같습니다.

새로운 기능

  • data 분류에 CLI 전용 도구 owl.data.simple_query_file이 추가되었습니다. CLI가 최신 공용 도구 디렉터리를 동기화한 후 simple query 매개변수를 통해 기존 simple query 백엔드 인터페이스를 호출하고, 기존 data 파일 수명 주기를 통해 결과를 저장할 수 있습니다.
  • owl.data.simple_query_file은 MCP 도구 owl.data.simple_query와 별도의 노출 영역을 유지하여 대량 결과가 MCP text/context 경로를 통해 반환되는 것을 방지합니다.

기능 최적화

  • 실제 public config 회귀 테스트를 보강하여 owl.data.simple_query_file의 CLI 가시성, MCP 비가시성, outputType: data, 인증 방식 및 매개변수 schema를 포함합니다.

호환성 조정

  • 기존 MCP 도구 owl.data.simple_queryoutputType: text 및 MCP 전용 노출 방식을 그대로 유지합니다.

1.0.10(2026/05/18)

이번 릴리스는 핫픽스 수정이며, 내용은 다음과 같습니다.

문제 수정

  • registry.endpoint 구성이 끝에 슬래시가 있는 주소로 설정된 경우, CLI가 Registry API 경로를 연결할 때 이중 슬래시가 생성되어 owl sync가 nginx 404를 반환하는 문제를 수정했습니다.
  • Registry Client는 이제 구성 시 endpoint를 정규화합니다. http://testing-owl-api.dataflux.cn/http://testing-owl-api.dataflux.cn은 동일한 Registry 주소로 처리됩니다.

기능 최적화

  • Registry Client 및 SyncAll 회귀 테스트를 보강하여 끝에 슬래시가 있는 endpoint에서의 분류 동기화 경로를 포함하고, 이후 URL 연결이 저하되는 것을 방지합니다.

호환성 조정

  • 사용자 구성 형식은 변경되지 않습니다. 기존의 끝에 슬래시가 없는 endpoint는 동일한 동작을 유지하며, 끝에 슬래시가 있는 endpoint도 호환됩니다.

1.0.9(2026/05/12)

이번 릴리스는 반복 릴리스이며, 주요 업데이트는 다음과 같습니다.

새로운 기능

  • data 분류에 owl.logging.cluster_task.create가 추가되었습니다. CLI가 최신 공용 도구 디렉터리를 동기화한 후 비동기 로그 클러스터링 분석 작업을 생성할 수 있습니다.
  • data 분류에 owl.logging.cluster_task.get이 추가되었습니다. create가 반환한 task_id를 통해 비동기 로그 클러스터링 분석 결과를 조회할 수 있습니다.
  • 로그 클러스터링 작업은 전체 query 전달을 지원하며, namespace, conditions, timeRange, analysisFieldindexes를 통해 백엔드가 쿼리를 조립하도록 할 수도 있습니다.

기능 최적화

  • data 분류 설명과 버전을 업데이트하여 공용 디렉터리에 로그 클러스터링 작업 생성 및 조회 기능이 포함되었음을 명확히 했습니다.
  • loader 및 Registry server 회귀 테스트를 보강하여 로그 클러스터링 작업 schema 파싱, 필수 매개변수 검증 및 REST 실행 전달을 포함합니다.

호환성 조정

  • 이번 변경은 도구 추가로, 기존 owl.logging.list, owl.data.query 또는 기타 data 분류 도구의 호출 방식은 변경되지 않습니다.

1.0.8(2026/05/07)

이번 릴리스는 반복 릴리스이며, 주요 업데이트는 다음과 같습니다.

새로운 기능

  • data 분류 검색 체인에 owl.logging.listowl.billing.list가 추가되었습니다. CLI가 최신 공용 도구 디렉터리를 동기화한 후 로그 및 클라우드 청구의 source / field를 직접 검색할 수 있습니다.
  • owl.metric.listmode=tag를 지원하여 메트릭 tag key를 검색할 수 있으며, source를 통해 필드 또는 tag 결과를 필터링할 수 있습니다.
  • data 결과 파일명은 읽을 수 있는 접두사를 유지하고 UUID를 추가하여 중복 쿼리 또는 다중 세션 동시 실행 시 동일한 파일이 덮어쓰여지는 것을 방지합니다.
  • data 파일 인덱스에 안정적인 queryKey가 추가되어 동일한 쿼리를 식별할 수 있으며, 이전 버전의 index.json과도 호환됩니다.

문제 수정

  • 검색 도구 schema에 source 매개변수가 선언되지 않아 owl exec ... --source ...가 로컬 매개변수 검증에서 거부되던 문제를 수정했습니다.
  • AIAPI discovery list가 success:false 비즈니스 오류를 반환할 때 Registry REST 및 MCP HTTP 도구 외부에서 여전히 성공으로 잘못 보고될 수 있는 문제를 수정했습니다.
  • 설치 프로그램의 --owl-dir / -OwlDir로 사용자 정의 Owl 디렉터리를 지정한 후, 이후 owl config show를 직접 실행할 때 여전히 기본 구성 디렉터리로 폴백될 수 있는 문제를 수정했습니다.

기능 최적화

  • README 및 사용 문서의 데이터 검색 예제를 업데이트하여 mode=field, mode=tag, owl.logging.listowl.billing.list의 호출 방식을 보충했습니다.
  • 공용 디렉터리 동기화 프롬프트를 조정하여 공용 디렉터리가 적중되었을 때 Scope: public catalog가 오해의 소지가 있는 출력을 방지하도록 했습니다.
  • owl data clean은 기본적으로 1일 이전 파일을 정리하며, --days 0 또는 음수는 1일로 처리됩니다.
  • owl data clean은 index에 등록된 만료된 파일만 정리하며, 등록되지 않은 고아 파일은 기본 동작을 유지하여 능동적으로 스캔하여 삭제하지 않습니다.
  • Linux/macOS 및 Windows 설치 프로그램은 설치 대상 옆에 .owldir 경로를 기록하고, 사용자 정의 디렉터리를 사용하지 않거나 제거 시 이전 기록을 정리하여 CLI가 OWL_DIR 환경 변수 없이도 사용자 정의 구성, 캐시 및 데이터 디렉터리를 계속 찾을 수 있도록 합니다.
  • loader, executor, Registry REST, MCP의 discovery schema 및 비즈니스 오류 회귀 테스트를 추가했습니다.
  • CLI 구성 파싱 및 설치 프로그램 사용자 정의 디렉터리 회귀 테스트를 보강하여 .owldir 기록 읽기, config show 경로 표시 및 설치 후 디렉터리 위치를 포함합니다.

호환성 조정

  • owl exec 매개변수 형식은 변경되지 않으며, --key value, key=value, -p JSON 및 --stdin을 계속 지원합니다.
  • 비메트릭 discovery 도구는 mode=source|field만 허용합니다. mode=tagowl.metric.list에만 적용됩니다.

1.0.7(2026/04/29)

이번 릴리스는 반복 릴리스이며, 주요 업데이트는 다음과 같습니다.

새로운 기능

  • CLI에 tool 네임스페이스가 추가되었고, tools 별칭이 유지됩니다. 이 진입점은 list, show, exec, schema 등의 최상위 명령어 외에 보조 형태로 제공되어 Agent가 명령어 형식을 추측할 때 오류 허용성을 높입니다.
  • categorycategories 별칭이 추가되어 Agent가 자연스러운 명령어 추측 방식으로 분류 기능을 검색할 수 있습니다.

문제 수정

  • owl help tool, owl help categories 등의 도움말 주제를 파싱할 수 없는 문제를 수정했습니다.
  • 일부 --help 호출이 구성 초기화 또는 Registry 의존성을 사전에 트리거하던 문제를 수정했습니다. 이제 도움말 명령어는 구성되지 않은 환경에서도 직접 반환될 수 있습니다.

기능 최적화

  • 도움말 주제 회귀 테스트를 보강하여 주제별 도움말 조회(예: owl help tool)와 명령어별 도움말 조회(예: owl tool --help)가 동일한 정보를 반환하는지 확인했습니다.
  • README의 도구 조회 명령어 예제를 조정하여 tool 네임스페이스 사용법을 보충했습니다.

호환성 조정

  • list, show, exec, schema 등의 기존 최상위 명령어는 주요 사용 방식으로 유지되며 지속적으로 호환되어 기존 스크립트가 손상되지 않도록 합니다.
  • 더 이상 릴리스되지 않는 일부 예제 도구와 Skill 구성을 정리했습니다.

1.0.6(2026/04/28)

이번 릴리스는 반복 릴리스이며, 주요 업데이트는 다음과 같습니다.

새로운 기능

  • owl update 명령어가 추가되었습니다. 설치 프로그램이 기록한 업데이트 채널을 기반으로 해당 플랫폼의 설치 스크립트를 다운로드하여 실행할 수 있습니다.
  • Linux/macOS 설치 스크립트에 --upgrade가, Windows 설치 스크립트에 -Upgrade가 추가되어, 원격 버전이 업데이트된 경우에만 로컬 CLI를 업그레이드합니다.
  • 설치 프로그램은 구성에 update.base_urlupdate.channel을 기록하여 이후 owl update에 업데이트 소스를 제공합니다.

문제 수정

  • 업그레이드 시 기존 설치 경로를 안정적으로 찾을 수 없는 문제를 수정했습니다. 업그레이드 프로세스는 먼저 Owl 디렉터리의 binpath를 읽은 다음, PATHowl로 폴백합니다.
  • 로컬 버전이 원격 버전보다 낮지 않은 경우에도 설치를 덮어쓸 수 있는 문제를 수정했습니다. 이제 바이너리 교체를 건너뛰고 업데이트 채널 구성만 새로 고칩니다.

기능 최적화

  • 설치 프로그램에 시맨틱 버전 비교 로직이 추가되었습니다. 업그레이드 전에 로컬 owl --version과 원격 채널 version을 읽어 비교합니다.
  • 업데이트 프로세스는 Linux/macOS에서 설치 스크립트를 동기식으로 실행하고, Windows에서는 별도의 PowerShell 프로세스로 설치 프로그램을 시작하여 실행 중인 바이너리를 교체할 위험을 줄입니다.

1.0.5(2026/04/28)

이번 릴리스는 핫픽스 수정이며, 내용은 다음과 같습니다.

문제 수정

  • Linux/macOS 설치 프로그램이 macOS 시스템 기본 Bash 3.2에서 체크섬 비교 시 bad substitution 오류가 발생하는 문제를 수정했습니다.
  • Bash 4 문법 ${var,,}를 POSIX 도구 체인에서 사용 가능한 tr '[:upper:]' '[:lower:]'로 대체하여 체크섬 대소문자 정규화 로직이 이전 Bash와 호환되도록 했습니다.

기능 최적화

  • 5개 플랫폼 CLI 패키지를 다시 빌드하여 릴리스 디렉터리 버전, manifest 버전 및 패키지 내 owl --version 출력이 일치하도록 했습니다.
  • skill.mdskill.en.md 두 개의 Skill 문서를 유지하여 중문 및 영문 Agent Skill 배포를 계속 지원합니다.

1.0.4(2026/04/27)

이번 릴리스는 installer channel 릴리스이며, 주요 업데이트는 다음과 같습니다.

새로운 기능

  • skill.en.md를 릴리스하여 영문 Agent Skill 설명 파일을 보충했습니다.
  • 임시 코드 설치 및 사용자 정의 Owl 디렉터리를 지원하는 설치 프로그램 지원 파일을 1.0.4 channel 디렉터리에 릴리스했습니다.

문제 수정

  • 이전 버전 프로덕션 channel 설치 스크립트에 OWL_DIR / OwlDir 지원이 누락된 문제를 수정했습니다.
  • 기존 1.0.3 channel이 동기화 캐시의 영향을 받을 때 동일한 버전 릴리스를 직접 덮어쓰지 않도록 새 channel 디렉터리를 사용하여 수정된 설치 진입점을 제공합니다.

1.0.3(2026/04/27)

이번 릴리스는 반복 릴리스이며, 주요 업데이트는 다음과 같습니다.

새로운 기능

  • 설치 프로그램에 OWL_TEMP_CODE 지원이 추가되었습니다. OWL_REGISTRY_ENDPOINT에서 ai-api 주소를 유추하고 /api/v1/account/accesskey/exchange를 통해 실제 token으로 교환합니다.
  • skill.md가 추가되어 Agent 통합 시나리오를 위해 channel과 함께 배포되는 Skill 설명을 제공합니다.

문제 수정

  • bash -c "$(curl .../install.sh)" 진입점에서 BASH_SOURCE[0] 읽기가 실패할 수 있는 문제를 수정하고, $0 폴백이 있는 스크립트 진입점 파싱으로 변경했습니다.
  • 인라인 installer helper에서 예상치 못한 줄바꿈이 발생하는 문제를 수정하여 릴리스 버전 install.sh가 직접 실행 가능한 자체 포함 스크립트에 더 가깝도록 했습니다.

기능 최적화

  • 임시 코드를 token으로 교환할 때 OWL_TOKEN과 교환 결과가 일치하는지 확인하며, 일치하지 않으면 설치를 직접 중단합니다.
  • OWL_TEMP_CODE 요청은 기본적으로 로컬 프록시를 우회하여 임시 자격 증명 교환이 프록시 구성의 영향을 받을 가능성을 줄입니다.

1.0.2(2026/04/24)

이번 릴리스는 반복 릴리스이며, 주요 업데이트는 다음과 같습니다.

새로운 기능

  • CLI 및 설치 프로그램이 사용자 정의 Owl 작업 디렉터리를 지원합니다. OWL_DIR, --owl-dir, -OwlDir이 추가되었습니다.
  • 설치 프로그램이 OWL_OWNER / --owl-owner를 지원하여 cloud-init 또는 root 설치 후 구성 디렉터리를 서비스 사용자에게 전달할 수 있습니다.
  • 설치 완료 후 바이너리 경로를 Owl 디렉터리 아래의 binpath에 기록하여 이후 업그레이드 및 Agent 런타임에서 위치를 찾는 데 사용할 수 있습니다.

문제 수정

  • 설치 프로그램이 registry.endpointauth.token을 영구 저장할 때 현재 사용자 디렉터리에 고정 기록되던 문제를 수정했습니다. 이제 지정된 Owl 디렉터리에 기록됩니다.
  • 사용자 정의 디렉터리 시나리오에서 config show가 디렉터리를 정확하게 표시하지 않는 문제를 수정했습니다.

기능 최적화

  • README에 cloud-init / systemd 서비스 사용자 설치 설명을 추가하여 OWL_DIROWL_OWNER의 권장 사용법을 명확히 했습니다.
  • 설치 스크립트의 제거 프롬프트, 구성 디렉터리 초기화, 경로 기록 로직이 통일적으로 파싱된 Owl 디렉터리를 사용합니다.

1.0.1(2026/04/23)

이번 릴리스는 핫픽스 수정이며, 내용은 다음과 같습니다.

새로운 기능

  • CLI에 최초 사용 자동 동기화 기능이 추가되었습니다. 로컬 캐시가 비어 있거나 캐시가 registry.sync_interval을 초과한 경우 list, show, exec, schema, category 등의 명령어가 자동으로 owl sync를 트리거합니다.
  • sync.auto 구성 항목이 추가되어 자동 동기화를 비활성화할 수 있습니다.

문제 수정

  • 1.0.0 Linux/macOS tar 패키지 내 owl 바이너리에 실행 권한이 누락된 문제를 수정했습니다.
  • owl sync 증분 동기화 시 원격에서 이미 삭제된 category의 캐시를 정리하지 않는 문제를 수정했습니다.
  • HOME이 없는 일부 cloud-init / systemd / container 환경에서 설치 스크립트가 set -u로 인해 조기 종료될 수 있는 문제를 수정했습니다.

기능 최적화

  • 자동 동기화 실패 시 최초 동기화와 캐시 새로 고침을 구분합니다. 최초 동기화 실패는 오류를 반환하고, 기존 캐시가 있는 새로 고침 실패는 이전 캐시를 유지하고 warning을 출력합니다.
  • 릴리스 디렉터리를 복원하고 1.0.01.0.1 channel 산출물을 추적하며, 설치 프로그램 회귀 테스트 및 CRLF/LF 검사를 보강했습니다.

1.0.0(2026/04/13)

이번 릴리스는 최초 릴리스이며, 주요 업데이트는 다음과 같습니다.

새로운 기능

  • Owl CLI의 첫 번째 channel 버전을 릴리스하여 Linux, macOS, Windows 총 5개 플랫폼 패키지를 제공합니다.
  • install.sh, install.ps1, owl-install.ps1SHA256SUMS를 제공하여 원격 channel 설치, 지정된 버전 설치, 로컬 패키지 설치 및 체크섬 검증을 지원합니다.
  • CLI는 초기화 구성, 로그인 token 기록, 도구 디렉터리 동기화, 분류 조회, 도구 조회, 도구 실행, OpenAI function schema 출력, 캐시 관리 및 데이터 파일 관리를 지원합니다.

기능 최적화

  • 릴리스 디렉터리에는 README 및 USAGE 문서가 포함되어 테스트/프로덕션 채널 설치, 런타임 구성, 오프라인 설치, 제거 및 일반 명령어를 설명합니다.
  • 빌드 체인은 다중 플랫폼 크로스 컴파일을 지원하며, version manifest를 통해 현재 버전, 이전 버전, 릴리스 시간, commit 및 플랫폼 목록을 기록합니다.

알려진 문제

  • Linux/macOS tar 패키지 내 owl 바이너리 권한이 0644로 설정되어 있어 직접 압축 해제 후 실행할 수 없습니다. 이 문제는 1.0.1에서 수정되었습니다.

문서 평가

이 페이지가 도움이 되었나요?