mnemon-mcp 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to mnemon-mcp will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0] - 2026-03-16
+
+### Added
+- 4-layer memory model: episodic, semantic, procedural, resource
+- 7 MCP tools: `memory_add`, `memory_search`, `memory_update`, `memory_delete`, `memory_inspect`, `memory_export`, `memory_health`
+- FTS5 full-text search with BM25 ranking and AND→OR fallback
+- Snowball stemming for English and Russian at index and query time
+- Progressive AND relaxation for complex multi-token queries
+- Fact versioning via superseding chains
+- Markdown knowledge base import pipeline with configurable routing
+- Temporal fact windows (valid_from / valid_until) and entity aliases
+- Memory decay scoring (episodic: 30-day, resource: 90-day half-life)
+- Contradiction detection on memory_add
+- `memory_health` tool: diagnostic report with expired entries, orphaned chains, stale memories, and optional GC
+- MCP Resources (stats, recent, layer, entity) and Prompts (recall, context-load, journal)
+- HTTP transport with Bearer auth, CORS, rate limiting, body size limits, graceful shutdown
+- Optional vector search with BYOK embeddings (OpenAI, Ollama) via sqlite-vec
+- Hybrid search mode combining FTS5 + vector via Reciprocal Rank Fusion (RRF)
+- Tool input schemas generated from Zod via `z.toJSONSchema()` — single source of truth
+- Import config with Zod validation
+- 182 tests (unit + integration + validation)
+- CI pipeline with build, test, and smoke tests
+
+[Unreleased]: https://github.com/nikitacometa/mnemon-mcp/compare/v1.0.0...HEAD
+[1.0.0]: https://github.com/nikitacometa/mnemon-mcp/releases/tag/v1.0.0

package/CONTRIBUTING.md

@@ -0,0 +1,59 @@
+# Contributing to mnemon-mcp
+
+## Philosophy
+
+**Air-gapped by design.** mnemon-mcp makes zero network calls. No telemetry, no analytics, no crash reporting, no pings to any external service. All data stays on the user's machine in `~/.mnemon-mcp/memory.db`.
+
+PRs adding telemetry, analytics, or any external network call will be rejected without review.
+
+## Development Setup
+
+```bash
+git clone https://github.com/nikitacometa/mnemon-mcp.git
+cd mnemon-mcp
+npm install
+npm run build
+npm test
+```
+
+Requires Node.js 22+ and TypeScript 5.9.
+
+## Running Locally
+
+```bash
+npm run dev
+```
+
+Smoke test — verify the server responds to JSON-RPC over stdio:
+
+```bash
+echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node dist/index.js
+```
+
+## Code Guidelines
+
+- **TypeScript strict mode** — no `any`, no unsafe casts, return types on all exported functions.
+- **Never use `console.log()` in `src/tools/` or `src/import/`** — stdout is the MCP JSON-RPC transport. Any stray output will corrupt the protocol. Use `console.error()` for debugging.
+- **Run `npm test` and `npm run build` before opening a PR.** Both must pass.
+- **Keep dependencies minimal.** Before adding a package, consider whether the standard library or an existing dep covers the use case.
+- **No `any`** — prefer `unknown` with a type guard, or a generic with a constraint.
+
+## PR Guidelines
+
+- One feature per PR. Split unrelated changes into separate PRs.
+- Include tests for all new functionality. The test runner is Vitest (`npm test`).
+- Update `README.md` if adding new MCP tools or changing observable behavior.
+- Reference the task board ID (e.g. `T-123`) in the PR description if applicable.
+
+## Security Policy
+
+- Never include memory content in error messages or log output.
+- Sanitize all user-supplied strings before embedding them in error responses.
+- No external API calls — not in tools, not in the import pipeline, not in tests.
+- Report security issues privately via GitHub Security Advisories, not in public issues.
+
+## Architecture Notes
+
+The server uses `better-sqlite3` (synchronous) because MCP stdio transport is inherently synchronous — async DB would add complexity with no benefit. Do not replace it with an async driver.
+
+FTS5 search lives in `src/tools/memory-search.ts`. The tokenizer is `unicode61` (Cyrillic + Latin). Stemming improvements belong in a pre-processing layer, not in the tokenizer config.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nikita Gorokhov
+
+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.

package/README.md

