oh-my-second-brain 0.15.0 → 0.16.0

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
     {
       "name": "oms",
       "description": "Oh My Second Brain convention layer for Obsidian vaults — capture, retrieve, and validate knowledge under a declared semantic convention.",
-      "version": "0.15.0",
+      "version": "0.16.0",
       "author": {
         "name": "gobeumsu",
         "email": "gobeumsu@gmail.com"
@@ -37,5 +37,5 @@
       ]
     }
   ],
-  "version": "0.15.0"
+  "version": "0.16.0"
 }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "oms",
-  "version": "0.15.0",
-  "description": "Oh My Second Brain convention layer for Obsidian vaults — seven shared skills and five MCP tools under a declared semantic convention.",
+  "version": "0.16.0",
+  "description": "Oh My Second Brain convention layer for Obsidian vaults — eight shared skills and five MCP tools under a user-owned contract.",
   "author": {
     "name": "gobeumsu"
   },
@@ -17,10 +17,12 @@
   "skills": [
     "./assets/skills/distill/",
     "./assets/skills/doctor/",
+    "./assets/skills/interview/",
     "./assets/skills/link/",
     "./assets/skills/search/",
     "./assets/skills/status/",
     "./assets/skills/template/",
     "./assets/skills/write/"
-  ]
+  ],
+  "agents": ["./agents/oms-reviewer.md"]
 }

package/.codex-plugin/plugin.json

@@ -1,8 +1,8 @@
 {
   "name": "oms",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Oh My Second Brain convention layer for Obsidian vaults — Codex native rules, skills, and MCP adapter.",
-  "_note": "oms host install writes Codex MCP config and provenance, installs ~/.codex/rules/oms.md, and installs the seven shared skills under ~/.codex/skills/oms-*.",
+  "_note": "oms host install writes Codex MCP config and provenance, installs ~/.codex/rules/oms.md, and installs the eight shared skills under ~/.codex/skills/oms-*.",
   "skills": "./assets/skills/",
   "mcpServers": "./.mcp.codex.json"
 }

package/ACKNOWLEDGMENTS.md

