> ## Documentation Index
> Fetch the complete documentation index at: https://harisfazillah.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 🌐 OpenWiki Integration Blueprint & Native Python Emulator Architecture

> Production guide, architectural specification, and reusable implementation blueprint for native Python OpenWiki emulation. Deep State of Mind framework.

## 🏛️ 1. Architectural Overview & Feasibility

Evaluating the adoption of **LangChain's OpenWiki** ([`github.com/langchain-ai/openwiki`](https://github.com/langchain-ai/openwiki)) within the Deep State of Mind (DSOM) ecosystem demonstrates an ideal architectural fit. OpenWiki provides an open-source, structured wiki knowledge graph engine that converts raw markdown archives into navigable, machine-readable concepts.

By adopting OpenWiki into the DSOM framework, the Cognitive Twin enhances its **Semantic Memory (Sovereign Markdown Palace)** and reinforces **Rule 15** (*Knowledge Compounding / LLM WIKI Mandate*).

***

## 🐍 2. Native Python OpenWiki Emulator Architecture (Rule 27)

To eliminate runtime friction associated with Node.js binaries (`NODE_MODULE_VERSION` mismatches, Visual Studio C++ `better-sqlite3` build dependencies, Windows UAC background elevation hangs, and 135 MB node\_modules disk bloat), DSOM introduces the **Native Python OpenWiki Emulator (`tools/openwiki_emulator.py`)**.

### Key Architectural Advantages:

1. **Zero External Binaries:** Requires zero Node.js binaries, `npm` packages, or C++ compilers.
2. **Environment Isolation:** Executes natively via `uv run --with pyyaml python tools/openwiki_emulator.py` (Rule 16).
3. **API Rate Limit Resilience (Error 429 Bypass):** Local AI agents (Gemini, Claude, GPT-4) read `./openwiki/_skeleton.md` and complete page synthesis autonomously without consuming external LLM API rate limits.
4. **Repository Footprint Optimisation:** Reclaims **\~135.3 MB** of disk space, maintaining overall repository size at **\~30.84 MB**.

***

## 🛠️ 3. Implementation Code Sampling & AI Prompt Template

Developers and human architects can replicate this zero-binary architecture on any project using the code sample and prompt template below.

### Code Sample: `tools/openwiki_emulator.py`

```python theme={null}

# /// script
# dependencies = [

#     "pyyaml>=6.0",
# ]

# ///

"""
OpenWiki Emulator & Knowledge Graph Generator
Author:   Harisfazillah Jamel (LinuxMalaysia)
License:  GNU General Public License v3.0

Description:
Emulates the OpenWiki CLI documentation & knowledge graph generation natively in Python
using `uv run`, requiring zero Node.js binaries or external API keys.
"""

import datetime
import json
import os
import pathlib
import sys
import yaml

REPO_ROOT = pathlib.Path(__file__).resolve().parent.parent
OPENWIKI_DIR = REPO_ROOT / "openwiki"

def get_timestamp() -> str:
    return datetime.datetime.now(datetime.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")

def ensure_openwiki_dirs():
    dirs = [
        OPENWIKI_DIR,
        OPENWIKI_DIR / "architecture",
        OPENWIKI_DIR / "governance",
        OPENWIKI_DIR / "memory",
        OPENWIKI_DIR / "automation",
        OPENWIKI_DIR / "integrations",
        OPENWIKI_DIR / "publishing",
        OPENWIKI_DIR / "quality",
    ]
    for d in dirs:
        d.mkdir(parents=True, exist_ok=True)

def main():
    print(f"[OpenWiki Emulator] Generating native wiki under {OPENWIKI_DIR}...")
    ensure_openwiki_dirs()
    print("[OpenWiki Emulator] Successfully updated ./openwiki/ structure.")

if __name__ == "__main__":
    main()

```

### AI Prompt Template for Building Custom Emulators

Copy and paste this prompt to any AI assistant (Gemini, ChatGPT, Claude, Cursor) to generate a custom OpenWiki emulator for your repository:

```text theme={null}
================================================================================
AI PROMPT TEMPLATE: BUILD A NATIVE PYTHON OPENWIKI EMULATOR SCRIPT
================================================================================

"You are a Senior Systems Architect. I want you to build a native Python
OpenWiki Emulator script for our repository that runs via `uv run`.

Requirements:
1. Create a script at `tools/openwiki_emulator.py` with inline `uv` metadata (`pyyaml>=6.0`).
2. Analyze our repository's directory topology, key configuration files (README.md, AGENTS.md, etc.), and test suites.
3. Automatically generate and maintain the `./openwiki/` directory structure:
   - `openwiki/_skeleton.md` (Inventory ranking, planned page tree, evidence briefs).
   - `openwiki/quickstart.md` (Topology map and task-routing table).
   - Subsystem folders for architecture, governance, memory, automation, integrations, publishing, quality.
   - `openwiki/.last-update.json` (Containing ISO timestamp and compilation status).
4. All generated markdown files MUST include OKF v0.1 YAML frontmatter (okf_version, type, title, timestamp, topics, description).
5. The script MUST run non-interactively without Node.js binaries, npm packages, or external API keys."
================================================================================

```

***

## 💻 4. Deployment Matrix & Legacy CLI Fallbacks

| Execution Path                         | Engine              | Commands                                                 | Use Case                                                     |
| :------------------------------------- | :------------------ | :------------------------------------------------------- | :----------------------------------------------------------- |
| **Native Python Emulator (Mandatory)** | Python 3.10+ & `uv` | `uv run --with pyyaml python tools/openwiki_emulator.py` | Local development, CI/CD pipelines, zero-binary environments |
| **Linux Node.js CLI (Legacy)**         | Node.js 20+         | `openwiki code --init` / `openwiki visualize`            | Headless Linux servers with pre-installed Node               |

***

## 🔗 5. References

* **OpenWiki Operational HOWTO:** [`docs/tools/HOWTO-OPENWIKI.md`](file:///docs/tools/HOWTO-OPENWIKI)
* **OpenWiki Agent Skill:** [`SKILL.md`](file:///.agents/skills/openwiki-compiler/SKILL.md)
* **DSOM Rule 27 (Native OpenWiki Emulator Mandate):** [`AGENTS.md`](file:///AGENTS)

***

*Deep State of Mind (DSOM) For My AI Protocol | Harisfazillah Jamel (LinuxMalaysia) | 2026-08-09*
*Standard: UK English | DBP-standard Bahasa Melayu Malaysia (Piawai) | GNU General Public License v3.0*


## Related topics

- [🛠️ HOWTO: Operating OpenWiki & Native Python Zero-Binary Emulator](/tools/howto-openwiki.md)
- [Google Jules & Google Antigravity Collaborative Sync](/skills/jules-antigravity-sync.md)
- [🛠️ HOWTO: Operating DSOM FastMCP Knowledge Server](/tools/howto-mcp-server.md)
- [Explanation: OpenWiki & FastMCP Architecture](/explanation/openwiki-mcp-architecture.md)
- [OpenWiki Knowledge Graph Compiler Skill](/skills/openwiki-compiler.md)