oh-my-wiki 2.7.0__tar.gz

oh_my_wiki-2.7.0/.claude-plugin/marketplace.json

@@ -0,0 +1,10 @@
+{
+  "name": "oh-my-wiki-marketplace",
+  "description": "oh-my-wiki — the Karpathy LLM Wiki skill, distributed as its own marketplace. After `/plugin marketplace add dandacompany/oh-my-wiki`, install with `/plugin install oh-my-wiki@oh-my-wiki-marketplace`.",
+  "plugins": [
+    {
+      "name": "oh-my-wiki",
+      "manifest": "./.claude-plugin/plugin.json"
+    }
+  ]
+}

oh_my_wiki-2.7.0/.claude-plugin/plugin.json

@@ -0,0 +1,58 @@
+{
+  "name": "oh-my-wiki",
+  "version": "2.7.0",
+  "description": "Karpathy-style LLM Wiki skill with multi-vault sqlite registry. Capture sources, build a structured wiki, query it with cited answers. Also addressable as 'omw'.",
+  "author": "dandacompany",
+  "license": "MIT",
+  "homepage": "https://github.com/dandacompany/oh-my-wiki",
+  "repository": "https://github.com/dandacompany/oh-my-wiki",
+  "trigger_keywords": [
+    "open my wiki",
+    "ingest this",
+    "find a note about X",
+    "what does my wiki say about X",
+    "omw",
+    "use omw",
+    "/omw",
+    "위키 열어줘",
+    "이거 정리해줘",
+    "X 관련 노트 찾아줘",
+    "위키에 물어봐",
+    "오엠더블유",
+    "autoresearch this",
+    "research this for me",
+    "이거 리서치해줘",
+    "이거 조사해줘",
+    "fact-check this",
+    "verify the claims",
+    "check this for contradictions",
+    "build a glossary",
+    "팩트체크해줘",
+    "모순 있는지 봐줘",
+    "용어집 만들어줘"
+  ],
+  "ops": [
+    "vault-setup",
+    "vault-use",
+    "vault-list",
+    "vault-forget",
+    "vault-import-memo",
+    "create",
+    "find",
+    "open",
+    "edit",
+    "move",
+    "delete",
+    "ingest",
+    "query",
+    "autoresearch",
+    "persona-factcheck",
+    "persona-consistency",
+    "persona-terminology",
+    "lint",
+    "hot-cache"
+  ],
+  "skill_path": "./SKILL.md",
+  "commands_path": "./commands",
+  "scripts_path": "./scripts"
+}

