You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
km 1.8.13: km:search runs the Obsidian CLI steps as one script so none get skipped — vault= first, CLI timeouts, CLI-first backlinks, tag map script
This commit was created on GitHub.com and signed with GitHub’s verified signature.
1.8.13 (2026-11-12) — km:search 가 Obsidian CLI 단계를 빠뜨리지 않게: 단계를 대본 한 줄로
무엇이 바뀌었나: /km:search 의 Tier 2(볼트 확인 · 구조 문서 3개와 MOC-Map 경로 점수 · VAULT-STRUCTURE 폴더 줄 · 추천 태그 · CLI 글자 검색 · 1단 확장 = 속성·역링크·링크·태그·type)를 새 대본 scripts/km_cli_stage.py 가 한 번에 돈다. 명령 문서는 이 대본을 부르는 한 줄을 «글자 그대로» 실행하게 하고, 이 대본은 GraphRAG 결과가 있든(ok) 없든(꺼짐·실패) 늘 1회 돈다. 전에는 모델이 이 블록을 줄여 다시 쓰다가 단계를 빠뜨리는 일이 있었다.
같은/다른 볼트 가르기: 모델이 정하지 않고, 대본이 GraphRAG 결과 경로 상위 3건이 볼트에 실제로 있는지 보고 다시 정한다(VAULT_MODE_CHECK=… 줄 · 모델 판정과 다르면 대본 값을 따른다).
순서: 대본을 치기 «전»에는 볼트를 글자로 찾거나 읽지 않는다는 줄을 명령 문서 맨 앞 계약에 넣었다. 대본 뒤의 글자 찾기는 막지 않는다 — 명령 문서는 근거가 모자랄 때 GREP_REASON= 1줄을 먼저 찍게 하지만, 이 줄이 지켜지는지는 세지 않았다.
시한: CLI 호출마다 20초(KM_CLI_TIMEOUT) · 대본 1회 전체 90초(KM_CLI_BUDGET) · CLI 호출 최대 14번 · 시한 초과가 2번이면 남은 CLI 호출은 건너뛴다(글자 검색은 그래도 1회) · 첫 글자 검색이 빈 응답이거나 시한에 걸리면, 남은 시간이 호출 시한 이상일 때만 1회 다시.
볼트 지정: CLI 명령의 vault= 를 명령 «맨 앞»에 두도록 고쳤다(대본 · search-references/tier2-cli.txt 의 손 명령 · Tier 1-S · 역링크 1-hop). 명령 뒤에 붙인 vault= 는 무시되고 앱에서 지금 열린 볼트로 가는 것을 2026-11-11 확인했다 — 볼트를 여럿 연 기기에서는 전 판의 CLI 검색이 설정과 다른 볼트를 봤을 수 있다(전 판은 불일치 경고 1줄만 냈다). 손 명령에도 호출마다 20초 시한(KM_CLI_TIMEOUT)을 씌웠다.
새 대본 scripts/km_tag_map.py: 볼트의 TAG-Map(추천 태그 지도)을 만들고 읽는다. TAG-Map 이 없으면 추천 태그 단계는 absent 로 건너뛴다(검색은 계속). 만드는 법은 아직 안내하지 않는다 — 설치·셋업이 자동으로 만들지 않으므로 대부분 볼트에서 이 단계는 absent.
끝 줄: 답 마지막 줄은 여전히 «검색:» 으로 시작하지만 칸이 늘었다 — · CLI <상태>(N건) · 구조 문서 칸 안 VS <n>줄 · + 태그 추천(<상태>). 다른 vault 면 검색: GraphRAG 서버 (다른 vault 인덱스 — 서버 본문 기반). 대본이 그 줄을 찍고 모델은 그대로 옮겨 쓴다. 영수증은 tiers_tried 에 t2:<CLI 상태> 가 붙고, 대본의 KM_STAGES … 줄은 그 칸을 받는 helper 에만 넘긴다(실제 helper 로 기록 꼴을 확인하지는 않았다).
역링크 1-hop(Phase 2.5-B): Obsidian CLI backlinks 를 먼저 쓰고, CLI 가 없거나 목록이 아니면 전처럼 글자 찾기로 센다. 출력 줄 끝에 BL_SRC=cli|grep|skip 칸이 붙는다. Codex 사본(.agent/skills/km-search/SKILL.md)의 같은 블록도 같게 바꿨다.
사용자가 할 일: 플러그인 업데이트(/plugin 에서 km 업데이트 또는 /km:km-update) 뒤 새 세션에서 /km:search 를 쓰면 된다. 설정 바꿀 것 없음. Obsidian CLI 를 찾지 못한 기기에서는(윈도우는 CLI 기본 위치가 맥 경로라 OBSIDIAN_CLI 를 따로 주지 않으면 여기에 해당) 대본이 CLI_STATE=absent 를 찍고 구조 문서·텍스트 검색으로 계속 간다(맥에서 CLI 경로를 없는 곳으로 주고 1회 실행해 확인 · exit 0). 윈도우에서 실제로 돌려 보지는 않았다.
알려진 한계: 프로젝트 폴더 설치(install-to-project.sh)는 두 새 대본을 복사하지 않는다 — 그 설치에서는 (플러그인 캐시에도 대본이 없으면) 명령 문서가 «대본 없음»을 찍고 search-references/tier2-cli.txt 의 손 명령 절차로 간다(이 판에서 고친 볼트 지정·시한이 들어간 글). 대본의 시한 처리(프로세스 묶음째 끄기)는 맥·리눅스 방식이라 윈도우에서 CLI 가 시한에 걸리면 그 부분이 오류로 끝날 수 있다(코드 읽기로만 본 위험 · CLI 가 없으면 이 길에 안 들어감).
다음 판: 대본 전 볼트 찾기를 실제로 막는 «순서 지킴이» 훅은 이번 판에 넣지 않았다 — 이번 판에서 이 순서는 명령 문서로만 지킨다(훅은 시험을 거쳐 다음 판에). Codex 사본은 역링크 블록만 맞췄고, Codex 쪽 Tier 2 를 같은 대본 한 줄로 바꾸는 것도 다음 판.
시험: 봉인 시험 graph-expansion 의 줄 읽기가 새 BL_SRC 칸을 떼고 비교하도록 고침(기대 숫자 그대로 · 값 대조 58/58 같음) · test_km_map_descent.py B01 은 대본이 넘기는 ROUTE_AMBIGUOUS 를 입력으로 받게 고침 · cells.manifest 다시 봉인 · 매니페스트 1.8.12→1.8.13(.claude-plugin · .codex-plugin) · test_search_tier2_axes.sh 버전 고정 2줄.