@@ -0,0 +1,434 @@
+# mnemon-mcp
+
+[![CI](https://github.com/nikitacometa/mnemon-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/nikitacometa/mnemon-mcp/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/mnemon-mcp)](https://www.npmjs.com/package/mnemon-mcp)
+[![Node.js](https://img.shields.io/badge/node-%E2%89%A522-brightgreen)](https://nodejs.org/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+**Persistent layered memory for AI agents.**
+Local-first. Zero-cloud. Single SQLite file.
+
+Your AI agent forgets everything after each session. Mnemon fixes that.
+
+It gives any [MCP](https://modelcontextprotocol.io)-compatible client — [OpenClaw](https://openclaw.ai), Claude Code, Cursor, Windsurf, or your own — a structured long-term memory backed by a single SQLite database on your machine. No API keys, no cloud, no telemetry. Just `npm install` and your agent remembers.
+
+---
+
+## Why Layered Memory?
+
+Flat key-value stores treat "what happened yesterday" the same as "never commit without tests." That's wrong — different kinds of knowledge have different lifetimes and access patterns.
+
+Mnemon organizes memories into **four layers**:
+
+| Layer | What it stores | How it's accessed | Lifetime |
+|-------|---------------|-------------------|----------|
+| **Episodic** | Events, sessions, journal entries | By date or period | Decays (30-day half-life) |
+| **Semantic** | Facts, preferences, relationships | By topic or entity | Stable |
+| **Procedural** | Rules, workflows, conventions | Loaded at startup | Rarely changes |
+| **Resource** | Reference material, book notes | On demand | Decays slowly (90 days) |
+
+A journal entry from last Tuesday and a coding rule that never changes live in different layers — because they should.
+
+## Quick Start
+
+### Install
+
+```bash
+npm install -g mnemon-mcp
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/nikitacometa/mnemon-mcp.git
+cd mnemon-mcp && npm install && npm run build
+```
+
+### Configure Your MCP Client
+
+<details open>
+<summary><strong>OpenClaw</strong></summary>
+
+```bash
+openclaw mcp register mnemon-mcp --command="mnemon-mcp"
+```
+
+Or add to `~/.openclaw/mcp_config.json`:
+
+```json
+{
+  "mnemon-mcp": {
+    "command": "mnemon-mcp"
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Claude Code</strong></summary>
+
+Add to `~/.claude/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "mnemon-mcp": {
+      "command": "mnemon-mcp"
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Cursor / Windsurf / Other MCP clients</strong></summary>
+
+Add to your client's MCP config:
+
+```json
+{
+  "mcpServers": {
+    "mnemon-mcp": {
+      "command": "mnemon-mcp"
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Running from source?</strong></summary>
+
+Use the full path to the compiled entry point:
+
+```json
+{
+  "mnemon-mcp": {
+    "command": "node",
+    "args": ["/absolute/path/to/mnemon-mcp/dist/index.js"]
+  }
+}
+```
+
+</details>
+
+### Verify
+
+```bash
+echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | mnemon-mcp
+```
+
+You should see 7 tools in the response. The database (`~/.mnemon-mcp/memory.db`) is created automatically on first run.
+
+That's it. Your agent now has persistent memory.
+
+## What It Can Do
+
+### 7 MCP Tools
+
+| Tool | What it does |
+|------|-------------|
+| **`memory_add`** | Store a memory with layer, entity, confidence, importance, and optional TTL |
+| **`memory_search`** | Full-text or exact search with filters by layer, entity, date, scope, confidence |
+| **`memory_update`** | Update in-place or create a versioned replacement (superseding chain) |
+| **`memory_delete`** | Delete a memory; re-activates its predecessor if any |
+| **`memory_inspect`** | Get layer statistics or trace a single memory's version history |
+| **`memory_export`** | Export to JSON, Markdown, or Claude-md format with filters |
+| **`memory_health`** | Run diagnostics: expired entries, orphaned chains, stale memories; optionally GC |
+
+### MCP Resources & Prompts
+
+**Resources** — live data your agent can read:
+
+| URI | Returns |
+|-----|---------|
+| `memory://stats` | Aggregate stats per layer |
+| `memory://recent` | Memories created/updated in last 24h |
+| `memory://layer/{layer}` | All active memories in a layer |
+| `memory://entity/{name}` | All active memories about an entity |
+
+**Prompts** — pre-built workflows:
+
+| Prompt | Purpose |
+|--------|---------|
+| `recall` | "Tell me everything you know about X" |
+| `context-load` | Load relevant context before starting a task |
+| `journal` | Create a structured journal entry |
+
+## Search
+
+Two modes, both supporting layer / entity / scope / date / confidence filters:
+
+**FTS mode** (default) — tokenized full-text search with BM25 ranking. Multi-word queries use AND; if too few results, OR supplements with a score penalty. Progressive AND relaxation tries top-3 most specific terms before falling back to full OR.
+
+Scores: `bm25 × (0.3 + 0.7 × importance) × decay(layer)`
+
+**Exact mode** — `LIKE` substring match for precise phrase lookups.
+
+### Stemming
+
+Snowball stemmer applied at both **index time** and **query time** for English and Russian. This means `"running"` matches `"runs"`, and `"книги"` matches `"книга"`. Stop words are filtered from queries to improve precision.
+
+## Fact Versioning
+
+Knowledge evolves. Mnemon doesn't delete old facts — it chains them:
+
+```
+v1: "Team uses React 17"  →  superseded_by: v2
+v2: "Team uses React 19"  →  supersedes: v1 (active)
+```
+
+Search returns only the latest version. `memory_inspect` with `include_history: true` reveals the full chain. `memory_delete` re-activates the predecessor — nothing is lost.
+
+## Vector Search (Optional, BYOK)
+
+Enable semantic similarity search by providing your own embedding API:
+
+```bash
+# OpenAI
+MNEMON_EMBEDDING_PROVIDER=openai MNEMON_EMBEDDING_API_KEY=sk-... mnemon-mcp
+
+# Ollama (local, free)
+MNEMON_EMBEDDING_PROVIDER=ollama mnemon-mcp
+```
+
+This unlocks two additional search modes:
+- **`mode: "vector"`** — pure cosine similarity search
+- **`mode: "hybrid"`** — FTS5 + vector combined via [Reciprocal Rank Fusion](https://www.singlestore.com/blog/hybrid-search-using-reciprocal-rank-fusion-in-sql/)
+
+Requires `sqlite-vec` (installed as optional dependency). New memories are embedded on add; existing ones can be backfilled.
+
+<details>
+<summary>Embedding configuration</summary>
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MNEMON_EMBEDDING_PROVIDER` | — | `openai` or `ollama` (unset = disabled) |
+| `MNEMON_EMBEDDING_API_KEY` | — | API key (required for OpenAI) |
+| `MNEMON_EMBEDDING_MODEL` | `text-embedding-3-small` / `nomic-embed-text` | Model name |
+| `MNEMON_EMBEDDING_DIMENSIONS` | `1024` / `768` | Vector dimensions |
+| `MNEMON_OLLAMA_URL` | `http://localhost:11434` | Ollama endpoint |
+
+</details>
+
+## Importing a Knowledge Base
+
+Got a folder of Markdown files? Import them in bulk:
+
+```bash
+cp config.example.json ~/.mnemon-mcp/config.json   # edit this first
+npm run import:kb -- --kb-path /path/to/your/kb     # incremental (skips unchanged files)
+```
+
+The config maps glob patterns to memory layers:
+
+```json
+{
+  "owner_name": "your-name",
+  "extra_stop_words": [],
+  "mappings": [
+    {
+      "glob": "journal/*.md",
+      "layer": "episodic",
+      "entity_type": "user",
+      "entity_name": "$owner",
+      "importance": 0.6,
+      "split": "h2"
+    },
+    {
+      "glob": "people/*.md",
+      "layer": "semantic",
+      "entity_type": "person",
+      "entity_name": "from-heading",
+      "importance": 0.8,
+      "split": "h3"
+    }
+  ]
+}
+```
+
+### Config Fields
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `owner_name` | string | Your name — used for `$owner` substitution in `entity_name` |
+| `extra_stop_words` | string[] | Words to filter from FTS queries (e.g., your name forms) |
+| `glob` | string | File pattern to match |
+| `layer` | string | Target memory layer |
+| `entity_type` | string | `user` / `person` / `project` / `concept` / `file` / `rule` / `tool` |
+| `entity_name` | string | Literal name, `"$owner"`, or `"from-heading"` (extract from H2/H3) |
+| `split` | string | `"whole"` (one memory per file), `"h2"`, or `"h3"` (split on headings) |
+| `importance` | number | 0.0–1.0, affects search ranking |
+| `confidence` | number | 0.0–1.0, filterable in search |
+| `scope` | string | Optional namespace |
+
+## HTTP Transport
+
+For remote or multi-client setups:
+
+```bash
+MNEMON_AUTH_TOKEN=your-secret MNEMON_PORT=3000 npm run start:http
+```
+
+| Endpoint | Description |
+|----------|-------------|
+| `POST /mcp` | MCP JSON-RPC (Bearer auth if token set) |
+| `GET /health` | `{"status":"ok","version":"..."}` |
+
+Rate limiting (100 req/min/IP by default), CORS headers, 1MB body limit, timing-safe auth, graceful shutdown on SIGTERM.
+
+## Configuration Reference
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MNEMON_DB_PATH` | `~/.mnemon-mcp/memory.db` | Database path |
+| `MNEMON_KB_PATH` | `.` | Knowledge base root for import |
+| `MNEMON_CONFIG_PATH` | `~/.mnemon-mcp/config.json` | Import config path |
+| `MNEMON_AUTH_TOKEN` | — | Bearer token for HTTP transport |
+| `MNEMON_PORT` | `3000` | HTTP transport port |
+| `MNEMON_CORS_ORIGIN` | `*` | CORS `Access-Control-Allow-Origin` |
+| `MNEMON_RATE_LIMIT` | `100` | Max requests per minute per IP (0 = off) |
+
+## Tool Reference
+
+<details>
+<summary><code>memory_add</code> — full parameter list</summary>
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `content` | string | Yes | Memory text (max 100K chars) |
+| `layer` | string | Yes | `episodic` / `semantic` / `procedural` / `resource` |
+| `title` | string | No | Short title (max 500 chars) |
+| `entity_type` | string | No | `user` / `project` / `person` / `concept` / `file` / `rule` / `tool` |
+| `entity_name` | string | No | Entity name for filtering |
+| `confidence` | number | No | 0.0–1.0 (default 0.8) |
+| `importance` | number | No | 0.0–1.0 (default 0.5) |
+| `scope` | string | No | Namespace (default `global`) |
+| `source_file` | string | No | Source file path — triggers auto-supersede of matching entries |
+| `ttl_days` | number | No | Auto-expire after N days |
+| `valid_from` / `valid_until` | string | No | Temporal fact window (ISO 8601) |
+
+</details>
+
+<details>
+<summary><code>memory_search</code> — full parameter list</summary>
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `query` | string | Yes | Search text |
+| `mode` | string | No | `fts` (default), `exact`, `vector`, `hybrid` |
+| `layers` | string[] | No | Filter by layers |
+| `entity_name` | string | No | Filter by entity (supports aliases) |
+| `scope` | string | No | Filter by scope |
+| `date_from` / `date_to` | string | No | Date range (ISO 8601) |
+| `as_of` | string | No | Temporal fact filter — facts valid at this date |
+| `min_confidence` | number | No | Minimum confidence |
+| `min_importance` | number | No | Minimum importance |
+| `limit` | number | No | Max results (default 10, max 100) |
+| `offset` | number | No | Pagination offset |
+
+</details>
+
+<details>
+<summary><code>memory_update</code> — full parameter list</summary>
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `id` | string | Yes | Memory ID |
+| `content` | string | No | New content |
+| `title` | string | No | New title |
+| `confidence` | number | No | New confidence |
+| `importance` | number | No | New importance |
+| `supersede` | boolean | No | `true` = versioned replacement; `false` (default) = in-place |
+| `new_content` | string | No | Content for superseding entry |
+
+</details>
+
+<details>
+<summary><code>memory_delete</code></summary>
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `id` | string | Yes | Memory ID. Re-activates predecessor if part of a superseding chain |
+
+</details>
+
+<details>
+<summary><code>memory_inspect</code></summary>
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `id` | string | No | Memory ID (omit for aggregate stats) |
+| `layer` | string | No | Filter stats by layer |
+| `entity_name` | string | No | Filter stats by entity |
+| `include_history` | boolean | No | Show superseding chain |
+
+</details>
+
+<details>
+<summary><code>memory_export</code></summary>
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `format` | string | Yes | `json` / `markdown` / `claude-md` |
+| `layers` | string[] | No | Filter by layers |
+| `scope` | string | No | Filter by scope |
+| `date_from` / `date_to` | string | No | Date range |
+| `limit` | number | No | Max entries (default all, max 10K) |
+
+</details>
+
+<details>
+<summary><code>memory_health</code></summary>
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `cleanup` | boolean | No | `true` = garbage-collect expired entries (default: report only) |
+
+Returns: status (`healthy` / `warning` / `degraded`), per-layer stats, expired entries, orphaned chains, stale/low-confidence counts, cleaned count when `cleanup=true`.
+
+</details>
+
+## How It Compares
+
+| | **mnemon-mcp** | mem0 | basic-memory | Anthropic KG |
+|---|---|---|---|---|
+| **Architecture** | SQLite FTS5 | Cloud API + Qdrant | Markdown + vector | JSON file |
+| **Memory structure** | 4 typed layers | Flat | Flat | Graph |
+| **Fact versioning** | Superseding chains | Partial | No | No |
+| **Stemming** | EN + RU (Snowball) | EN only | EN only | None |
+| **OpenClaw support** | Native MCP | No | No | No |
+| **Dependencies** | 0 required | Qdrant, Neo4j, Ollama | FastEmbed, Python 3.12 | None |
+| **Cloud required** | No | Yes | No (SaaS optional) | No |
+| **Cost** | Free | $19–249/mo | Free + SaaS | Free |
+| **Setup** | `npm install -g` | Docker + API keys | pip + deps | Built-in |
+| **License** | MIT | Apache 2.0 | AGPL | MIT |
+
+## Development
+
+```bash
+npm run dev        # run via tsx (no build step)
+npm run build      # TypeScript → dist/
+npm test           # vitest (182 tests)
+npm run bench      # performance benchmarks
+npm run db:backup  # backup database
+```
+
+**Stack:** TypeScript 5.9 (strict mode), better-sqlite3, @modelcontextprotocol/sdk, Snowball stemmer, Zod, vitest.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for code guidelines.
+
+## Design Principles
+
+- **Air-gapped** — zero network calls, zero telemetry. Your memories stay on your machine.
+- **Single file** — one SQLite database, zero ops, instant backup via file copy.
+- **Deterministic search** — FTS5, not embeddings, is the default. Interpretable, reproducible, no GPU needed.
+- **Structured over flat** — layers encode access patterns; superseding chains encode time.
+- **Minimal** — 4 production dependencies. Works everywhere Node runs.
+
+## License
+
+[MIT](LICENSE)

package/SECURITY.md

@@ -0,0 +1,29 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported |
+|---------|-----------|
+| 1.x     | Yes       |
+
+## Reporting a Vulnerability
+
+**Do not open a public issue for security vulnerabilities.**
+
+Report security issues via [GitHub Security Advisories](https://github.com/nikitacometa/mnemon-mcp/security/advisories/new).
+
+Expected response time: 48 hours for acknowledgment, 7 days for initial assessment.
+
+## Scope
+
+mnemon-mcp is a local-first tool — it makes zero network calls by design (unless HTTP transport is explicitly enabled). Security-relevant areas:
+
+- **SQL injection** — all queries use parameterized statements; FTS5 MATCH input is sanitized
+- **Path traversal** — import pipeline validates paths within the configured KB root
+- **HTTP transport** — Bearer token auth with timing-safe comparison; 1MB body size limit
+- **Data at rest** — SQLite database stored at `~/.mnemon-mcp/memory.db` with user-only permissions
+
+## Out of Scope
+
+- Denial of service via large imports (local tool, single user)
+- Memory content in error messages (intentionally excluded per CONTRIBUTING.md)

package/config.example.json

@@ -0,0 +1,52 @@
+{
+  "owner_name": "your-name",
+  "extra_stop_words": [],
+  "mappings": [
+    {
+      "glob": "journal/*.md",
+      "layer": "episodic",
+      "entity_type": "user",
+      "entity_name": "$owner",
+      "importance": 0.6,
+      "confidence": 0.9,
+      "split": "h2"
+    },
+    {
+      "glob": "people/*.md",
+      "layer": "semantic",
+      "entity_type": "person",
+      "entity_name": "from-heading",
+      "importance": 0.8,
+      "confidence": 0.8,
+      "split": "h3"
+    },
+    {
+      "glob": "projects/*.md",
+      "layer": "semantic",
+      "entity_type": "project",
+      "entity_name": "from-heading",
+      "importance": 0.7,
+      "confidence": 0.8,
+      "split": "h2"
+    },
+    {
+      "glob": "knowledge/*.md",
+      "layer": "semantic",
+      "entity_type": "concept",
+      "entity_name": "from-heading",
+      "importance": 0.6,
+      "confidence": 0.8,
+      "split": "h2"
+    },
+    {
+      "glob": "notes/*.md",
+      "layer": "resource",
+      "entity_type": "concept",
+      "entity_name": "from-heading",
+      "importance": 0.5,
+      "confidence": 0.8,
+      "split": "h2"
+    }
+  ],
+  "external_files": []
+}