oh_my_wiki-2.7.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dante (datapod.k@gmail.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

oh_my_wiki-2.7.0/MANIFEST.in

@@ -0,0 +1,21 @@
+# Include the repo-root bundle dirs in the sdist so a wheel built FROM the sdist
+# (e.g. `pip install --no-binary oh-my-wiki`) can still run setup.py's build_py
+# bundle copy. A directly-built wheel doesn't need these (build_py reads them
+# from the working tree), but an sdist must carry the source to stay buildable.
+graft schemas
+graft personas
+graft backends
+graft commands
+graft omw
+graft references
+graft hooks
+graft .claude-plugin
+
+# Root files the build-time bundle copy needs in the sdist (README is also the
+# PyPI long-description source; SKILL.md is the skill entry point).
+include README.md
+include SKILL.md
+
+global-exclude __pycache__ *.pyc *.pyo
+global-exclude *.egg-info
+prune scripts/_bundle

oh_my_wiki-2.7.0/PKG-INFO

@@ -0,0 +1,261 @@
+Metadata-Version: 2.4
+Name: oh-my-wiki
+Version: 2.7.0
+Summary: Karpathy-style LLM Wiki skill with multi-vault sqlite registry and Socratic wizard
+Author: dandacompany
+License-Expression: MIT
+Keywords: wiki,llm,rag,sqlite,knowledge-base,claude,agent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: pypdf>=4.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-rerunfailures>=14; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Provides-Extra: wizard
+Requires-Dist: questionary>=2.0; extra == "wizard"
+Provides-Extra: embedding
+Requires-Dist: sqlite-vec>=0.1; extra == "embedding"
+Requires-Dist: openai>=1.0; extra == "embedding"
+Dynamic: license-file
+
+# oh-my-wiki (OMW)
+
+[![CI](https://github.com/dandacompany/oh-my-wiki/actions/workflows/ci.yml/badge.svg)](https://github.com/dandacompany/oh-my-wiki/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-6C5CE7)](https://github.com/dandacompany/oh-my-wiki#install)
+[![skillsmp](https://img.shields.io/badge/skills.sh-oh--my--wiki-1abc9c)](https://skills.sh/)
+
+A host-universal LLM-wiki you drive from your AI coding agent (Claude Code / Codex / Gemini).
+
+oh-my-wiki exposes exactly two surfaces. The **`omw` CLI** handles deterministic ops — `omw setup`, `omw vault create`, `omw lint`, `omw schema list`, `omw supersede`, `omw review`, `omw links`, `omw fields`, `omw view`, `omw doctor` — with no LLM required. The **`omw` skill** brings natural-language reasoning inside your AI session: ingest, query, autoresearch, and a small set of wiki-maintenance personas (librarian, curator, fact-checker, consistency-checker, terminology-manager). The model is _personas propose → you confirm → deterministic ops execute_, so every file change is auditable. omw stays focused on the wiki — multi-step orchestration is left to your host AI agent (Claude Code / Codex / Gemini), not reimplemented here.
+
+**Short alias:** `OMW` (lowercase `omw`). Both `oh-my-wiki` and `omw` register as skills and respond to the same trigger phrases.
+
+**Tutorial:** Walk through real dialogs and verified CLI examples in [TUTORIAL.md](./TUTORIAL.md) (English) or [TUTORIAL.ko.md](./TUTORIAL.ko.md) (한국어).
+
+---
+
+## What's new in v3
+
+- **Schemas** — 13 built-in page types (`omw schema list/show`), with per-vault overrides in `<vault>/schemas/`
+- **Confidence + supersede** — `confidence` frontmatter field; `omw supersede` retires old pages cleanly
+- **Review queue (SR)** — spaced-repetition via `omw review due` / `omw review done`
+- **Web search** — `omw search` queries an external provider (brave/tavily/exa/…); `omw serve` exposes vault FTS5 as a local retrieve-only HTTP API on port 8765
+- **Entity-linking** — `omw links suggest` / `omw links link` auto-inserts `[[slug|Name]]` references
+- **Inline fields** — `omw fields` reads `key::` inline syntax alongside frontmatter
+- **Korean matching** — Korean entity names with josa (`카르파시가`) are suggested and linked correctly
+- **Note viewers** — `omw view` opens the active vault, a page, or a search in Obsidian or Logseq (URI schemes, no plugin needed); `omw setup viewer` scaffolds the viewer config
+- **Visibility (secure-by-default)** — `omw visibility get/set` marks pages `public`/`private`; `omw serve` exposes only public pages
+- **URL inbox + fetch** — `omw fetch <url>` saves a web page or YouTube transcript to `raw/` (tiered urllib → chromium → cloud, SSRF-guarded); `omw inbox add/list/run/remove` queues URLs for batch fetch
+
+---
+
+## Install
+
+Choose whichever path fits your environment. After any path, run `omw doctor` to confirm everything is wired correctly.
+
+### Path A — Skills CLI (recommended for Claude Code users)
+
+```bash
+skills add dandacompany/oh-my-wiki@oh-my-wiki -g -y --copy -a claude-code
+```
+
+This installs the skill into `~/.claude/skills/` and registers both the `oh-my-wiki` and `omw` short-alias skill names.
+
+### Path B — Claude Code plugin marketplace
+
+In any Claude Code session:
+
+```
+/plugin marketplace add dandacompany/oh-my-wiki
+/plugin install oh-my-wiki@oh-my-wiki-marketplace
+```
+
+Update later with `/plugin marketplace update oh-my-wiki-marketplace`.
+
+### Path C — git clone + install script (developers, Codex CLI users)
+
+```bash
+git clone https://github.com/dandacompany/oh-my-wiki
+cd oh-my-wiki
+bash bin/install.sh
+```
+
+The installer checks for Python 3.10+, pip-installs the package editable, creates `~/.claude/skills/oh-my-wiki` and `~/.claude/skills/omw` symlinks (idempotent), runs `pytest -q` to verify, and prints next steps. Add `--dev` to include pytest/ruff extras. Use `--force` to replace existing symlinks without a prompt; `--no-test` to skip the test step. Run `bash bin/install.sh --help` for all flags.
+
+### Verify the install
+
+```
+omw doctor
+```
+
+```
+omw home:   /Users/you/.omw  ok
+registry:   /Users/you/.omw/registry.db  ok
+  * demo (wiki/markdown) /Users/you/.omw/vaults/demo
+```
+
+---
+
+## Quickstart (~60 seconds)
+
+**Step 1 — Run the setup wizard**
+
+```
+omw setup
+```
+
+Follow the prompts to configure your first vault, search provider, and persona preferences. Accept the defaults for a fast start.
+
+**Step 2 — Check status**
+
+```
+omw status
+```
+
+```json
+{
+  "vault_count": 0,
+  "active": null,
+  "needs": "setup",
+  "vaults": []
+}
+```
+
+**Step 3 — Create your first vault**
+
+```
+omw vault create demo --mode wiki
+```
+
+```json
+{
+  "created": "demo",
+  "path": "~/.omw/vaults/demo",
+  "mode": "wiki",
+  "type": "markdown"
+}
+```
+
+```
+omw vault list
+```
+
+```json
+[
+  {
+    "name": "demo",
+    "path": "~/.omw/vaults/demo",
+    "mode": "wiki",
+    "type": "markdown",
+    "is_active": true
+  }
+]
+```
+
+**Step 4 — Add a note (in your AI session)**
+
+Open Claude Code (or Codex / Gemini) and say:
+
+```
+ingest this
+
+Andrej Karpathy calls the LLM Wiki a "compounding knowledge artifact". Every
+source gets saved verbatim to raw/, a summary lands at wiki/summaries/, and
+the entities and concepts that appeared get their own pages. 10–15 page touches
+per ingest is normal.
+```
+
+**Step 5 — Run a lint check**
+
+```
+omw lint
+```
+
+```json
+{
+  "vault_id": 1,
+  "vault_path": "~/.omw/vaults/demo",
+  "frontmatter_issues": [],
+  "drift": { "missing_files": [], "mtime_drift": [] },
+  "links": {
+    "broken": [],
+    "orphans": [],
+    "index_drift": { "missing_from_index": [], "dangling_in_index": [] },
+    "contradictions": [],
+    "supersedes": [],
+    "superseded_unmarked": [],
+    "link_suggestions": []
+  },
+  "auto_fix_hints": []
+}
+```
+
+→ Full tutorial: [TUTORIAL.md](TUTORIAL.md) · [한국어](TUTORIAL.ko.md)
+
+---
+
+## Architecture
+
+```
+SKILL.md dispatcher → commands/<op>.md (LLM procedure) → scripts/<op>.py (deterministic I/O)
+                                                       └─ registry.py → ~/.omw/registry.db (sqlite)
+                                                       └─ adapters.py → filesystem (markdown / obsidian)
+```
+
+The 17 CLI subcommands:
+
+| Subcommand   | Purpose                                                              |
+| ------------ | -------------------------------------------------------------------- |
+| `status`     | Show active vault and registry state                                 |
+| `vault`      | Create, list, use, forget vaults                                     |
+| `lint`       | Structural health check (frontmatter + links)                        |
+| `search`     | Web search via the configured external provider (brave/tavily/exa/…) |
+| `serve`      | Local retrieve-only HTTP query API (port 8765) — public pages only   |
+| `view`       | Open the vault / a page / a search in Obsidian or Logseq             |
+| `visibility` | Get / set a page's public/private visibility (`get` / `set`)         |
+| `schema`     | List / inspect page-type schemas                                     |
+| `supersede`  | Mark a page superseded by a newer one                                |
+| `review`     | Spaced-repetition review queue (due / done)                          |
+| `links`      | Suggest and insert `[[slug]]` entity links                           |
+| `fields`     | Read frontmatter + inline `key::` fields                             |
+| `import`     | Import an existing folder as a vault                                 |
+| `fetch`      | Fetch one URL (web page / YouTube transcript) into `raw/`            |
+| `inbox`      | Queue URLs and batch-fetch them into `raw/` (add/list/run/remove)    |
+| `setup`      | Interactive setup wizard                                             |
+| `doctor`     | Verify install health                                                |
+
+> **Visibility (secure-by-default):** `omw serve` returns only pages with
+> `visibility: public` in their frontmatter. Pages without the field are treated as
+> private and never served. Publish pages explicitly with
+> `omw visibility set <relpath...> public`.
+
+The skill also exposes natural-language ops via your AI session: `ingest`, `query`, `autoresearch`, `find`, `edit`, `move`, `delete`, and wiki-maintenance persona invocations (`fact-check`, `consistency-check`, `build glossary`).
+
+---
+
+## Storage
+
+- The vault registry lives at `~/.omw/registry.db` (override with `OMW_HOME`) as a per-user sqlite database.
+- The note index is regenerated by `scripts/reindex.py` after every mutation.
+- Your files stay in the vault path you chose. oh-my-wiki never touches them outside the op you explicitly invoked.
+
+---
+
+## Development
+
+- `pytest -v` runs all tests.
+- `ruff check scripts/ tests/` runs the linter.
+- `omw status` inspects the registry/vault state.
+- `python3 -m scripts.lint --vault-id N` runs the health check on a specific vault.
+
+Continuous integration runs on GitHub Actions, across a matrix of Python 3.10, 3.11, and 3.12 on both ubuntu-latest and macos-latest.
+
+---
+
+## License
+
+Released under the MIT License. See [LICENSE](./LICENSE) for the full text.

oh_my_wiki-2.7.0/README.md

@@ -0,0 +1,238 @@
+# oh-my-wiki (OMW)
+
+[![CI](https://github.com/dandacompany/oh-my-wiki/actions/workflows/ci.yml/badge.svg)](https://github.com/dandacompany/oh-my-wiki/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-6C5CE7)](https://github.com/dandacompany/oh-my-wiki#install)
+[![skillsmp](https://img.shields.io/badge/skills.sh-oh--my--wiki-1abc9c)](https://skills.sh/)
+
+A host-universal LLM-wiki you drive from your AI coding agent (Claude Code / Codex / Gemini).
+
+oh-my-wiki exposes exactly two surfaces. The **`omw` CLI** handles deterministic ops — `omw setup`, `omw vault create`, `omw lint`, `omw schema list`, `omw supersede`, `omw review`, `omw links`, `omw fields`, `omw view`, `omw doctor` — with no LLM required. The **`omw` skill** brings natural-language reasoning inside your AI session: ingest, query, autoresearch, and a small set of wiki-maintenance personas (librarian, curator, fact-checker, consistency-checker, terminology-manager). The model is _personas propose → you confirm → deterministic ops execute_, so every file change is auditable. omw stays focused on the wiki — multi-step orchestration is left to your host AI agent (Claude Code / Codex / Gemini), not reimplemented here.
+
+**Short alias:** `OMW` (lowercase `omw`). Both `oh-my-wiki` and `omw` register as skills and respond to the same trigger phrases.
+
+**Tutorial:** Walk through real dialogs and verified CLI examples in [TUTORIAL.md](./TUTORIAL.md) (English) or [TUTORIAL.ko.md](./TUTORIAL.ko.md) (한국어).
+
+---
+
+## What's new in v3
+
+- **Schemas** — 13 built-in page types (`omw schema list/show`), with per-vault overrides in `<vault>/schemas/`
+- **Confidence + supersede** — `confidence` frontmatter field; `omw supersede` retires old pages cleanly
+- **Review queue (SR)** — spaced-repetition via `omw review due` / `omw review done`
+- **Web search** — `omw search` queries an external provider (brave/tavily/exa/…); `omw serve` exposes vault FTS5 as a local retrieve-only HTTP API on port 8765
+- **Entity-linking** — `omw links suggest` / `omw links link` auto-inserts `[[slug|Name]]` references
+- **Inline fields** — `omw fields` reads `key::` inline syntax alongside frontmatter
+- **Korean matching** — Korean entity names with josa (`카르파시가`) are suggested and linked correctly
+- **Note viewers** — `omw view` opens the active vault, a page, or a search in Obsidian or Logseq (URI schemes, no plugin needed); `omw setup viewer` scaffolds the viewer config
+- **Visibility (secure-by-default)** — `omw visibility get/set` marks pages `public`/`private`; `omw serve` exposes only public pages
+- **URL inbox + fetch** — `omw fetch <url>` saves a web page or YouTube transcript to `raw/` (tiered urllib → chromium → cloud, SSRF-guarded); `omw inbox add/list/run/remove` queues URLs for batch fetch
+
+---
+
+## Install
+
+Choose whichever path fits your environment. After any path, run `omw doctor` to confirm everything is wired correctly.
+
+### Path A — Skills CLI (recommended for Claude Code users)
+
+```bash
+skills add dandacompany/oh-my-wiki@oh-my-wiki -g -y --copy -a claude-code
+```
+
+This installs the skill into `~/.claude/skills/` and registers both the `oh-my-wiki` and `omw` short-alias skill names.
+
+### Path B — Claude Code plugin marketplace
+
+In any Claude Code session:
+
+```
+/plugin marketplace add dandacompany/oh-my-wiki
+/plugin install oh-my-wiki@oh-my-wiki-marketplace
+```
+
+Update later with `/plugin marketplace update oh-my-wiki-marketplace`.
+
+### Path C — git clone + install script (developers, Codex CLI users)
+
+```bash
+git clone https://github.com/dandacompany/oh-my-wiki
+cd oh-my-wiki
+bash bin/install.sh
+```
+
+The installer checks for Python 3.10+, pip-installs the package editable, creates `~/.claude/skills/oh-my-wiki` and `~/.claude/skills/omw` symlinks (idempotent), runs `pytest -q` to verify, and prints next steps. Add `--dev` to include pytest/ruff extras. Use `--force` to replace existing symlinks without a prompt; `--no-test` to skip the test step. Run `bash bin/install.sh --help` for all flags.
+
+### Verify the install
+
+```
+omw doctor
+```
+
+```
+omw home:   /Users/you/.omw  ok
+registry:   /Users/you/.omw/registry.db  ok
+  * demo (wiki/markdown) /Users/you/.omw/vaults/demo
+```
+
+---
+
+## Quickstart (~60 seconds)
+
+**Step 1 — Run the setup wizard**
+
+```
+omw setup
+```
+
+Follow the prompts to configure your first vault, search provider, and persona preferences. Accept the defaults for a fast start.
+
+**Step 2 — Check status**
+
+```
+omw status
+```
+
+```json
+{
+  "vault_count": 0,
+  "active": null,
+  "needs": "setup",
+  "vaults": []
+}
+```
+
+**Step 3 — Create your first vault**
+
+```
+omw vault create demo --mode wiki
+```
+
+```json
+{
+  "created": "demo",
+  "path": "~/.omw/vaults/demo",
+  "mode": "wiki",
+  "type": "markdown"
+}
+```
+
+```
+omw vault list
+```
+
+```json
+[
+  {
+    "name": "demo",
+    "path": "~/.omw/vaults/demo",
+    "mode": "wiki",
+    "type": "markdown",
+    "is_active": true
+  }
+]
+```
+
+**Step 4 — Add a note (in your AI session)**
+
+Open Claude Code (or Codex / Gemini) and say:
+
+```
+ingest this
+
+Andrej Karpathy calls the LLM Wiki a "compounding knowledge artifact". Every
+source gets saved verbatim to raw/, a summary lands at wiki/summaries/, and
+the entities and concepts that appeared get their own pages. 10–15 page touches
+per ingest is normal.
+```
+
+**Step 5 — Run a lint check**
+
+```
+omw lint
+```
+
+```json
+{
+  "vault_id": 1,
+  "vault_path": "~/.omw/vaults/demo",
+  "frontmatter_issues": [],
+  "drift": { "missing_files": [], "mtime_drift": [] },
+  "links": {
+    "broken": [],
+    "orphans": [],
+    "index_drift": { "missing_from_index": [], "dangling_in_index": [] },
+    "contradictions": [],
+    "supersedes": [],
+    "superseded_unmarked": [],
+    "link_suggestions": []
+  },
+  "auto_fix_hints": []
+}
+```
+
+→ Full tutorial: [TUTORIAL.md](TUTORIAL.md) · [한국어](TUTORIAL.ko.md)
+
+---
+
+## Architecture
+
+```
+SKILL.md dispatcher → commands/<op>.md (LLM procedure) → scripts/<op>.py (deterministic I/O)
+                                                       └─ registry.py → ~/.omw/registry.db (sqlite)
+                                                       └─ adapters.py → filesystem (markdown / obsidian)
+```
+
+The 17 CLI subcommands:
+
+| Subcommand   | Purpose                                                              |
+| ------------ | -------------------------------------------------------------------- |
+| `status`     | Show active vault and registry state                                 |
+| `vault`      | Create, list, use, forget vaults                                     |
+| `lint`       | Structural health check (frontmatter + links)                        |
+| `search`     | Web search via the configured external provider (brave/tavily/exa/…) |
+| `serve`      | Local retrieve-only HTTP query API (port 8765) — public pages only   |
+| `view`       | Open the vault / a page / a search in Obsidian or Logseq             |
+| `visibility` | Get / set a page's public/private visibility (`get` / `set`)         |
+| `schema`     | List / inspect page-type schemas                                     |
+| `supersede`  | Mark a page superseded by a newer one                                |
+| `review`     | Spaced-repetition review queue (due / done)                          |
+| `links`      | Suggest and insert `[[slug]]` entity links                           |
+| `fields`     | Read frontmatter + inline `key::` fields                             |
+| `import`     | Import an existing folder as a vault                                 |
+| `fetch`      | Fetch one URL (web page / YouTube transcript) into `raw/`            |
+| `inbox`      | Queue URLs and batch-fetch them into `raw/` (add/list/run/remove)    |
+| `setup`      | Interactive setup wizard                                             |
+| `doctor`     | Verify install health                                                |
+
+> **Visibility (secure-by-default):** `omw serve` returns only pages with
+> `visibility: public` in their frontmatter. Pages without the field are treated as
+> private and never served. Publish pages explicitly with
+> `omw visibility set <relpath...> public`.
+
+The skill also exposes natural-language ops via your AI session: `ingest`, `query`, `autoresearch`, `find`, `edit`, `move`, `delete`, and wiki-maintenance persona invocations (`fact-check`, `consistency-check`, `build glossary`).
+
+---
+
+## Storage
+
+- The vault registry lives at `~/.omw/registry.db` (override with `OMW_HOME`) as a per-user sqlite database.
+- The note index is regenerated by `scripts/reindex.py` after every mutation.
+- Your files stay in the vault path you chose. oh-my-wiki never touches them outside the op you explicitly invoked.
+
+---
+
+## Development
+
+- `pytest -v` runs all tests.
+- `ruff check scripts/ tests/` runs the linter.
+- `omw status` inspects the registry/vault state.
+- `python3 -m scripts.lint --vault-id N` runs the health check on a specific vault.
+
+Continuous integration runs on GitHub Actions, across a matrix of Python 3.10, 3.11, and 3.12 on both ubuntu-latest and macos-latest.
+
+---
+
+## License
+
+Released under the MIT License. See [LICENSE](./LICENSE) for the full text.