이 페이지는 영어 문서의 번역입니다. 명령, 식별자, 예제는 그대로입니다. 런타임 7.24.4 · SDK 2.6.7. 영어 원문

의미 계층

상태: 활성 범위: 현재 상태 최종 검토: 2026-05-03 담당: ax-code 런타임

이 문서는 오늘 AX Code에 있는 의미 계층을 설명합니다. 로드맵이 아니라 현재 상태 계약입니다.

진실의 원천

이 페이지는 미래의 코드 그래프 야망이 아니라, 제공된 의미 동작을 문서화합니다. 동작이 바뀌면 다음을 기준으로 검증합니다.

실시간 의미 연산을 위한 packages/ax-code/src/tool/lsp.ts과 관련 LSP 모듈.
색인된 그래프 동작을 위한 packages/ax-code/src/code-intelligence/.
그래프에 기반한 디버깅/리팩터 분석(영향, 버그 경로, 경합, 수명 주기, 중복, 하드코딩된 값, 보안 발견, 게이트된 리팩터 적용)을 위한 packages/ax-code-reason/.
지속적인 출처 보장을 주장하기 전의 재생, 내보내기, 감사 시험.

기능이 계획되었거나 실험적이면 그 상태를 명시적으로 유지합니다.

목적

AX Code는 두 개의 명시적 출처를 통해 의미 답변을 노출합니다.

lsp: 실시간 언어 서버 질의
graph: 지속되는 코드 인텔리전스 질의

시스템은 하나를 다른 하나로 조용히 라우팅하지 않습니다. 호출자는 신선도, 지연, 결정성 요구에 따라 표면을 고릅니다.

현재 의미 표면

표면	뒷받침 출처	현재 역할
`lsp` 도구	실시간 LSP 클라이언트	가장 신선한 의미 답변, 명시적인 실시간 질의 표면
`code_intelligence` 도구	색인된 SQLite 코드 그래프	색인된 기호, 참조, 호출 관계에 대한 결정적 그래프 질의

lsp 도구는 실시간 의미 인터페이스입니다. code_intelligence 도구는 색인된 의미 인터페이스입니다. 어느 쪽도 다른 쪽의 숨은 폴백이 아닙니다.

현재 게이트:

code_intelligence는 기본적으로 켜져 있지만 기능 플래그로 끌 수 있습니다.
lsp은 현재 실험적 LSP 도구 플래그가 필요합니다.

봉투 계약

의미 답변은 출처 메타데이터를 지니므로, 하류 소비자가 신뢰와 신선도를 판단할 수 있습니다.

공통 필드:

source: lsp, graph 또는 cache
completeness: full, partial 또는 empty
timestamp: 바탕 답변이 해석된 때
degraded: 답변을 조심스럽게 취급해야 한다는 선택적 신호

LSP가 뒷받침하는 봉투에는 다음도 있을 수 있습니다.

serverIDs: 어느 언어 서버가 기여했는지
cacheKey: LSP 응답 캐시 행에 대한 안정적인 참조

감사와 재생

현재 동작:

lsp 도구를 통한 실시간 의미 호출은 audit_semantic_call 행을 씁니다.
도구 재생은 이제 tool.result.metadata를 보존하므로, 재생/내보내기 동안 그래프에 기반한 의미 메타데이터가 사라지지 않습니다.
결정적 재생은 결정 경로 메타데이터를 비교하지, 반환된 모든 기호 목록의 의미 동등성을 비교하지 않습니다.

이것은 LSP에 기반한 답변과 그래프에 기반한 의미 답변에 비슷한 감사 가시성을 줍니다. 그래도 저장/런타임 경로는 여전히 다릅니다.

현재 노출된 연산

`lsp`

실시간 lsp 표면에는 봉투가 뒷받침하는 다음 연산이 있습니다.

정의
참조
호버
문서 기호
작업 공간 기호
구현
호출 계층
모은 진단

최근성이 반복 가능성보다 중요할 때 맞는 표면입니다.

`code_intelligence`

그래프 표면에는 다음이 있습니다.

기호 조회
파일 기호
참조
호출자
피호출자

반복 가능성과 더 낮은 지연이 편집기 상태의 즉각적인 신선도보다 중요할 때 맞는 표면입니다.

세 번째 선택적 지식 표면은 .ax-wiki/ 아래의 네이티브 의미 저장소 위키이며, ax-code wiki이 컴파일합니다. 위의 구조 그래프/LSP 봉투 계약의 일부가 아닙니다.

표면	역할
`lsp` / `code_intelligence`	구조적 정밀도(이 문서)
`.ax-wiki/`	에이전트를 위한, 소스가 뒷받침하는 아키텍처 서술

CLI, 라우팅, 목표가 아닌 것은 AX Wiki를 보십시오. Wiki 합성을 호출자/피호출자/참조의 대체물로 취급하지 마십시오.

중요한 비목표

현재 의미 계층은 다음을 하지 않습니다.

자동 LSP 폴백이 있는 숨은 그래프 우선 라우팅은 없습니다.
그래프 신선도가 실시간 LSP 신선도와 같다는 주장은 없습니다.
모든 내부 의미 도우미가 HTTP나 SDK를 통해 노출된다는 주장은 없습니다.
현재 구현에 Rust 의미 런타임 분리는 없습니다.
AX Wiki 마크다운이 구조적 진실의 원천이라는 주장은 없습니다(AX Wiki 참조).

통합 안내

문서, SDK 바인딩, 더 높은 수준의 작업 흐름을 쓸 때:

lsp와 code_intelligence를 별개의 의미 표면으로 설명합니다.
공개 도구 연산과 내부 도우미 함수를 구분합니다.
현재 스키마에 실제로 보존된 감사/재생 보장만 설명합니다.
의미 표면이 항상 켜져 있지 않으면 플래그를 언급합니다.
AX Wiki를 언급할 때는 위키와 그래프의 책임을 명시적으로 유지합니다.