Skip to content

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

Latest

Choose a tag to compare

@treylom treylom released this 12 Nov 07:44
· 4 commits to master since this release
b210a54

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줄.