@@ -6,6 +6,26 @@ oh-my-secondbrain은 아래 공개 작업들의 아이디어와 구현에 빚지
 > 우리가 무엇을 흡수했는지(설계 로직·근거)는 `docs/research/*` 에 기록한다.
 > 관리 규칙: [`docs/rules/external-attribution.md`](https://github.com/GoBeromsu/oh-my-second-brain/blob/main/docs/rules/external-attribution.md)
 
+## 계약·평가·인터뷰 설계
+
+### Ouroboros
+
+- **저자 / 기여자**: Q00와 Ouroboros 기여자
+- **URL**: https://github.com/Q00/ouroboros
+- **라이선스**: [MIT](https://github.com/Q00/ouroboros/blob/main/LICENSE)
+- **흡수 종류**: absorbed logic — 설계 아이디어 참고, 코드 직접 이식 없음
+- **배운 점**: 명시적 계약, 작성과 평가의 책임 분리, 기계 검사와 의미 평가의 구분, 실제 산출물의 근거에 기반한 완료 판정.
+- **감사**: Ouroboros의 계약 중심 설계와 단계적 검증에서 많은 것을 배웠다. 그 배움을 사용자가 자신의 지식 체계와 정책을 소유하는 OMS의 철학으로 구체화할 수 있도록 공개해 주신 프로젝트와 기여자분들께 진심으로 감사드린다.
+
+### Gajae Code
+
+- **저자 / 기여자**: Yeachan-Heo와 Gajae Code 기여자
+- **URL**: https://github.com/Yeachan-Heo/gajae-code
+- **라이선스**: [MIT](https://github.com/Yeachan-Heo/gajae-code/blob/main/LICENSE)
+- **흡수 종류**: absorbed logic — 인터뷰 상호작용 설계 참고, 코드 직접 이식 없음
+- **배운 점**: [deep-interview](https://github.com/Yeachan-Heo/gajae-code/blob/main/packages/coding-agent/src/defaults/gjc/skills/deep-interview/SKILL.md)의 맥락 사전 확인, 한 번에 한 질문, 자유답변의 의도 확인, 결정 기록과 최종 승인.
+- **감사**: 사용자에게 같은 설명을 반복하게 하기보다 이미 표현한 의도를 정리하고 필요한 결정만 확인하는 인터뷰 방식에서 배웠다. OMS의 설정·계약 인터뷰를 구체화하는 데 도움을 준 공개 작업에 감사드린다.
+
 ## LLM-Wiki 패턴 & 구현체
 
 - https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f

package/CHANGELOG-assets.md

@@ -4,6 +4,13 @@ Skills, agents, templates, and host guidance changes belong here.
 
 ## [Unreleased]
 
+## [0.16.0] - 2026-09-23
+- Live host-facing docs no longer show a copyable `interview-next` call without `proposals`. Confirming the template notice still starts that mode, but the same proposals array must reach review, answer, and commit.
+- Search, status, and write skills now say `templateNotice.next` is a mode hint, not a replayable `interview-next` CallToolRequest.
+
+- Eight shared skills now include a tool-less contract interview. Guidance separates agent-owned note writing from OMS guidance, saved-file checks, and completion using a separate reviewer; search and ordinary note errors do not start configuration interviews. Generated GJC mirrors share the authored skill bytes.
+- Reviewer guidance distinguishes host claims, agent transcription, and OMS-computed digests. Matching role-definition bytes is not proof of a separate launch, enforced tool restrictions, or whole-vault immutability.
+
 ## [0.15.0] - 2026-09-19
 
 - **Host guidance now teaches selected-folder template sources instead of per-file registration or folder modes.** It documents the exact `템플릿에 변경이 있습니다` / `확인하기` / `나중에` notice, host-only deferral, long-lived `templateNotice` results, and the resumable `interview-next` → `interview-answer` → `commit-contracts` flow that publishes only user-confirmed controls. Placement is write-time only (explicit destination, then taxonomy default, then `ask`); source review preserves Markdown bytes and does not invent a registration prerequisite, widget, or host configuration.

package/CHANGELOG-cli.md

@@ -4,6 +4,10 @@ Changes to the `oms` command surface belong here.
 
 ## [Unreleased]
 
+## [0.16.0] - 2026-09-23
+
+- Host discovery reports the eight actual Codex skill paths and installed reviewer-definition health instead of the retired setup skill. Discovery and installation now resolve relative host-home overrides consistently; definition health is not reviewer execution proof.
+
 ## [0.15.0] - 2026-09-19
 
 - **Breaking: the template CLI now exposes a selected-folder census and linear review flow.** The exact leaves are `scan|list|show|add|update|move|remove|default|check|regenerate-types|review|answer|commit`; `scan` is read-only, `add <folder>` selects source scope, and `add --id <id> --from <file>` remains explicit source authoring rather than contract review. `answer <question-id> --answer <JSON> --census-digest <digest> --ledger-digest <digest|null>` forwards server-returned CAS fields, while `commit` adds the existing dry-run or `--yes --approved-digest` guard. This removes the per-file registration ritual without weakening verified-target writes; note creation considers `--folder <note-folder>` before a taxonomy default and then `ask`, with no template-creation target-folder form.

package/CHANGELOG-kernel.md

@@ -4,6 +4,15 @@ Domain logic changes belong here.
 
 ## [Unreleased]
 
+## [0.16.0] - 2026-09-23
+- Guide now binds a saved note to the template it declares when the caller omits `templateId`, matching check. Passing `templateId: null` still uses the default layer only.
+
+- Version 4 contracts compose a user-owned property pool, an always-on default layer, and optional additive template constraints. Approved Markdown remains byte-exact; raw source or managed-draft drift reports locally without replacing the approved snapshot. Full derived-projection validation and transaction-generation checks reject inconsistent writing evaluations.
+- Contract publication confines outputs to approved controls and managed drafts, checks exact approval and current-byte preconditions, and supports honest interrupted-publication recovery. A completed publication marker does not make later user draft edits a global reading failure.
+- Search source exclusions and taxonomy intent no longer require a valid writing contract. Missing raw templates or invalid policy cannot block ordinary-note scanning; explicit exclusion and taxonomy errors remain visible.
+- Native embedding diagnostics now use stderr through node-llama-cpp's logger callback, keeping diagnostic output separate from MCP stdout without suppressing warnings. (#133)
+- Native SQLite ABI mismatches report the actual Node executable, version, module ABI and addon path with rebuild guidance. The original loader error remains the cause; unrelated opening errors are not relabeled, and no backend fallback or automatic rebuild occurs. (#139)
+
 ## [0.15.0] - 2026-09-19
 
 - **Breaking: template contracts now reconcile from an explicit selected-folder census instead of per-file registration or auto/manual modes.** Every `.md` beneath the selected scope is classified for add, edit, delete, or rename; source bytes stay in place and only user-confirmed `.oms` controls publish. The two-tier freshness gate hashes raw shared authorities first and then isolates changed templates as pending while preserving unrelated note writes. Metadata and bounded body-node contracts (with per-node requiredness/order) replace opaque body assumptions; anchored resumable questions and a locked CAS preserve unaffected answers. Historical ledger census is not blanket stale rejection: current request CAS and per-answer anchors govern validity. Ambiguous repeated body nodes remain contextualized, missing required-body rules require explicit disposition, and placement is optional during review then resolves at note creation by explicit destination, taxonomy default, or `ask`.

package/CHANGELOG-mcp.md

@@ -4,6 +4,10 @@ MCP server tools and resources belong here.
 
 ## [Unreleased]
 
+## [0.16.0] - 2026-09-23
+- Host-facing docs no longer show a copyable `interview-next` call without `proposals`. Confirming the template notice still starts that mode, but the same proposals array must reach review, answer, and commit.
+- The machine template notice `next` field is a mode hint (`skill: interview`, `mode: interview-next`), not a replayable CallToolRequest. OMS still does not invent proposals; `확인하기` enters `/interview`.
+
 ## [0.15.0] - 2026-09-19
 
 - The bundled MCP SDK now resolves `hono` 4.13.8, clearing the moderate advisory group that affected its HTTP transport's body and query parsing. Only the lockfile moves; no declared dependency is added or changed.

package/CHANGELOG-vendors.md

@@ -4,6 +4,11 @@ Per-host adapter and installer changes belong here.
 
 ## [Unreleased]
 
+## [0.16.0] - 2026-09-23
+
+- Codex installs an optional provenance-owned reviewer role while preserving unowned collisions; a genuine generic separate subagent remains valid without custom-role discovery. Dry-run skill paths now match the eight installed shared skills.
+- Hermes guidance uses its native fresh-conversation delegation with inherited tools and explicit non-modification instructions, without claiming unavailable sandbox enforcement.
+
 ## [0.15.0] - 2026-09-19
 
 - **Claude, Codex, and Hermes guidance now aligns with folder-sourced template contracts.** Each native host surface explains selected-folder census without per-file registration or folder modes, the exact minimal notice and host-only `나중에`, and the resumable `interview-next` → `interview-answer` → `commit-contracts` flow. Review preserves source bytes and publishes only user-confirmed controls; affected-template pending remains scoped while shared-authority failures stay fail-closed globally. Note creation uses explicit folder, taxonomy default, then `ask`, without changing the host-specific skill/tool asymmetry.

package/CHANGELOG.md

@@ -10,6 +10,9 @@ This aggregate changelog contains changes that span multiple layers.
 
 ## [Unreleased]
 
+## [0.16.0] - 2026-09-23
+- **Breaking: OMS is a user-owned contract and completion harness, not a note writer or template renderer.** Version 4 of `.oms/template-policy.json` is the only approved structure and meaning: an always-on empty default layer, optional templates that only add or tighten, and unmanaged frontmatter left unchecked. Agents write and repair notes. OMS guides, checks the saved file, and completes from a separate host review. Search stays read-only even when the contract is missing or mid-publish. Contract meaning enters only through explicit `proposals` on `interview-next`, `interview-answer`, and `commit-contracts`; a recorded answer whose proposals were omitted is refused rather than dropped. The public surface is eight skills (`interview` and `template` are tool-less), five MCP tools, and fourteen CLI families. Retired v3 registration, note-write, link-apply, and renderer paths are deleted, not aliased. The machine template notice `next` field is a mode hint into `/interview`, not a replayable CallToolRequest.
+
 ## [0.15.0] - 2026-09-19
 
 - **Breaking: a selected template folder, not a per-file registration step, is what makes a template usable.** Every `.md` beneath a folder you explicitly select is a census candidate tracked by content hash, so adding, editing, deleting, or renaming a source is picked up without registering each file and without the retired auto/manual folder modes. This spans layers deliberately: the kernel owns the census, contract derivation, interview ledger, and guarded reconcile; the CLI gains `oms template review|answer|commit`; MCP gains the matching `interview-next`, `interview-answer`, and `commit-contracts` modes plus the notice carrier; and the shared skills and host guidance describe one vocabulary. The five MCP tools and seven skills are unchanged.

package/README.ko.md

@@ -1,124 +1,64 @@
 # Oh My Second Brain
 
-Oh My Second Brain(`oms`)은 기존 Obsidian/Markdown 볼트를 노트 소유권을 빼앗지 않고 AI 호스트에 연결한다. 볼트는 계속 평범한 Markdown이다.
+Oh My Second Brain(`oms`)은 기존 Obsidian·Markdown 볼트를 AI 호스트와 연결하되 노트의 소유권은 가져가지 않는다. 볼트는 계속 평문 Markdown이고, Obsidian이 사령탑으로 남는다. OMS가 꺼져 있어도 노트는 사람이 읽고 고칠 수 있는 파일이다. OMS는 속성·폴더·heading의 의미를 스스로 만들어내지 않는다.
 
 ## 템플릿·온톨로지 볼트 모델
 
-- 볼트에 실제로 존재하는 Obsidian `.md` 템플릿이 관리 노트의 frontmatter 형태와 본문 골격을 소유한다.
-- 각 템플릿은 경로·digest와 독립적인 안정적 `templateId`를 가지며, 볼트 전체의 `BaseContract` 하나를 상속한다.
-- `.obsidian/types.json`은 읽기 전용 타입 권위다.
-- 사용자 소유 온톨로지는 계속 활성 상태다. `.oms/template-policy.json`은 노트·필드 의미와 필수값, 형식, 허용값, 기본값, 이름 규칙, 정체성, 바인딩을 기록한다.
-- `.oms/taxonomy.json`은 폴더·링크 의미와 배치를 소유하며, 작성된 폴더 의미는 `folder-ontology` 검색 축으로 노출된다. runtime의 유일한 권위다.
-- `.oms/types.json`은 쓰기·검색용 검증된 파생 projection이다. 직접 편집하지 않는다.
+의미는 사용자에게 남는다. `.oms/template-policy.json` version 4가 승인된 구조이자 의미다. 속성 pool이 type, format, intent를 기록한다. 항상 켜져 있는 default 계층은 비어 있는 상태로 시작해 모든 노트에 적용된다. 선택적인 개별 템플릿은 필드·heading·의미 기준을 추가하거나 좁힐 수만 있고, default를 제거하거나 약화시킬 수 없다. 개별 템플릿이 없는 노트는 그 default 아래의 정상 노트다. 관리되지 않는 frontmatter는 보존하며 검사하지 않는다.
 
-제거된 것은 노트 정체성으로서의 `concept`와 번들 runtime 기본값이지, 의미 계층으로서의 온톨로지가 아니다.
+제품은 속성 이름·폴더·페르소나를 하드코딩하지 않고 Inbox fallback도 없다. 폐기된 것은 노트 정체성으로서의 `concept`와 번들 runtime 기본값이지, 사용자가 서술하는 의미 계층으로서의 온톨로지가 아니다. `.oms/taxonomy.json`은 배치와 폴더·링크의 의미를 기록한다. `.obsidian/types.json`은 읽기 전용 관측값이다. `.oms/types.json`(`oms.types.v2`)은 파생 projection이며 두 번째 권위가 아니다. version 3은 지원하지 않는다. 자동 변환도, 호환 reader도 없다.
 
-## 설정
+노트 파일을 쓰고 고치는 주체는 에이전트다. 쓰기 전에 OMS는 승인된 Markdown, 유효 계약, task binding을 돌려준다. 그다음 디스크에 저장된 바이트를 검사한다. 완료 판정에는 같은 입력에 대한 호스트의 별도 리뷰가 필요하다. 지시 기반(instruction-only) 별도 리뷰도 유효하다. 리뷰어 파일의 바이트가 일치한다는 사실은 호스트가 그 역할을 실제로 실행했다는 증거가 아니다. 기계 검사 통과, 스스로 발급한 PASS, digest는 그 리뷰가 아니며, digest는 인증이 아니라 내용 무결성이다. 계약 설정은 사용자가 정확한 diff를 승인할 때만 compare-and-swap으로 바뀐다. 자동 보정은 사용자가 켜지 않는 한 꺼져 있다. 재시도 예산은 사용자가 정하는 유한한 0 이상의 정수이며 기본값은 2, 0도 허용하고 별도의 상한 3은 없다. 검색은 그 판정을 기다리지 않는다.
 
-Setup은 명시적으로 선택한 템플릿 폴더 안의 기존 템플릿을 재귀 탐색하고
-migration을 제안한다. 노트 타입 기본값을 번들로 강요하지 않으며 노트를
-수정하지 않는다.
+승인된 Markdown은 BOM과 원래 줄바꿈을 포함한 정확한 UTF-8 스냅샷이다. 관리 draft를 편집해도 그 스냅샷은 대체되지 않는다. OMS는 Templater, JavaScript, 전용 token 언어를 해석하거나 실행하지 않는다.
 
-```bash
-oms setup --vault /path/to/vault --dry-run
-oms setup --vault /path/to/vault --yes --approved-digest <표시된-digest>
-```
+ADR-014는 ADR-013을 대체한다. [ACKNOWLEDGMENTS](./ACKNOWLEDGMENTS.md)는 Ouroboros와 Gajae Code의 deep-interview를 설계 아이디어로 밝힌다. 이는 runtime 복제도 연구 결과도 아니다. 저장소의 도식은 설명용 스케치이며 G002 Excalidraw 산출물이 아니다. 이 문서들은 승인된 아키텍처 기록이지 host smoke 결과나 제품 gate 통과가 아니다.
 
-관리 템플릿 변경도 dry-run, 호출자가 검토한 정확한 digest, CAS, transaction, 사후조건 receipt를 거친다.
-
-## 템플릿 흐름
-
-명시적으로 선택한 템플릿 폴더 아래의 모든 `.md`는 템플릿 원본
-후보가 된다. review는 원본을 검증하고 같은 위치의 바이트를 보존하며,
-파일별 등록 절차나 auto/manual 폴더 mode는 필요하지 않다. OMS는
-메타데이터 계약(frontmatter key·type·requiredness·`filledBy`)과 제한된
-본문 구조(ATX heading, fence code block, fence 밖의 ordered/unordered list
-run, `<!-- oms:content -->`, 문서 순서/EOL/BOM/final-newline)를 함께
-도출한다. paragraph, setext heading, 모든 Markdown을 강제한다고 주장하지
-않는다. 원본이 바뀌면 의존하는 템플릿만 pending이 되므로 다른 템플릿
-쓰기는 계속 가능하며, shared authority 변경이나 불일치는 볼트 전체를
-fail-closed 한다.
-
-선택한 폴더의 원본이 바뀌면 호스트에 처음 표시할 알림은 정확히
-`템플릿에 변경이 있습니다`이며, 동작은 정확히 `확인하기`와 `나중에`다.
-처음 알림에는 템플릿 이름·hash·change class를 표시하지 않는다.
-`나중에`는 host-only로 server를 호출하지 않고 interview ledger도 바꾸지
-않는다. `확인하기`는 MCP `write { op: "template", mode: "interview-next" }`로
-선형 resumable interview를 시작한다. 서버가 반환한 다음 질문을 따라
-진행하고 영향 없는 confirmed answer는 보존한다. 모든 필요한 질문 뒤에는
-정확한 최종 digest를 보여주고 사용자가 승인한 경우에만
-`mode: "commit-contracts"`로 `.oms` control만 publish한다. self-approve하지
-않는다. `status`와 search는 계속 읽기 전용이며 boot instruction이 stale한
-long-lived host도 반환된 `templateNotice`를 표시해야 한다.
-
-정확한 CLI review 흐름은 다음과 같다.
+권위 모델은 [아키텍처](./docs/architecture.md), 볼트 파일은 [컨벤션](./docs/conventions.md), leaf 목록은 [CLI 맵](./docs/cli-map.md)에 있다.
 
-```text
-oms template review
-oms template answer <question-id> --answer <JSON> --census-digest <digest> --ledger-digest <digest|null>
-oms template commit --census-digest <digest> --ledger-digest <digest|null> --dry-run
-oms template commit --census-digest <digest> --ledger-digest <digest|null> --yes --approved-digest <digest>
-```
-
-answer는 서버가 반환한 question과 CAS 값을 사용한다. commit은 같은 CAS
-값과 기존 dry-run 또는 yes/approved-digest guard를 함께 사용한다.
+## 설정
 
-정확한 note 생성 사용법은 다음과 같다.
+`oms setup`은 비어 있는 version 4 policy를 제안한다. 노트 타입 기본값을 번들로 넣지 않고 노트를 수정하지도 않는다. 게시는 설정 interview를 거쳐 사용자가 승인한 diff만 기록한다. 모델 수명주기는 setup 시절 플래그가 아니라 `oms model install|select|waive|status`다.
 
-```text
-oms note create [template-id] --body <text>|--body-file <file> [--frontmatter <json>|--frontmatter-file <file>] [--folder <note-folder>]
+```bash
+oms setup --vault /path/to/vault --dry-run
+oms setup --vault /path/to/vault --yes --approved-digest <digest>
 ```
 
-노트 생성 시 배치 우선순위는 명시적 caller folder, taxonomy default, `ask`
-순서이며, 배치가 없다고 contract review를 막지 않는다.
+interview leaf는 `oms template review --proposals`, `oms template answer`, `oms template commit`이다. 서버가 돌려준 question과 compare-and-swap 값을 그대로 전달하고, 세 호출 모두에 같은 `proposals`를 보낸다. parameter 이름을 만들어내지 않는다. 일반 질문, 알 수 없는 노트 값, 노트 오류, 관리되지 않는 속성, 검색은 그 interview를 시작하지 않는다.
+
+호스트 알림 문구는 정확히 `템플릿에 변경이 있습니다`이고 동작은 `확인하기`와 `나중에` 둘뿐이다. 처음 알림에는 템플릿 이름·hash·change class를 표시하지 않는다. `나중에`는 host-only이며 서버를 호출하지 않는다. `확인하기`는 `write { op: "template", mode: "interview-next", proposals }`로 한 번에 한 질문씩 진행하는 resumable interview를 시작한다.
 
 ## CLI
 
 ```text
-oms setup                                      기존 볼트 템플릿 탐색 및 채택
-oms template scan|list|show|add|update|move|remove|default|check|regenerate-types|review|answer|commit
-oms note create|append|update|audit|backfill|get
-oms link check|suggest|apply                   노트 wikilink 점검·제안·적용
 oms bridge add|remove|status                   저장소-볼트 target bridge 관리
-oms search query|context                       명시적 query 실행 또는 구조화 context 조회
-oms index sync|embed|repair|status|clean       파생 검색 상태 관리
 oms graph build|status                         노트 그래프 생성 또는 조회
+oms hook pre|post                              pre/post-tool-use hook 실행
 oms host install|remove|sync|status            호스트 asset과 MCP 등록 관리
-oms package check|update                       OMS 패키지 확인 또는 업데이트
+oms index sync|embed|repair|status|clean       파생 검색 상태 관리
+oms link suggest|check                         노트 wikilink 제안·점검
 oms model install|select|waive|status          로컬 모델 선택 관리
+oms note guide|check|complete|audit|get        노트 안내·검사·완료·감사·조회
+oms package check|update                       OMS 패키지 확인 또는 업데이트
+oms search query|context                       명시적 query 실행 또는 구조화 context 조회
 oms serve mcp|http                             stdio MCP 또는 로컬 HTTP 서버 시작
-oms hook pre|post                              pre/post-tool-use 볼트 가드 실행
+oms setup                                      비어 있는 version 4 policy 제안
 oms status                                     읽기 전용 종합 상태 표시
+oms template scan|list|show|check|regenerate-types|review|answer|commit
 ```
 
-`oh-my-second-brain`은 전체 명령이고 `oms`는 짧은 별칭이다.
+`oh-my-second-brain`은 전체 명령이고 `oms`는 짧은 별칭이다. 이 열네 개 family, 여덟 개 skill, 다섯 개 MCP 도구는 서로 다른 세 집합이다. leaf 대응은 [CLI 맵](./docs/cli-map.md)에 있다.
 
 ### 도움말 계약
 
-인식된 모든 명령은 `--help`와 `-h`를 받아들이며, exit 0으로 종료하고
-부작용을 수행하지 않는다. 알 수 없는 명령에 `--help`를 함께 주면 exit 1로 종료한다.
-
-`oms search query <text>`는 lexical-only다. `--vec`, `--hyde`는 각각의
-typed channel을 선택하고, `--expand`는 G004 expansion을 명시적으로
-켜며, `--max-queries`는 1부터 32까지의 정수만 받는다. `--rerank`도
-opt-in이다. `oms search context`는 별도의 구조화 context 표면이다.
-Embedding은 명시적으로 `oms index embed`를 사용하며 sync와 repair는
-서로 다른 index mode다. `oms index status --view status|collections|contexts`는
-세 읽기 전용 view를 모두 보존하고, `oms index clean`은 제거 가능한 파생
-상태를 정리한다.
-
-Vector 검색에는 검증된 로컬 embedding capability가 필요하다. 선택 경로는
-완전한 `OMS_EMBEDDING_PROVIDER`/`OMS_EMBEDDING_MODEL` 쌍, vault의
-`.oms/models.json`과 검증된 설치 receipt, 또는 setup-installed default다.
-HyDE에는 resolved generate capability가, reranking에는 resolved rerank
-capability가 필요하다. 각각의 완전한 환경변수 쌍은
-`OMS_GENERATE_PROVIDER`/`OMS_GENERATE_MODEL`과
-`OMS_RERANK_PROVIDER`/`OMS_RERANK_MODEL`이다. 누락되거나 불완전하거나
-설치되지 않은 선택은 크게 실패한다. G004
-expansion은 명시적으로 사용할 수 있는 기능이며, 교체·parity·outperformance를
-주장하지 않는다.
-Setup에서는 로컬 검증 acquisition 정책 하나를 선택한다:
-`--models-default`, `--models-descriptor <path>`, `--models-no-default`.
+인식된 모든 명령은 `--help`와 `-h`를 받아들이며, exit 0으로 종료하고 부작용을 수행하지 않는다. 알 수 없는 명령에 `--help`를 함께 주면 exit 1로 종료한다.
+
+`oms search query <text>`는 lexical-only다. `--vec`와 `--hyde`는 각각의 channel을 선택하고, `--expand`는 G004 expansion을 명시적으로 켜며, `--max-queries`는 1부터 32까지의 정수만 받는다. `--rerank`도 opt-in이다. `oms search context`는 별도의 구조화 context 표면이다. Embedding은 `oms index embed`이며 sync와 repair는 서로 다른 index mode다. `oms index status --view status|collections|contexts`는 세 읽기 전용 view를 모두 보존하고, `oms index clean`은 제거 가능한 파생 상태를 정리한다.
+
+lexical, vector, HyDE, typed-axis 질의는 템플릿에 결속되지 않았거나 계약을 어겼거나 미완성인 노트도 계속 포함한다. 계약이 없거나 손상되어도 검색은 멈추지 않는다. Vector 검색에는 완전한 `OMS_EMBEDDING_PROVIDER`/`OMS_EMBEDDING_MODEL` 쌍이 필요하다. HyDE에는 `OMS_GENERATE_PROVIDER`/`OMS_GENERATE_MODEL`이, reranking에는 `OMS_RERANK_PROVIDER`/`OMS_RERANK_MODEL`이 추가로 필요하다. 누락되거나 불완전하거나 설치되지 않은 선택은 크게 실패한다. G004 expansion은 명시적으로 선택할 때만 쓰이며 교체·parity·outperformance를 주장하지 않는다.
+
+`guide`는 노트를 쓰지 않는다. 에이전트가 파일을 저장한 뒤 `check`가 그 파일을 읽고, 별도 리뷰 후 `complete`가 같은 입력을 다시 읽는다. create, append, update, backfill은 노트 동작이 아니다. link apply도 동작이 아니다. template add, update, move, remove, default도 동작이 아니다. 폐기된 그 동작들을 위한 version 3 변환, 노트 renderer, 호환 경로는 없다.
 
 ## MCP 도구
 
@@ -126,18 +66,11 @@ Setup에서는 로컬 검증 acquisition 정책 하나를 선택한다:
 
 `write` · `search` · `link` · `status` · `doctor`
 
-일곱 스킬(`write`, `search`, `link`, `distill`, `status`, `doctor`, `template`)은 워크플로 안내이며 MCP 도구와 같은 집합이 아니다. 세부 기능은 다섯 도구의 `op` 값으로 제공한다.
-
-쓰기는 하나의 `ResolvedTemplate`을 해석해 create, append, update를 수행한다. 템플릿 변경, projection 재생성, 한 노트 정체성 backfill은 검증된 target과 명시적 승인 digest가 필요하다. `status`와 모든 검색 동작은 읽기 전용이다.
+여덟 skill(`distill`, `doctor`, `interview`, `link`, `search`, `status`, `template`, `write`)은 호스트 워크플로다. `interview`와 `template`은 도구가 없다.
 
-템플릿 contract review는 `oms_write`의 `op: "template"`에서 정확히
-`interview-next`, `interview-answer`, `commit-contracts` mode를 사용한다.
-정확한 CLI 대응은 `oms template review`, `oms template answer`,
-`oms template commit`이다. answer는 서버가 반환한 question, request, CAS
-field를 그대로 사용하며 parameter 이름을 만들지 않는다. 질문이 0개면
-곧바로 최종 확인으로 간다.
+다섯 도구는 그 skill의 부분집합이고, 어느 쪽도 열네 개 CLI family와 같지 않다. 세부 기능은 다섯 도구의 `op` 값으로 남는다.
 
-일반 lexical 검색은 projection과 독립적이다. 템플릿·선언 필드·폴더·링크 축은 쓰기와 같은 projection을 사용하며 누락·stale 상태를 크게 실패시킨다. 관리 템플릿 원본은 검색 대상에서 제외한다. Vector/HyDE는 provider와 model이 모두 설정되지 않으면 가짜 대체 없이 실패한다.
+`write`는 interview 답변과 승인된 계약 게시가 관리 상태를 바꾸기 때문에 쓰기 posture를 유지한다. `guide`, `check`, `complete`는 볼트 바이트를 쓰지 않는다. 계약 review는 `op: "template"`의 `interview-next`, `interview-answer`, `commit-contracts` mode만 사용한다. `status`와 모든 검색 동작은 읽기 전용이며 완료를 대신 판정하지 않는다. `doctor` 도구는 control과 index를 진단하며 노트를 backfill하지 않는다.
 
 ## 설치
 
@@ -148,21 +81,12 @@ npm install -g oh-my-second-brain
 oms host install --runtime all --vault /path/to/vault --yes
 ```
 
-Gajae-Code에서는 npm 패키지를 marketplace plugin으로 설치한다: `gjc plugin install oms@oms`. GJC는 패키지 루트의 `skills/` convention path에서 일곱 OMS skill을 발견한다.
+Gajae-Code에서는 npm 패키지를 marketplace plugin으로 설치한다: `gjc plugin install oms@oms`. GJC는 패키지 루트의 `skills/` convention path에서 여덟 개 OMS skill을 발견한다.
 
-호스트 설치는 canonical 볼트를
-`${XDG_CONFIG_HOME:-~/.config}/oms/vault.json`에 기록하고 각 관리형
-등록에 `oms serve mcp --vault /path/to/vault`를 넣는다.
-`oms host install|remove|sync|status`만 이 서명된 포인터로 호스트 통합을
-관리한다.
-`oms package update`는 패키지만 업데이트하고 호스트를 암묵적으로
-동기화하지 않는다. `oms host sync`는 별도로 실행한다.
+호스트 설치는 canonical 볼트를 `${XDG_CONFIG_HOME:-~/.config}/oms/vault.json`에 기록하고 각 관리형 등록에 `oms serve mcp --vault /path/to/vault`를 넣는다. `oms host install|remove|sync|status`만 이 서명된 포인터로 호스트 통합을 관리한다. `oms package update`는 패키지만 업데이트하고 호스트를 암묵적으로 동기화하지 않는다. `oms host sync`는 별도로 실행한다.
 
-런타임 쓰기·검색 target 해석은 호스트 관리 포인터를 읽지 않는다.
-우선순위는 명시적 target, 로컬 볼트 control, bridge, `OMS_VAULT`, 그리고
-안전한 읽기 전용 fallback으로서의 cwd 순서다. 변경 작업은 cwd fallback을
-사용할 수 없다.
+런타임 target 해석은 호스트 관리 포인터를 읽지 않는다. 우선순위는 명시적 target, 로컬 볼트 control, bridge, `OMS_VAULT`, 그리고 읽기 전용 fallback으로서의 cwd 순서다. cwd fallback에서는 계약 게시와 파생 상태 보정을 할 수 없다.
 
-`OMS_VAULT`는 명시적·로컬·bridge target이 없을 때 사용하는 지원 환경변수 fallback이다.
+`OMS_VAULT`는 명시적·로컬·bridge target이 없을 때 사용하는 환경변수 fallback이다.
 
 자세한 내용은 [설치](./docs/install.md), [아키텍처](./docs/architecture.md), [컨벤션](./docs/conventions.md), [검증된 target](./docs/verified-target.md)을 참고한다.

package/README.md

@@ -1,121 +1,64 @@
 # Oh My Second Brain
 
-Oh My Second Brain (`oms`) connects an existing Obsidian or Markdown vault to AI hosts without taking ownership of its notes. The vault remains plain Markdown.
+Oh My Second Brain (`oms`) connects an existing Obsidian or Markdown vault to AI hosts without taking ownership of its notes. The vault remains plain Markdown. Obsidian stays the command center: the notes are still files a person can read and edit when OMS is not running. OMS does not invent the meaning of a property, a folder, or a heading.
 
 ## Template and ontology vault model
 
-- Actual vault-resident Obsidian `.md` templates own managed frontmatter shape and body scaffolding.
-- Each template has a stable `templateId`, independent of its path and digest, and inherits one vault-wide `BaseContract`.
-- `.obsidian/types.json` is read-only type authority.
-- The user-owned ontology remains active: `.oms/template-policy.json` records note/field meaning alongside requiredness, formats, allowed values, defaults, naming, identity, and bindings.
-- `.oms/taxonomy.json` records folder/link meaning and owns placement; authored folder intents are exposed through the `folder-ontology` search axis. It is the sole runtime authority.
-- `.oms/types.json` is a validated derived write/search projection. Never hand-edit it.
+Meaning stays with the user. Version 4 of `.oms/template-policy.json` is the approved structure and meaning. A property pool records type, format, and intent. An always-on default layer starts empty and applies to every note. An optional individual template may only add or tighten fields, headings, and semantic criteria. It cannot remove or weaken the default. A note with no individual template is an ordinary note under that default. Unmanaged frontmatter is kept and is not checked.
 
-The retired model is `concept` as note identity and bundled runtime defaults—not ontology as semantic meaning.
+The product hardcodes no property names, folders, or personas, and it has no Inbox fallback. What was retired is `concept` as note identity and bundled runtime defaults, not ontology as the user's account of meaning. `.oms/taxonomy.json` records placement and what folders and links mean. `.obsidian/types.json` is a read-only observation. `.oms/types.json` (`oms.types.v2`) is a derived projection, not a second authority. Version 3 is unsupported: there is no migration and no compatibility reader.
 
-## Setup
+The agent writes and repairs note files. Before that write, OMS returns the approved Markdown, the effective contract, and a task binding. It then checks the bytes saved on disk. Completion requires a separate host review of those same inputs. A separate instruction-only review is valid. Matching reviewer-file bytes are not proof the host launched that role. A machine pass, a self-issued PASS, or a digest is not that review, and a digest is content integrity rather than authentication. Contract configuration changes only when the user approves the exact diff, by compare-and-swap. Repair is off unless the user enables it. The retry budget is that user's finite nonnegative integer, default 2, including 0, with no separate cap of 3. Search does not wait on that review.
 
-Setup recursively discovers existing templates within explicitly selected
-template folders and proposes migration. It ships no note-type defaults and
-never modifies notes.
+Approved Markdown is the exact UTF-8 snapshot, including any BOM and the original line endings. Editing the managed draft does not replace that snapshot. OMS does not parse or execute Templater, JavaScript, or a private token language.
 
-```bash
-oms setup --vault /path/to/vault --dry-run
-oms setup --vault /path/to/vault --yes --approved-digest <shown-digest>
-```
+ADR-014 supersedes ADR-013. [ACKNOWLEDGMENTS](./ACKNOWLEDGMENTS.md) credits Ouroboros and Gajae Code's deep-interview as design ideas. Those credits are not a copied runtime and not a research result. Diagrams in this repository are explanatory sketches. They are not the G002 Excalidraw artifact. These pages record the approved architecture. They are not a host-smoke result and not a product-gate pass.
 
-Managed-template changes use the same dry-run, exact caller approval, compare-and-swap, transaction, and postcondition receipt boundary.
-
-## Template workflow
-
-An explicitly selected template folder makes every `.md` beneath it a template
-source candidate. Review verifies the source and preserves its bytes in place;
-no per-file registration or auto/manual folder mode is required. OMS derives
-both metadata (frontmatter keys, types, requiredness, and `filledBy`) and a
-bounded body structure (ATX headings, fenced code blocks, ordered/unordered
-list runs outside fences, `<!-- oms:content -->`, and document
-order/EOL/BOM/final-newline details). It does not claim to enforce paragraphs,
-setext headings, or all Markdown. A changed source makes only its dependent
-template pending, so unrelated writes remain available; shared-authority
-changes or mismatches fail closed for the whole vault.
-
-When a selected-folder source changes, the initial host notice is exactly
-`템플릿에 변경이 있습니다` with exactly `확인하기` and `나중에`; it names no
-template and shows no hash or change class. `나중에` is host-only and makes no
-server call or ledger mutation. `확인하기` starts a linear, resumable interview
-through MCP `write { op: "template", mode: "interview-next" }`. Continue with
-the server-returned next question, preserving unaffected confirmed answers.
-After all necessary questions, show the exact final digest and publish only
-`.oms` controls after the user approves it with `mode: "commit-contracts"`; never
-self-approve. `status` and search remain read-only, and long-lived hosts
-surface a returned `templateNotice` even when boot instructions are stale.
-
-The exact CLI review flow is:
+The authority model is in [architecture](./docs/architecture.md). Vault files are in [conventions](./docs/conventions.md). Leaves are in [the CLI map](./docs/cli-map.md).
 
-```text
-oms template review
-oms template answer <question-id> --answer <JSON> --census-digest <digest> --ledger-digest <digest|null>
-oms template commit --census-digest <digest> --ledger-digest <digest|null> --dry-run
-oms template commit --census-digest <digest> --ledger-digest <digest|null> --yes --approved-digest <digest>
-```
-
-Answer uses the server-returned question and CAS values. Commit uses the same
-CAS values plus the existing dry-run or yes/approved-digest guard.
+## Setup
 
-The exact note-create usage is:
+`oms setup` proposes an empty version-4 policy. It ships no note-type defaults and never modifies notes. Publication goes through the config interview and writes only the user-approved diff. Model lifecycle is `oms model install|select|waive|status`, not a setup-era model flag.
 
-```text
-oms note create [template-id] --body <text>|--body-file <file> [--frontmatter <json>|--frontmatter-file <file>] [--folder <note-folder>]
+```bash
+oms setup --vault /path/to/vault --dry-run
+oms setup --vault /path/to/vault --yes --approved-digest <digest>
 ```
 
-At note creation, placement is explicit caller folder, then the taxonomy
-default, then `ask`; missing placement does not block contract review.
+The interview leaves are `oms template review --proposals`, `oms template answer`, and `oms template commit`. Forward the question and compare-and-swap fields the server returns, and send the same `proposals` on every call. Do not invent parameter names. A general question, an unknown note value, a note error, an unmanaged property, or a search does not start that interview.
+
+The host notice text is exactly `템플릿에 변경이 있습니다` and its actions are exactly `확인하기` and `나중에`. The first notice shows no template name, hash, or change class. `나중에` is host-only and makes no server call. `확인하기` starts a resumable one-question interview at `write { op: "template", mode: "interview-next", proposals }`.
 
 ## CLI
 
 ```text
-oms setup                                      Discover and adopt existing vault templates
-oms template scan|list|show|add|update|move|remove|default|check|regenerate-types|review|answer|commit
-oms note create|append|update|audit|backfill|get
-oms link check|suggest|apply                   Check, suggest, or apply note wikilinks
 oms bridge add|remove|status                   Manage repository-to-vault target bridges
-oms search query|context                       Run an explicit query or retrieve structured context
-oms index sync|embed|repair|status|clean       Manage derived search state
 oms graph build|status                         Build or inspect the note graph
+oms hook pre|post                              Run pre- or post-tool-use hooks
 oms host install|remove|sync|status            Manage host assets and MCP registrations
-oms package check|update                       Check or update the OMS package
+oms index sync|embed|repair|status|clean       Manage derived search state
+oms link suggest|check                         Suggest or check note wikilinks
 oms model install|select|waive|status          Manage local model selection
+oms note guide|check|complete|audit|get        Guide, check, complete, audit, or read a note
+oms package check|update                       Check or update the OMS package
+oms search query|context                       Run an explicit query or retrieve structured context
 oms serve mcp|http                             Start the stdio MCP or local HTTP server
-oms hook pre|post                              Run pre- or post-tool-use vault guards
+oms setup                                      Propose an empty version-4 policy
 oms status                                     Show the read-only aggregate status
+oms template scan|list|show|check|regenerate-types|review|answer|commit
 ```
 
-`oh-my-second-brain` is the full command; `oms` is its short alias.
+`oh-my-second-brain` is the full command; `oms` is its short alias. These fourteen families, the eight skills, and the five MCP tools are three different sets. The leaf map is [the CLI map](./docs/cli-map.md).
 
 ### Help contract
 
-Every recognized command accepts `--help` and `-h`, exits 0, and performs no
-side effects. An unknown command combined with `--help` exits 1.
-
-`oms search query <text>` is lexical-only. `--vec` and `--hyde` select their
-respective typed channels; `--expand` explicitly enables G004 expansion,
-`--max-queries` accepts an integer from 1 through 32, and `--rerank` is opt-in.
-`oms search context` is the separate structured-context surface. Embedding is
-explicitly `oms index embed`; sync and repair are distinct index modes.
-`oms index status --view status|collections|contexts` preserves all three
-read-only views, while `oms index clean` removes eligible derived state.
-
-Vector search requires a verified local embedding capability, selected by a
-complete `OMS_EMBEDDING_PROVIDER`/`OMS_EMBEDDING_MODEL` pair, the vault's
-`.oms/models.json` plus its verified installed receipt, or a setup-installed
-default. HyDE also requires a resolved generate capability; reranking requires
-a resolved rerank capability. Their complete environment pairs are
-`OMS_GENERATE_PROVIDER`/`OMS_GENERATE_MODEL` and
-`OMS_RERANK_PROVIDER`/`OMS_RERANK_MODEL`. Missing, incomplete, or uninstalled
-selections fail loudly. G004 expansion is an explicit
-available capability; it makes no replacement, parity, or outperformance claim.
-During setup, choose one local verified acquisition policy:
-`--models-default`, `--models-descriptor <path>`, or `--models-no-default`.
+Every recognized command accepts `--help` and `-h`, exits 0, and performs no side effects. An unknown command combined with `--help` exits 1.
+
+A plain `oms search query <text>` is lexical-only. `--vec` and `--hyde` select their respective channels; `--expand` explicitly enables G004 expansion, `--max-queries` accepts an integer from 1 through 32, and `--rerank` is opt-in. `oms search context` is the separate structured-context surface. Embedding is `oms index embed`; sync and repair are distinct index modes. `oms index status --view status|collections|contexts` preserves all three read-only views, while `oms index clean` removes eligible derived state.
+
+Lexical, vector, HyDE, and typed-axis queries still include unbound, invalid, and incomplete notes. A missing or damaged contract does not stop search. Vector search requires a complete `OMS_EMBEDDING_PROVIDER`/`OMS_EMBEDDING_MODEL` pair. HyDE also requires `OMS_GENERATE_PROVIDER`/`OMS_GENERATE_MODEL`. Reranking requires `OMS_RERANK_PROVIDER`/`OMS_RERANK_MODEL`. Missing, incomplete, or uninstalled selections fail loudly. G004 expansion is an explicit available capability; it makes no replacement, parity, or outperformance claim.
+
+`guide` does not write the note. After the agent saves the file, `check` reads that file. `complete` reads it again after a separate review. Create, append, update, and backfill are not note operations. Link apply is not an operation. Template add, update, move, remove, and default are not operations. There is no version-3 migration, note renderer, or compatibility path for those retired operations.
 
 ## MCP tools
 
@@ -123,18 +66,11 @@ During setup, choose one local verified acquisition policy:
 
 `write` · `search` · `link` · `status` · `doctor`
 
-The seven skills (`write`, `search`, `link`, `distill`, `status`, `doctor`, `template`) are workflow guidance, not a tool-equality list. Detail capabilities remain `op` values under the five tools.
-
-Writes resolve one `ResolvedTemplate` and support create, append, and update. Template mutation, projection regeneration, and one-note identity backfill require a verified target and explicit approval digest. `status` and every search operation are read-only.
+The eight skills (`distill`, `doctor`, `interview`, `link`, `search`, `status`, `template`, `write`) are host workflows. `interview` and `template` are tool-less.
 
-Template contract review uses `oms_write` with `op: "template"` and exactly
-`interview-next`, `interview-answer`, and `commit-contracts` modes. The exact
-CLI counterparts are `oms template review`, `oms template answer`, and
-`oms template commit`. Answer submissions use the server-returned question,
-request, and CAS fields; hosts must not invent parameter names. A zero-question
-response proceeds directly to final confirmation.
+The five tools are a subset of those skills, and neither set is the fourteen CLI families. Detail capabilities remain `op` values under the five tools.
 
-Plain lexical search is projection-independent. Typed template/declared-field/folder/link axes use the same projection as writes and fail loudly when it is missing or stale. Managed template sources are excluded. Vector and HyDE requests fail loudly unless both embedding provider and model are configured.
+`write` keeps a write posture because interview answers and approved contract publication change managed state. `guide`, `check`, and `complete` write no vault bytes. Contract review uses `op: "template"` with `interview-next`, `interview-answer`, and `commit-contracts` only. `status` and every search operation are read-only and do not decide completion. The `doctor` tool diagnoses controls and indexes; it does not backfill notes.
 
 ## Install
 
@@ -145,15 +81,12 @@ npm install -g oh-my-second-brain
 oms host install --runtime all --vault /path/to/vault --yes
 ```
 
-For Gajae-Code, install the npm package as a marketplace plugin: `gjc plugin install oms@oms`. GJC discovers the seven OMS skills at the package-root `skills/` convention path.
+For Gajae-Code, install the npm package as a marketplace plugin: `gjc plugin install oms@oms`. GJC discovers the eight OMS skills at the package-root `skills/` convention path.
 
 Host installation records the canonical vault in `${XDG_CONFIG_HOME:-~/.config}/oms/vault.json` and stamps `oms serve mcp --vault /path/to/vault` into each managed host entry. `oms host install|remove|sync|status` use that signed pointer only to maintain host integrations. `oms package update` updates the package but never syncs hosts implicitly; run `oms host sync` separately.
 
-Runtime write/search target resolution never reads the host-maintenance pointer.
-Its precedence is explicit target, local vault controls, bridge, `OMS_VAULT`,
-then cwd only as a safe read-only fallback. Mutations cannot use the cwd
-fallback.
+Runtime target resolution never reads the host-maintenance pointer. Its precedence is explicit target, local vault controls, bridge, `OMS_VAULT`, then the current directory only as a safe read-only fallback. Control and derived-state mutations cannot use that fallback. Note `guide`, `check`, and `complete` read rather than write ordinary notes; their task binding, contract publication, and derived-state repair still require a verified target.
 
 `OMS_VAULT` is the supported environment fallback when no explicit, local, or bridge target exists.
 
-See [installation](./docs/install.md), [architecture](./docs/architecture.md), [conventions](./docs/conventions.md), and [verified targets](./docs/verified-target.md).
+See [installation](./docs/install.md), [architecture](./docs/architecture.md), [conventions](./docs/conventions.md), [the CLI map](./docs/cli-map.md), [host assets](./docs/adapters.md), and [verified targets](./docs/verified-target.md).