Converti (AetherOS): Difference between revisions

Line 10:

== The Converti Toolkit ==

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

Converti is comprised of a single command-line interface (main.py) that provides several commands, each serving a specific function in the Collegium's review process.

=== Stage 1: ~~Dependency Analysis~~ ===

=== Stage 1: Map Dependencies ===

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

The first step is to map the full dependency tree of a set of root templates from a source wiki (like Wikipedia) to a named JSON file.

* '''`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 ===~~

'''map command''': Scans a list of templates on a specified source wiki (--source-family) and recursively maps every sub-template and Lua module they depend on. The result is saved to a specified output file (--output).

~~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~~ ===

=== Stage 2: Audit & Analyze ===

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

The second step is to analyze the generated dependency map to assess its technical debt.

* '''~~`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~~.

'''audit command''': Ingests a dependency map (--map-file) and generates a human-readable report (dependency_report.txt) and an interactive graph (dependency_graph.html). This command calculates a '''[[Wiki Maneuverability Score]]''' for each component based on its complexity, dependency count, and documentation quality, highlighting the most foundational and complex pages.

=== Stage 3: Deploy to Wiki ===

After the Collegium has reviewed the analysis and created a curated approved_list.txt, this command imports only the necessary components to the target wiki.

'''deploy command''': Reads the approved list and a dependency map. It then resolves the full dependency tree and surgically imports only the required pages from the source wiki to the target (ooda.wiki), skipping any that already exist. A --dry-run flag allows for simulating the deployment without making any edits.

== 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.

'''refactor command''': (Under Development) An assistant that uses an LLM to review low-scoring templates and suggest simplifications or alternative implementations.

'''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.

@@ Line 10: / Line 10: @@
 == The Converti Toolkit ==
-Converti is comprised of several distinct scripts, each serving a specific function in the Collegium's review process.
+Converti is comprised of a single command-line interface (main.py) that provides several commands, each serving a specific function in the Collegium's review process.
-=== Stage 1: Dependency Analysis ===
+=== Stage 1: Map Dependencies ===
-The first step is to map the full dependency tree of a set of root templates from an external source like Wikipedia.
+The first step is to map the full dependency tree of a set of root templates from a source wiki (like Wikipedia) to a named JSON file.
-* '''`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 ===
+'''map command''': Scans a list of templates on a specified source wiki (--source-family) and recursively maps every sub-template and Lua module they depend on. The result is saved to a specified output file (--output).
-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 ===
+=== Stage 2: Audit & Analyze ===
-Once templates are imported, the Collegium can analyze their quality and complexity.
+The second step is to analyze the generated dependency map to assess its technical debt.
-* '''`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.
+'''audit command''': Ingests a dependency map (--map-file) and generates a human-readable report (dependency_report.txt) and an interactive graph (dependency_graph.html). This command calculates a '''[[Wiki Maneuverability Score]]''' for each component based on its complexity, dependency count, and documentation quality, highlighting the most foundational and complex pages.
+=== Stage 3: Deploy to Wiki ===
+After the Collegium has reviewed the analysis and created a curated approved_list.txt, this command imports only the necessary components to the target wiki.
+'''deploy command''': Reads the approved list and a dependency map. It then resolves the full dependency tree and surgically imports only the required pages from the source wiki to the target (ooda.wiki), skipping any that already exist. A --dry-run flag allows for simulating the deployment without making any edits.
 == 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.
+'''refactor command''': (Under Development) An assistant that uses an LLM to review low-scoring templates and suggest simplifications or alternative implementations.
+'''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.

Converti (AetherOS): Difference between revisions

Navigation menu

Search