Converti (AetherOS)

Converti is a command-line utility suite designed to manage the lifecycle of templates and modules within the AetherOS ecosystem. It serves as the primary toolkit for the Collegium (AetherOS), enabling the analysis, controlled importation, and quality assurance of the wiki's structural components.

The tool was developed by Isidore Lands and Silas Corvus.

Purpose in Symbiotic Learning

The core purpose of Converti is to ensure the structural integrity and maneuverability of the wiki's knowledge base. A lean, well-documented, and minimally dependent codebase is essential for the symbiotic learning between users and their Wingman AIs.

By providing tools to analyze and gracefully import components, Converti prevents "dependency hell" and ensures the wiki does not become cluttered with the unmanaged complexity of its source wikis.

The Converti Toolkit

Converti is comprised of several distinct scripts, each serving a specific function in the Collegium's review process.

Stage 1: Dependency Analysis

The first step is to map the full dependency tree of a set of root templates from an external source like Wikipedia.

• `dependency_resolver.py`: Scans a list of templates and recursively maps every sub-template and Lua module they depend on, saving the result to `dependency_map.json`.
• `dependency_analyzer.py` (`scriptor_explico.py`): Ingests the raw dependency map and generates a human-readable report (`dependency_report.txt`) and an interactive graph (`dependency_graph.html`), highlighting the most foundational and complex components.

Stage 2: Controlled Import

After the `Custos Animae` and `Custos Structurae` have reviewed the analysis and created a curated `approved_list.txt`, the batch installer imports only the necessary components.

• `batch_installer.py`: Reads the approved list and the dependency map, and surgically imports only the approved pages and their direct dependencies from Wikipedia, skipping any that already exist on ooda.wiki.

Stage 3: Quality Assurance & Refactoring

Once templates are imported, the Collegium can analyze their quality and complexity.

• `scriptor_explico.py`: Calculates a Wiki Maneuverability Score for each template based on its complexity, dependency count, and documentation quality.
• `refactoring_assistant.py`: (Under Development) An assistant that uses an LLM to review low-scoring templates and suggest simplifications or alternative implementations.

Future Development

• Active Voice Assistant: An on-wiki tool to help editors convert passive voice to active voice, further improving the clarity and readability of the knowledge base.