Reference: openwiki_emulator.py

Zero-binary, pure Python CLI tool emulating the OpenWiki documentation environment. Deep State of Mind framework. Deep State of Mind framework.

Zero-binary, pure Python CLI tool emulating the OpenWiki documentation environment.

Description

The openwiki_emulator.py script replaces external Node.js binaries and cloud APIs with localised, offline execution. It compiles 9 markdown wiki pages, repairs Mermaid schemas, and exports an interactive graph visualiser.

Script path

tools/openwiki_emulator.py

CLI options

# Initialise and compile the full OpenWiki workspace (default action)

uv run python tools/openwiki_emulator.py --init

# Retrieve recent Git changes and update context history

uv run python tools/openwiki_emulator.py --update

# Perform search against OpenWiki YAML metadata

uv run python tools/openwiki_emulator.py --search "ansible"

# Export a standalone offline HTML interactive knowledge graph

uv run python tools/openwiki_emulator.py --export-graph

Inputs

• Git status: System porcelain variables used to determine modified workspace files.
• Planned pages map: Hardcoded schemas defining initial wiki content and layouts.

Outputs

All workspace files created inside ./openwiki/:

• INSTRUCTIONS.md: Standard CLI operating procedures and rules.
• _skeleton.md: Ranking matrices and structural subsystems mapping.
• graph.html: Interactive standalone knowledge visualization layout.
• quickstart.md / architecture / automation / memory: Structured markdown documents.
• .last-update.json: Dynamic JSON execution tracker log.

Dependencies

• Python: 3.12+ (standard uv environment).
• pyyaml: YAML data loading engine.

Internal Python API

validate_mermaid_diagram(code)

Validates Mermaid diagram layout syntax, bracket matches, and unescaped quotes.

• Arguments: code (raw string of the diagram block).
• Returns: (bool, reason) tuple representing valid status and description.

process_markdown_file(filepath)

Scans a markdown file, detects corrupted or plain code fences, and repairs them.

• Arguments: filepath (absolute target file pathlib.Path).
• Mechanism: Degrades blocks in place with errors; heals corrected blocks back to active schemas.

---

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