@zosmaai/pi-llm-wiki 0.10.7 → 0.11.0

package/README.fr.md

@@ -7,7 +7,7 @@
 [![CI](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
 [![npm downloads](https://img.shields.io/npm/dm/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
-[![Coverage](https://codecov.io/gh/zosmaai/pi-llm-wiki/branch/main/graph/badge.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
+[![Coverage](https://img.shields.io/badge/coverage-85.09%25-brightgreen.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![CodeQL](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml)
 [![GitHub Repo Stars](https://img.shields.io/github/stars/zosmaai/pi-llm-wiki?style=social)](https://github.com/zosmaai/pi-llm-wiki/stargazers)
@@ -35,6 +35,26 @@ Follows Andrej Karpathy's [LLM Wiki pattern](https://gist.github.com/karpathy/44
 
 Transformez des sources brutes (URLs, PDFs, markdown, JSON, XML) en un wiki durable, interconnecté et maintenu par LLM qui s'accumule avec le temps.
 
+### Prise en charge native d'Open Knowledge Format (OKF) v0.2
+
+Créez une base de connaissances que vous pouvez conserver et transférer — pas une nouvelle exportation fermée propre à une application :
+
+- **Créez des documents OKF v0.2 portables** avec un frontmatter canonique, des liens Markdown standard et des citations de sources stables.
+- **Lisez les pages héritées et OKF** afin que les vaults existants continuent de fonctionner sans migration ni réécriture automatique.
+- **Générez des index et des journaux déterministes** à partir des pages faisant autorité, pour une navigation et des métadonnées reproductibles.
+- **Utilisez le même modèle de connaissances depuis Pi ou MCP** avec Claude Code, Cursor, Windsurf et d'autres clients MCP.
+- **Restez compatible avec Obsidian** tout en préparant vos connaissances pour les outils prenant en charge Open Knowledge Format.
+
+Commencez avec un nouveau vault OKF, ou utilisez pi-llm-wiki avec un vault existant et adoptez le format à votre rythme. Consultez la [spécification OKF Foundation](docs/superpowers/specs/2026-08-02-okf-foundation-design.md) pour les détails d'implémentation.
+
+---
+
+## Démo
+
+<div align="center">
+  <img src="./assets/demo.gif" alt="Démonstration de pi-llm-wiki" width="1920" />
+</div>
+
 ---
 
 ## Démarrage Rapide
@@ -82,11 +102,13 @@ Le résultat est un wiki qui s'accumule au fur et à mesure que vous capturez de
 | 🧠 **Layered recall** | Searches both personal (`~/.llm-wiki/`) and project (`.llm-wiki/`) vaults — personal knowledge follows you everywhere |
 | 📝 **Auto-bootstrap** | Extension suggests creating a wiki when none exists in the current directory |
 | 💾 **Lightweight capture** | `wiki_retro` — save atomic insights as a single markdown file; full 4-layer pipeline also available via `wiki_capture_source` |
-| 🌐 **MCP Server** | Use with Claude Code, Cursor, Windsurf via stdio MCP transport |
+| 🧭 **Agent working-memory** _(opt-in)_ | `wiki_capture_trajectory` records *how* a task was solved (tool-call trajectory) → distill into reusable `skill`/`case` pages → `wiki_recall_skill` surfaces them next time. Off by default; enable with `/wiki-trajectories on` |
+| 🌐 **OKF v0.2 natif** | Documents Open Knowledge Format portables, lecture compatible des vaults hérités et projections déterministes |
+| 🌐 **Serveur MCP** | Utilisez le même wiki compatible OKF depuis Claude Code, Cursor et Windsurf via le transport MCP stdio |
 | 📝 **Obsidian-friendly** | Folder-qualified wikilinks, stable source-ID citations, compatible vault |
 | 🛡️ **Guardrails** | Blocks direct edits to raw sources and generated metadata |
 | 🔧 **Configurable PDF extraction** | MarkItDown timeout via `WIKI_MARKITDOWN_TIMEOUT_MS` env var |
-| 🧪 **38+ tests, CI, CodeQL** | TypeScript, Vitest, Biome, Codecov |
+| 🧪 **562 tests, 85.09% coverage, CI, CodeQL** | TypeScript, Vitest, Biome, Codecov |
 
 ---
 
@@ -106,6 +128,11 @@ Le résultat est un wiki qui s'accumule au fur et à mesure que vous capturez de
 | `wiki_rebuild_meta` | Force a full metadata rebuild (registry, backlinks, index, log) |
 | `wiki_log_event` | Append a structured event to the wiki activity log |
 | `wiki_watch` | Print a `crontab` line for automatic wiki updates (daily / weekly / hourly) — does not install it |
+| `wiki_capture_trajectory` _(opt-in)_ | Capture the completed task's tool-call trajectory (agent working-memory) |
+| `wiki_distill_skills` _(opt-in)_ | Batch undistilled trajectories for synthesis into reusable skill pages |
+| `wiki_recall_skill` _(opt-in)_ | Recall distilled skills + similar past cases — "have I done this before?" |
+
+> The three agent-trajectory tools are **off by default** (issue #80). Enable them with `/wiki-trajectories on` (sets `llm-wiki.trajectories`); when off they are not registered at all.
 
 ### Commandes Slash
 
@@ -120,6 +147,10 @@ Le résultat est un wiki qui s'accumule au fur et à mesure que vous capturez de
 | `/wiki-status` | Show a concise operational summary |
 | `/wiki-digest [--period daily\|weekly]` | Generate a digest of recent activity |
 | `/wiki-retro` | Save atomic insights from completed tasks |
+| `/wiki-req <concept>` | Decompose a concept into atomic, traceable requirement pages |
+| `/wiki-trajectories <on\|off>` | Enable/disable agent working-memory (opt-in, off by default) |
+| `/wiki-record <title>` | Capture the completed task's trajectory (requires trajectories enabled) |
+| `/wiki-skills [query]` | Search distilled skills + past cases (requires trajectories enabled) |
 
 ---
 
@@ -357,7 +388,7 @@ The bundled `llm-wiki` skill teaches the model to:
 
 ### Couches de Vault
 
-See the [Layered Vault Architecture](#layered-vault-architecture) section above for the personal/project/company layering.
+Consultez la section [Architecture de Vault en Couches](#architecture-de-vault-en-couches) ci-dessus pour les couches personnelles, de projet et d'entreprise.
 
 ### Modèle de Page à Quatre Couches
 

package/README.hi.md

@@ -7,7 +7,7 @@
 [![CI](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
 [![npm downloads](https://img.shields.io/npm/dm/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
-[![Coverage](https://codecov.io/gh/zosmaai/pi-llm-wiki/branch/main/graph/badge.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
+[![Coverage](https://img.shields.io/badge/coverage-85.09%25-brightgreen.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![CodeQL](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml)
 [![GitHub Repo Stars](https://img.shields.io/github/stars/zosmaai/pi-llm-wiki?style=social)](https://github.com/zosmaai/pi-llm-wiki/stargazers)
@@ -35,6 +35,26 @@ Follows Andrej Karpathy's [LLM Wiki pattern](https://gist.github.com/karpathy/44
 
 कच्चे स्रोतों (URL, PDF, मार्कडाउन, JSON, XML) को एक टिकाऊ, आपस में जुड़े, LLM-अनुरक्षित Wiki में बदलें जो समय के साथ संचित होता रहे।
 
+### मूल Open Knowledge Format (OKF) v0.2 समर्थन
+
+ऐसा ज्ञानकोष बनाएँ जिसे आप आगे ले जा सकें — कोई और बंद, ऐप-विशिष्ट निर्यात नहीं:
+
+- **पोर्टेबल OKF v0.2 दस्तावेज़ बनाएँ** जिनमें मानक frontmatter, मानक Markdown लिंक और स्थिर स्रोत उद्धरण हों।
+- **पुराने और OKF दोनों पृष्ठ पढ़ें**, ताकि मौजूदा vault बिना स्वचालित migration या पुनर्लेखन के काम करते रहें।
+- **प्रामाणिक पृष्ठों से नियतात्मक index और log बनाएँ**, जिससे navigation और metadata पुनरुत्पाद्य रहें।
+- **Pi या MCP से एक ही ज्ञान मॉडल उपयोग करें** — Claude Code, Cursor, Windsurf और अन्य MCP clients के साथ।
+- **Obsidian-संगत रहें** और अपने ज्ञान को Open Knowledge Format समर्थित tools के लिए तैयार रखें।
+
+नए OKF vault से शुरू करें, या pi-llm-wiki को मौजूदा vault पर उपयोग करके अपनी शर्तों पर format अपनाएँ। कार्यान्वयन विवरण के लिए [OKF Foundation specification](docs/superpowers/specs/2026-08-02-okf-foundation-design.md) देखें।
+
+---
+
+## डेमो
+
+<div align="center">
+  <img src="./assets/demo.gif" alt="pi-llm-wiki डेमो" width="1920" />
+</div>
+
 ---
 
 ## त्वरित शुरुआत
@@ -82,11 +102,13 @@ The extension will proactively suggest creating a wiki on your first session. Al
 | 🧠 **Layered recall** | Searches both personal (`~/.llm-wiki/`) and project (`.llm-wiki/`) vaults — personal knowledge follows you everywhere |
 | 📝 **Auto-bootstrap** | Extension suggests creating a wiki when none exists in the current directory |
 | 💾 **Lightweight capture** | `wiki_retro` — save atomic insights as a single markdown file; full 4-layer pipeline also available via `wiki_capture_source` |
-| 🌐 **MCP Server** | Use with Claude Code, Cursor, Windsurf via stdio MCP transport |
+| 🧭 **Agent working-memory** _(opt-in)_ | `wiki_capture_trajectory` records *how* a task was solved (tool-call trajectory) → distill into reusable `skill`/`case` pages → `wiki_recall_skill` surfaces them next time. Off by default; enable with `/wiki-trajectories on` |
+| 🌐 **मूल OKF v0.2** | पोर्टेबल Open Knowledge Format दस्तावेज़, पुराने vault के लिए dual-read संगतता और नियतात्मक projections |
+| 🌐 **MCP Server** | Claude Code, Cursor और Windsurf से stdio MCP transport द्वारा उसी OKF-सक्षम wiki का उपयोग करें |
 | 📝 **Obsidian-friendly** | Folder-qualified wikilinks, stable source-ID citations, compatible vault |
 | 🛡️ **Guardrails** | Blocks direct edits to raw sources and generated metadata |
 | 🔧 **Configurable PDF extraction** | MarkItDown timeout via `WIKI_MARKITDOWN_TIMEOUT_MS` env var |
-| 🧪 **38+ tests, CI, CodeQL** | TypeScript, Vitest, Biome, Codecov |
+| 🧪 **562 tests, 85.09% coverage, CI, CodeQL** | TypeScript, Vitest, Biome, Codecov |
 
 ---
 
@@ -106,6 +128,11 @@ The extension will proactively suggest creating a wiki on your first session. Al
 | `wiki_rebuild_meta` | Force a full metadata rebuild (registry, backlinks, index, log) |
 | `wiki_log_event` | Append a structured event to the wiki activity log |
 | `wiki_watch` | Print a `crontab` line for automatic wiki updates (daily / weekly / hourly) — does not install it |
+| `wiki_capture_trajectory` _(opt-in)_ | Capture the completed task's tool-call trajectory (agent working-memory) |
+| `wiki_distill_skills` _(opt-in)_ | Batch undistilled trajectories for synthesis into reusable skill pages |
+| `wiki_recall_skill` _(opt-in)_ | Recall distilled skills + similar past cases — "have I done this before?" |
+
+> The three agent-trajectory tools are **off by default** (issue #80). Enable them with `/wiki-trajectories on` (sets `llm-wiki.trajectories`); when off they are not registered at all.
 
 ### स्लैश कमांड
 
@@ -120,6 +147,10 @@ The extension will proactively suggest creating a wiki on your first session. Al
 | `/wiki-status` | Show a concise operational summary |
 | `/wiki-digest [--period daily\|weekly]` | Generate a digest of recent activity |
 | `/wiki-retro` | Save atomic insights from completed tasks |
+| `/wiki-req <concept>` | Decompose a concept into atomic, traceable requirement pages |
+| `/wiki-trajectories <on\|off>` | Enable/disable agent working-memory (opt-in, off by default) |
+| `/wiki-record <title>` | Capture the completed task's trajectory (requires trajectories enabled) |
+| `/wiki-skills [query]` | Search distilled skills + past cases (requires trajectories enabled) |
 
 ---
 
@@ -357,7 +388,7 @@ The bundled `llm-wiki` skill teaches the model to:
 
 ### Vault स्तर
 
-See the [Layered Vault Architecture](#layered-vault-architecture) section above for the personal/project/company layering.
+व्यक्तिगत, project और company layering के लिए ऊपर दिया गया [स्तरित Vault आर्किटेक्चर](#स्तरित-vault-आर्किटेक्चर) अनुभाग देखें।
 
 ### चार-स्तरीय पृष्ठ मॉडल
 

package/README.ja.md

@@ -7,7 +7,7 @@
 [![CI](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
 [![npm downloads](https://img.shields.io/npm/dm/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
-[![Coverage](https://codecov.io/gh/zosmaai/pi-llm-wiki/branch/main/graph/badge.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
+[![Coverage](https://img.shields.io/badge/coverage-85.09%25-brightgreen.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![CodeQL](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml)
 [![GitHub Repo Stars](https://img.shields.io/github/stars/zosmaai/pi-llm-wiki?style=social)](https://github.com/zosmaai/pi-llm-wiki/stargazers)
@@ -35,6 +35,26 @@ Follows Andrej Karpathy's [LLM Wiki pattern](https://gist.github.com/karpathy/44
 
 URL、PDF、Markdown、JSON、XML などの生ソースを、耐久性があり相互リンクされた LLM 管理の Wiki に変換し、時間とともに蓄積します。
 
+### Open Knowledge Format (OKF) v0.2 のネイティブサポート
+
+閉じたアプリ固有のエクスポートではなく、将来にわたって持ち運べるナレッジベースを構築できます：
+
+- **ポータブルな OKF v0.2 ドキュメントを作成** — 正規 frontmatter、標準 Markdown リンク、安定したソース引用を使用します。
+- **従来形式と OKF の両方のページを読み込み** — 既存の vault は自動移行や書き換えなしで動作し続けます。
+- **信頼できるページから決定論的な index と log を生成** — ナビゲーションとメタデータを再現可能に保ちます。
+- **Pi または MCP から同じナレッジモデルを利用** — Claude Code、Cursor、Windsurf、その他の MCP クライアントで使用できます。
+- **Obsidian 互換性を維持**しながら、Open Knowledge Format 対応ツールで利用できる知識を構築します。
+
+新しい OKF vault から始めることも、既存の vault に pi-llm-wiki を接続して必要なタイミングで形式を採用することもできます。実装の詳細は [OKF Foundation 仕様](docs/superpowers/specs/2026-08-02-okf-foundation-design.md) を参照してください。
+
+---
+
+## デモ
+
+<div align="center">
+  <img src="./assets/demo.gif" alt="pi-llm-wiki デモ" width="1920" />
+</div>
+
 ---
 
 ## クイックスタート
@@ -82,11 +102,13 @@ The extension will proactively suggest creating a wiki on your first session. Al
 | 🧠 **Layered recall** | Searches both personal (`~/.llm-wiki/`) and project (`.llm-wiki/`) vaults — personal knowledge follows you everywhere |
 | 📝 **Auto-bootstrap** | Extension suggests creating a wiki when none exists in the current directory |
 | 💾 **Lightweight capture** | `wiki_retro` — save atomic insights as a single markdown file; full 4-layer pipeline also available via `wiki_capture_source` |
-| 🌐 **MCP Server** | Use with Claude Code, Cursor, Windsurf via stdio MCP transport |
+| 🧭 **Agent working-memory** _(opt-in)_ | `wiki_capture_trajectory` records *how* a task was solved (tool-call trajectory) → distill into reusable `skill`/`case` pages → `wiki_recall_skill` surfaces them next time. Off by default; enable with `/wiki-trajectories on` |
+| 🌐 **OKF v0.2 ネイティブ** | ポータブルな Open Knowledge Format ドキュメント、従来 vault の dual-read 互換性、決定論的 projection |
+| 🌐 **MCP サーバー** | Claude Code、Cursor、Windsurf から stdio MCP transport を介して同じ OKF 対応 Wiki を使用 |
 | 📝 **Obsidian-friendly** | Folder-qualified wikilinks, stable source-ID citations, compatible vault |
 | 🛡️ **Guardrails** | Blocks direct edits to raw sources and generated metadata |
 | 🔧 **Configurable PDF extraction** | MarkItDown timeout via `WIKI_MARKITDOWN_TIMEOUT_MS` env var |
-| 🧪 **38+ tests, CI, CodeQL** | TypeScript, Vitest, Biome, Codecov |
+| 🧪 **562 tests, 85.09% coverage, CI, CodeQL** | TypeScript, Vitest, Biome, Codecov |
 
 ---
 
@@ -106,6 +128,11 @@ The extension will proactively suggest creating a wiki on your first session. Al
 | `wiki_rebuild_meta` | Force a full metadata rebuild (registry, backlinks, index, log) |
 | `wiki_log_event` | Append a structured event to the wiki activity log |
 | `wiki_watch` | Print a `crontab` line for automatic wiki updates (daily / weekly / hourly) — does not install it |
+| `wiki_capture_trajectory` _(opt-in)_ | Capture the completed task's tool-call trajectory (agent working-memory) |
+| `wiki_distill_skills` _(opt-in)_ | Batch undistilled trajectories for synthesis into reusable skill pages |
+| `wiki_recall_skill` _(opt-in)_ | Recall distilled skills + similar past cases — "have I done this before?" |
+
+> The three agent-trajectory tools are **off by default** (issue #80). Enable them with `/wiki-trajectories on` (sets `llm-wiki.trajectories`); when off they are not registered at all.
 
 ### スラッシュコマンド
 
@@ -120,6 +147,10 @@ The extension will proactively suggest creating a wiki on your first session. Al
 | `/wiki-status` | Show a concise operational summary |
 | `/wiki-digest [--period daily\|weekly]` | Generate a digest of recent activity |
 | `/wiki-retro` | Save atomic insights from completed tasks |
+| `/wiki-req <concept>` | Decompose a concept into atomic, traceable requirement pages |
+| `/wiki-trajectories <on\|off>` | Enable/disable agent working-memory (opt-in, off by default) |
+| `/wiki-record <title>` | Capture the completed task's trajectory (requires trajectories enabled) |
+| `/wiki-skills [query]` | Search distilled skills + past cases (requires trajectories enabled) |
 
 ---
 
@@ -357,7 +388,7 @@ The bundled `llm-wiki` skill teaches the model to:
 
 ### Vault 層
 
-See the [Layered Vault Architecture](#layered-vault-architecture) section above for the personal/project/company layering.
+個人、プロジェクト、企業の階層については、上記の [階層型 Vault アーキテクチャ](#階層型-vault-アーキテクチャ) を参照してください。
 
 ### 4層ページモデル
 

package/README.ko.md

@@ -7,7 +7,7 @@
 [![CI](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
 [![npm downloads](https://img.shields.io/npm/dm/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
-[![Coverage](https://codecov.io/gh/zosmaai/pi-llm-wiki/branch/main/graph/badge.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
+[![Coverage](https://img.shields.io/badge/coverage-85.09%25-brightgreen.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![CodeQL](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml)
 [![GitHub Repo Stars](https://img.shields.io/github/stars/zosmaai/pi-llm-wiki?style=social)](https://github.com/zosmaai/pi-llm-wiki/stargazers)
@@ -35,6 +35,26 @@ Follows Andrej Karpathy's [LLM Wiki pattern](https://gist.github.com/karpathy/44
 
 원시 소스(URL, PDF, 마크다운, JSON, XML)를 시간이 지남에 따라 축적되는 내구성 있고 상호 연결된 LLM 유지 관리 Wiki로 변환합니다.
 
+### Open Knowledge Format (OKF) v0.2 네이티브 지원
+
+폐쇄적인 앱 전용 내보내기가 아니라 계속 활용할 수 있는 지식 베이스를 구축하세요:
+
+- **이식 가능한 OKF v0.2 문서 생성** — 표준 frontmatter, 표준 Markdown 링크, 안정적인 소스 인용을 사용합니다.
+- **레거시 및 OKF 페이지를 모두 읽기** — 기존 vault를 자동 migration이나 재작성 없이 계속 사용할 수 있습니다.
+- **권위 있는 페이지에서 결정론적 index와 log 생성** — 탐색과 metadata를 재현 가능하게 유지합니다.
+- **Pi 또는 MCP에서 동일한 지식 모델 사용** — Claude Code, Cursor, Windsurf 및 기타 MCP 클라이언트에서 사용할 수 있습니다.
+- **Obsidian 호환성 유지** — Open Knowledge Format을 지원하는 도구에서 바로 사용할 수 있는 지식을 구축합니다.
+
+새 OKF vault로 시작하거나, 기존 vault에 pi-llm-wiki를 연결하고 원하는 시점에 형식을 도입하세요. 구현 세부 사항은 [OKF Foundation 사양](docs/superpowers/specs/2026-08-02-okf-foundation-design.md)을 참조하세요.
+
+---
+
+## 데모
+
+<div align="center">
+  <img src="./assets/demo.gif" alt="pi-llm-wiki 데모" width="1920" />
+</div>
+
 ---
 
 ## 빠른 시작
@@ -82,11 +102,13 @@ The extension will proactively suggest creating a wiki on your first session. Al
 | 🧠 **Layered recall** | Searches both personal (`~/.llm-wiki/`) and project (`.llm-wiki/`) vaults — personal knowledge follows you everywhere |
 | 📝 **Auto-bootstrap** | Extension suggests creating a wiki when none exists in the current directory |
 | 💾 **Lightweight capture** | `wiki_retro` — save atomic insights as a single markdown file; full 4-layer pipeline also available via `wiki_capture_source` |
-| 🌐 **MCP Server** | Use with Claude Code, Cursor, Windsurf via stdio MCP transport |
+| 🧭 **Agent working-memory** _(opt-in)_ | `wiki_capture_trajectory` records *how* a task was solved (tool-call trajectory) → distill into reusable `skill`/`case` pages → `wiki_recall_skill` surfaces them next time. Off by default; enable with `/wiki-trajectories on` |
+| 🌐 **OKF v0.2 네이티브** | 이식 가능한 Open Knowledge Format 문서, 레거시 vault dual-read 호환성, 결정론적 projection |
+| 🌐 **MCP 서버** | Claude Code, Cursor, Windsurf에서 stdio MCP transport를 통해 동일한 OKF 지원 Wiki 사용 |
 | 📝 **Obsidian-friendly** | Folder-qualified wikilinks, stable source-ID citations, compatible vault |
 | 🛡️ **Guardrails** | Blocks direct edits to raw sources and generated metadata |
 | 🔧 **Configurable PDF extraction** | MarkItDown timeout via `WIKI_MARKITDOWN_TIMEOUT_MS` env var |
-| 🧪 **38+ tests, CI, CodeQL** | TypeScript, Vitest, Biome, Codecov |
+| 🧪 **562 tests, 85.09% coverage, CI, CodeQL** | TypeScript, Vitest, Biome, Codecov |
 
 ---
 
@@ -106,6 +128,11 @@ The extension will proactively suggest creating a wiki on your first session. Al
 | `wiki_rebuild_meta` | Force a full metadata rebuild (registry, backlinks, index, log) |
 | `wiki_log_event` | Append a structured event to the wiki activity log |
 | `wiki_watch` | Print a `crontab` line for automatic wiki updates (daily / weekly / hourly) — does not install it |
+| `wiki_capture_trajectory` _(opt-in)_ | Capture the completed task's tool-call trajectory (agent working-memory) |
+| `wiki_distill_skills` _(opt-in)_ | Batch undistilled trajectories for synthesis into reusable skill pages |
+| `wiki_recall_skill` _(opt-in)_ | Recall distilled skills + similar past cases — "have I done this before?" |
+
+> The three agent-trajectory tools are **off by default** (issue #80). Enable them with `/wiki-trajectories on` (sets `llm-wiki.trajectories`); when off they are not registered at all.
 
 ### 슬래시 명령
 
@@ -120,6 +147,10 @@ The extension will proactively suggest creating a wiki on your first session. Al
 | `/wiki-status` | Show a concise operational summary |
 | `/wiki-digest [--period daily\|weekly]` | Generate a digest of recent activity |
 | `/wiki-retro` | Save atomic insights from completed tasks |
+| `/wiki-req <concept>` | Decompose a concept into atomic, traceable requirement pages |
+| `/wiki-trajectories <on\|off>` | Enable/disable agent working-memory (opt-in, off by default) |
+| `/wiki-record <title>` | Capture the completed task's trajectory (requires trajectories enabled) |
+| `/wiki-skills [query]` | Search distilled skills + past cases (requires trajectories enabled) |
 
 ---
 
@@ -357,7 +388,7 @@ The bundled `llm-wiki` skill teaches the model to:
 
 ### Vault 계층
 
-See the [Layered Vault Architecture](#layered-vault-architecture) section above for the personal/project/company layering.
+개인, 프로젝트, 회사 계층에 대해서는 위의 [계층형 Vault 아키텍처](#계층형-vault-아키텍처) 섹션을 참조하세요.
 
 ### 4계층 페이지 모델
 

package/README.md

@@ -7,7 +7,7 @@
 [![CI](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
 [![npm downloads](https://img.shields.io/npm/dm/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
-[![Coverage](https://codecov.io/gh/zosmaai/pi-llm-wiki/branch/main/graph/badge.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
+[![Coverage](https://img.shields.io/badge/coverage-85.09%25-brightgreen.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![CodeQL](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml)
 [![GitHub Repo Stars](https://img.shields.io/github/stars/zosmaai/pi-llm-wiki?style=social)](https://github.com/zosmaai/pi-llm-wiki/stargazers)
@@ -23,6 +23,26 @@ Follows Andrej Karpathy's [LLM Wiki pattern](https://gist.github.com/karpathy/44
 
 Turn raw sources (URLs, PDFs, markdown, JSON, XML) into a durable, interlinked, LLM-maintained wiki that compounds over time.
 
+### Native Open Knowledge Format (OKF) v0.2 support
+
+Build a knowledge base you can carry forward — not another closed, app-specific export:
+
+- **Create portable OKF v0.2 documents** with canonical frontmatter, standard Markdown links, and stable source citations.
+- **Read both legacy and OKF pages** so existing vaults keep working without an automatic migration or rewrite.
+- **Generate deterministic indexes and logs** from authoritative pages, keeping navigation and metadata reproducible.
+- **Use the same knowledge model from Pi or MCP** with Claude Code, Cursor, Windsurf, and other MCP clients.
+- **Stay Obsidian-compatible** while keeping your knowledge ready for tools that support Open Knowledge Format.
+
+Start with a new OKF vault, or point pi-llm-wiki at an existing vault and adopt the format on your terms. See the [OKF Foundation specification](docs/superpowers/specs/2026-08-02-okf-foundation-design.md) for implementation details.
+
+---
+
+## Demo
+
+<div align="center">
+  <img src="./assets/demo.gif" alt="pi-llm-wiki demo" width="1920" />
+</div>
+
 ---
 
 ## Quick Start
@@ -71,11 +91,12 @@ The result is a wiki that **compounds** as you capture sources, ask questions, a
 | 📝 **Auto-bootstrap** | Extension suggests creating a wiki when none exists in the current directory |
 | 💾 **Lightweight capture** | `wiki_retro` — save atomic insights as a single markdown file; full 4-layer pipeline also available via `wiki_capture_source` |
 | 🧭 **Agent working-memory** _(opt-in)_ | `wiki_capture_trajectory` records *how* a task was solved (tool-call trajectory) → distill into reusable `skill`/`case` pages → `wiki_recall_skill` surfaces them next time. Off by default; enable with `/wiki-trajectories on` |
-| 🌐 **MCP Server** | Use with Claude Code, Cursor, Windsurf via stdio MCP transport |
+| 🌐 **OKF v0.2 native** | Portable Open Knowledge Format documents, dual-read legacy compatibility, deterministic projections |
+| 🌐 **MCP Server** | Use the same OKF-aware wiki from Claude Code, Cursor, Windsurf via stdio MCP transport |
 | 📝 **Obsidian-friendly** | Folder-qualified wikilinks, stable source-ID citations, compatible vault |
 | 🛡️ **Guardrails** | Blocks direct edits to raw sources and generated metadata |
 | 🔧 **Configurable PDF extraction** | MarkItDown timeout via `WIKI_MARKITDOWN_TIMEOUT_MS` env var |
-| 🧪 **38+ tests, CI, CodeQL** | TypeScript, Vitest, Biome, Codecov |
+| 🧪 **562 tests, 85.09% coverage** | TypeScript, Vitest, Biome, Codecov, CodeQL |
 
 ---
 
@@ -440,6 +461,13 @@ Thanks to everyone who has contributed! This list is regenerated automatically b
                     <sub><b>Akshay</b></sub>
                 </a>
             </td>
+            <td align="center">
+                <a href="https://github.com/xcsf">
+                    <img src="https://avatars.githubusercontent.com/u/43439835?v=4" width="64;" alt="xcsf"/>
+                    <br />
+                    <sub><b>xcsf</b></sub>
+                </a>
+            </td>
             <td align="center">
                 <a href="https://github.com/danielnaab">
                     <img src="https://avatars.githubusercontent.com/u/136512?v=4" width="64;" alt="danielnaab"/>
@@ -447,6 +475,13 @@ Thanks to everyone who has contributed! This list is regenerated automatically b
                     <sub><b>Daniel Naab</b></sub>
                 </a>
             </td>
+            <td align="center">
+                <a href="https://github.com/deestax">
+                    <img src="https://avatars.githubusercontent.com/u/152369481?v=4" width="64;" alt="deestax"/>
+                    <br />
+                    <sub><b>Superdao</b></sub>
+                </a>
+            </td>
             <td align="center">
                 <a href="https://github.com/mystery4f">
                     <img src="https://avatars.githubusercontent.com/u/40482524?v=4" width="64;" alt="mystery4f"/>

package/README.pt.md

@@ -7,7 +7,7 @@
 [![CI](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
 [![npm downloads](https://img.shields.io/npm/dm/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
-[![Coverage](https://codecov.io/gh/zosmaai/pi-llm-wiki/branch/main/graph/badge.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
+[![Coverage](https://img.shields.io/badge/coverage-85.09%25-brightgreen.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![CodeQL](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml)
 [![GitHub Repo Stars](https://img.shields.io/github/stars/zosmaai/pi-llm-wiki?style=social)](https://github.com/zosmaai/pi-llm-wiki/stargazers)
@@ -35,6 +35,26 @@ Follows Andrej Karpathy's [LLM Wiki pattern](https://gist.github.com/karpathy/44
 
 Transforme fontes brutas (URLs, PDFs, markdown, JSON, XML) em um wiki durável, interligado e mantido por LLM que se acumula ao longo do tempo.
 
+### Suporte nativo ao Open Knowledge Format (OKF) v0.2
+
+Crie uma base de conhecimento que você possa levar adiante — não mais uma exportação fechada e específica de aplicativo:
+
+- **Crie documentos OKF v0.2 portáteis** com frontmatter canônico, links Markdown padrão e citações de fonte estáveis.
+- **Leia páginas legadas e OKF** para que vaults existentes continuem funcionando sem migração ou reescrita automática.
+- **Gere índices e logs determinísticos** a partir de páginas autoritativas, mantendo a navegação e os metadados reproduzíveis.
+- **Use o mesmo modelo de conhecimento no Pi ou via MCP** com Claude Code, Cursor, Windsurf e outros clientes MCP.
+- **Mantenha a compatibilidade com Obsidian** e deixe seu conhecimento pronto para ferramentas que suportam Open Knowledge Format.
+
+Comece com um novo vault OKF ou aponte o pi-llm-wiki para um vault existente e adote o formato no seu ritmo. Consulte a [especificação OKF Foundation](docs/superpowers/specs/2026-08-02-okf-foundation-design.md) para detalhes de implementação.
+
+---
+
+## Demonstração
+
+<div align="center">
+  <img src="./assets/demo.gif" alt="Demonstração do pi-llm-wiki" width="1920" />
+</div>
+
 ---
 
 ## Início Rápido
@@ -82,11 +102,13 @@ O resultado é um wiki que se acumula conforme você captura fontes, faz pergunt
 | 🧠 **Layered recall** | Searches both personal (`~/.llm-wiki/`) and project (`.llm-wiki/`) vaults — personal knowledge follows you everywhere |
 | 📝 **Auto-bootstrap** | Extension suggests creating a wiki when none exists in the current directory |
 | 💾 **Lightweight capture** | `wiki_retro` — save atomic insights as a single markdown file; full 4-layer pipeline also available via `wiki_capture_source` |
-| 🌐 **MCP Server** | Use with Claude Code, Cursor, Windsurf via stdio MCP transport |
+| 🧭 **Agent working-memory** _(opt-in)_ | `wiki_capture_trajectory` records *how* a task was solved (tool-call trajectory) → distill into reusable `skill`/`case` pages → `wiki_recall_skill` surfaces them next time. Off by default; enable with `/wiki-trajectories on` |
+| 🌐 **OKF v0.2 nativo** | Documentos Open Knowledge Format portáteis, compatibilidade dual-read com vaults legados e projeções determinísticas |
+| 🌐 **Servidor MCP** | Use o mesmo wiki compatível com OKF no Claude Code, Cursor e Windsurf via transporte MCP stdio |
 | 📝 **Obsidian-friendly** | Folder-qualified wikilinks, stable source-ID citations, compatible vault |
 | 🛡️ **Guardrails** | Blocks direct edits to raw sources and generated metadata |
 | 🔧 **Configurable PDF extraction** | MarkItDown timeout via `WIKI_MARKITDOWN_TIMEOUT_MS` env var |
-| 🧪 **38+ tests, CI, CodeQL** | TypeScript, Vitest, Biome, Codecov |
+| 🧪 **562 tests, 85.09% coverage, CI, CodeQL** | TypeScript, Vitest, Biome, Codecov |
 
 ---
 
@@ -106,6 +128,11 @@ O resultado é um wiki que se acumula conforme você captura fontes, faz pergunt
 | `wiki_rebuild_meta` | Force a full metadata rebuild (registry, backlinks, index, log) |
 | `wiki_log_event` | Append a structured event to the wiki activity log |
 | `wiki_watch` | Print a `crontab` line for automatic wiki updates (daily / weekly / hourly) — does not install it |
+| `wiki_capture_trajectory` _(opt-in)_ | Capture the completed task's tool-call trajectory (agent working-memory) |
+| `wiki_distill_skills` _(opt-in)_ | Batch undistilled trajectories for synthesis into reusable skill pages |
+| `wiki_recall_skill` _(opt-in)_ | Recall distilled skills + similar past cases — "have I done this before?" |
+
+> The three agent-trajectory tools are **off by default** (issue #80). Enable them with `/wiki-trajectories on` (sets `llm-wiki.trajectories`); when off they are not registered at all.
 
 ### Comandos de Barra
 
@@ -120,6 +147,10 @@ O resultado é um wiki que se acumula conforme você captura fontes, faz pergunt
 | `/wiki-status` | Show a concise operational summary |
 | `/wiki-digest [--period daily\|weekly]` | Generate a digest of recent activity |
 | `/wiki-retro` | Save atomic insights from completed tasks |
+| `/wiki-req <concept>` | Decompose a concept into atomic, traceable requirement pages |
+| `/wiki-trajectories <on\|off>` | Enable/disable agent working-memory (opt-in, off by default) |
+| `/wiki-record <title>` | Capture the completed task's trajectory (requires trajectories enabled) |
+| `/wiki-skills [query]` | Search distilled skills + past cases (requires trajectories enabled) |
 
 ---
 
@@ -357,7 +388,7 @@ The bundled `llm-wiki` skill teaches the model to:
 
 ### Camadas de Vault
 
-See the [Layered Vault Architecture](#layered-vault-architecture) section above for the personal/project/company layering.
+Consulte a seção [Arquitetura de Vault em Camadas](#arquitetura-de-vault-em-camadas) acima para as camadas pessoal, de projeto e empresarial.
 
 ### Modelo de Página de Quatro Camadas
 

package/README.ru.md

@@ -7,7 +7,7 @@
 [![CI](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
 [![npm downloads](https://img.shields.io/npm/dm/@zosmaai/pi-llm-wiki)](https://www.npmjs.com/package/@zosmaai/pi-llm-wiki)
-[![Coverage](https://codecov.io/gh/zosmaai/pi-llm-wiki/branch/main/graph/badge.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
+[![Coverage](https://img.shields.io/badge/coverage-85.09%25-brightgreen.svg)](https://codecov.io/gh/zosmaai/pi-llm-wiki)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![CodeQL](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml/badge.svg)](https://github.com/zosmaai/pi-llm-wiki/actions/workflows/codeql.yml)
 [![GitHub Repo Stars](https://img.shields.io/github/stars/zosmaai/pi-llm-wiki?style=social)](https://github.com/zosmaai/pi-llm-wiki/stargazers)
@@ -35,6 +35,26 @@ Follows Andrej Karpathy's [LLM Wiki pattern](https://gist.github.com/karpathy/44
 
 Превратите сырые источники (URLs, PDF, markdown, JSON, XML) в прочную, взаимосвязанную, поддерживаемую LLM вики, которая накапливается со временем.
 
+### Нативная поддержка Open Knowledge Format (OKF) v0.2
+
+Создайте базу знаний, которую можно использовать в будущем, — без закрытого экспорта, привязанного к конкретному приложению:
+
+- **Создавайте переносимые документы OKF v0.2** с каноническим frontmatter, стандартными Markdown-ссылками и стабильными ссылками на источники.
+- **Читайте страницы устаревшего формата и OKF**, чтобы существующие vault продолжали работать без автоматической миграции или перезаписи.
+- **Создавайте детерминированные index и log** из авторитетных страниц, сохраняя воспроизводимость навигации и метаданных.
+- **Используйте одну модель знаний через Pi или MCP** с Claude Code, Cursor, Windsurf и другими MCP-клиентами.
+- **Сохраняйте совместимость с Obsidian**, подготавливая знания для инструментов с поддержкой Open Knowledge Format.
+
+Начните с нового OKF vault или подключите pi-llm-wiki к существующему vault и переходите на формат на своих условиях. Подробности реализации приведены в [спецификации OKF Foundation](docs/superpowers/specs/2026-08-02-okf-foundation-design.md).
+
+---
+
+## Демонстрация
+
+<div align="center">
+  <img src="./assets/demo.gif" alt="Демонстрация pi-llm-wiki" width="1920" />
+</div>
+
 ---
 
 ## Быстрый старт
@@ -82,11 +102,13 @@ The extension will proactively suggest creating a wiki on your first session. Al
 | 🧠 **Layered recall** | Searches both personal (`~/.llm-wiki/`) and project (`.llm-wiki/`) vaults — personal knowledge follows you everywhere |
 | 📝 **Auto-bootstrap** | Extension suggests creating a wiki when none exists in the current directory |
 | 💾 **Lightweight capture** | `wiki_retro` — save atomic insights as a single markdown file; full 4-layer pipeline also available via `wiki_capture_source` |
-| 🌐 **MCP Server** | Use with Claude Code, Cursor, Windsurf via stdio MCP transport |
+| 🧭 **Agent working-memory** _(opt-in)_ | `wiki_capture_trajectory` records *how* a task was solved (tool-call trajectory) → distill into reusable `skill`/`case` pages → `wiki_recall_skill` surfaces them next time. Off by default; enable with `/wiki-trajectories on` |
+| 🌐 **Нативный OKF v0.2** | Переносимые документы Open Knowledge Format, dual-read совместимость с устаревшими vault и детерминированные проекции |
+| 🌐 **MCP-сервер** | Используйте ту же OKF-совместимую вики в Claude Code, Cursor и Windsurf через stdio MCP transport |
 | 📝 **Obsidian-friendly** | Folder-qualified wikilinks, stable source-ID citations, compatible vault |
 | 🛡️ **Guardrails** | Blocks direct edits to raw sources and generated metadata |
 | 🔧 **Configurable PDF extraction** | MarkItDown timeout via `WIKI_MARKITDOWN_TIMEOUT_MS` env var |
-| 🧪 **38+ tests, CI, CodeQL** | TypeScript, Vitest, Biome, Codecov |
+| 🧪 **562 tests, 85.09% coverage, CI, CodeQL** | TypeScript, Vitest, Biome, Codecov |
 
 ---
 
@@ -106,6 +128,11 @@ The extension will proactively suggest creating a wiki on your first session. Al
 | `wiki_rebuild_meta` | Force a full metadata rebuild (registry, backlinks, index, log) |
 | `wiki_log_event` | Append a structured event to the wiki activity log |
 | `wiki_watch` | Print a `crontab` line for automatic wiki updates (daily / weekly / hourly) — does not install it |
+| `wiki_capture_trajectory` _(opt-in)_ | Capture the completed task's tool-call trajectory (agent working-memory) |
+| `wiki_distill_skills` _(opt-in)_ | Batch undistilled trajectories for synthesis into reusable skill pages |
+| `wiki_recall_skill` _(opt-in)_ | Recall distilled skills + similar past cases — "have I done this before?" |
+
+> The three agent-trajectory tools are **off by default** (issue #80). Enable them with `/wiki-trajectories on` (sets `llm-wiki.trajectories`); when off they are not registered at all.
 
 ### Слэш-команды
 
@@ -120,6 +147,10 @@ The extension will proactively suggest creating a wiki on your first session. Al
 | `/wiki-status` | Show a concise operational summary |
 | `/wiki-digest [--period daily\|weekly]` | Generate a digest of recent activity |
 | `/wiki-retro` | Save atomic insights from completed tasks |
+| `/wiki-req <concept>` | Decompose a concept into atomic, traceable requirement pages |
+| `/wiki-trajectories <on\|off>` | Enable/disable agent working-memory (opt-in, off by default) |
+| `/wiki-record <title>` | Capture the completed task's trajectory (requires trajectories enabled) |
+| `/wiki-skills [query]` | Search distilled skills + past cases (requires trajectories enabled) |
 
 ---
 
@@ -357,7 +388,7 @@ The bundled `llm-wiki` skill teaches the model to:
 
 ### Слои Vault
 
-See the [Layered Vault Architecture](#layered-vault-architecture) section above for the personal/project/company layering.
+Описание личного, проектного и корпоративного уровней приведено выше в разделе [Многослойная архитектура Vault](#многослойная-архитектура-vault).
 
 ### Четырёхуровневая модель страниц