Collegium (AetherOS): Difference between revisions

Jump to navigation Jump to search
← Older editNewer edit →
AdminIsidore (talk | contribs)
aether-access, Bureaucrats, contubadmin, duffers, Interface administrators, latin, liberty, mystery, proveit, Suppressors, swift, Administrators, Upload Wizard campaign editors, VisualData admin, VisualData editor, wayfinder
101 edits
AdminIsidore (talk | contribs)
aether-access, Bureaucrats, contubadmin, duffers, Interface administrators, latin, liberty, mystery, proveit, Suppressors, swift, Administrators, Upload Wizard campaign editors, VisualData admin, VisualData editor, wayfinder
101 edits
No edit summary
Line 70: Line 70:
# '''Layer 4: Automated Oversight (The Watcher):''' A maintenance bot, operated by the `Custos Structurae`, will periodically scan for non-compliant pages that may have bypassed the filter. The bot is authorized to revert non-compliant creations and notify the creator, ensuring the integrity of the policy.
# '''Layer 4: Automated Oversight (The Watcher):''' A maintenance bot, operated by the `Custos Structurae`, will periodically scan for non-compliant pages that may have bypassed the filter. The bot is authorized to revert non-compliant creations and notify the creator, ensuring the integrity of the policy.


== 5. Collegium Toolkit: Development Roadmap ==
== 5. Converti: The Collegium's SDK and Development Roadmap ==
To fully implement the Unified Pipeline and the mandates for structural integrity, the following development tasks have been identified. They represent the official roadmap for evolving the Collegium's script collection into a professional-grade System Administration SDK.
The "Collegium Toolkit" is not a loose collection of scripts; it is a single, integrated SDK known as '''[[Converti (AetherOS)|Converti]]'''. All previously separate tools are to be deprecated and their functionality folded into `Converti` as distinct commands and capabilities.


=== 5.1 Core Architecture & Workflow ===
`Converti` is the canonized, opinionated, CLI-based quality and production system for the AetherOS wiki. It is designed to be downloaded and run directly in the terminal by any contributor—human developers and their AI Wingmen ([[ARC (AetherOS)|Code Virtuoso's Companions]]) alike. Its sole purpose is to provide a unified pipeline to draft, validate, and deploy high-quality, "virtuous" code to the wiki, and to assist in the removal or refactoring of graceless code.
* Implement a robust wikitext parsing library (e.g., <code>mwparserfromhell</code>) across all scripts to replace brittle regular expressions. This is the highest-priority technical-debt payment.
* Centralize all tunable constants (e.g., WM Score penalty weights, sanctioned formatter paths) into a single, version-controlled configuration file (e.g., <code>collegium_config.yaml</code>).
* Integrate the sanctioned PHP, Lua, and CSS formatters into the `Converti` SDK to automate the enforcement of the Formatter Toolchain mandate.


=== 5.2 Tool: Scriptor Explico (WM Score) ===
The following roadmap outlines the planned evolution of `Converti` into this comprehensive SDK.
* The check for the <code>{{documentation}}</code> bonus must be enhanced. The script must verify that the corresponding <code>/doc</code> subpage not only exists but is also not a redlink and contains a minimum character count.
* The script's output must be an "explainable" JSON object, detailing the exact penalties and bonuses applied, not just the final score.


=== 5.3 Tool: Dependency & Deployment Suite ===
=== 5.1 Core Architecture and Pipeline ===
* Merge the functionality of <code>wiki_importer.py</code> and <code>batch_installer.py</code> into a single, canonical deployment tool for the Praetor, tentatively named '''praetor_importer.py'''.
The foundation of the SDK will be upgraded to ensure maximum robustness and automation.
* Refactor the unified importer to use the static <code>dependency_map.json</code> as its sole source for dependency information. On-the-fly crawling is deprecated.
* '''Parsing Engine Upgrade:''' `Converti`'s wikitext parsing engine will be rebuilt using a dedicated library (e.g., <code>mwparserfromhell</code>). This will replace all brittle regular expression-based logic, ensuring accurate and reliable analysis of complex templates and modules. This is the highest-priority technical-debt payment.
* Implement the mandatory <code>--dry-run</code> flag in the unified importer to provide a pre-flight check before any writes are made to the wiki.
* '''Centralized Configuration:''' `Converti` will be driven by a single, version-controlled configuration file, <code>collegium_config.yaml</code>. This file will contain all tunable constants, including WM Score weights and formatter paths, making the entire system's behavior transparent and easy to adjust.
* Integrate the WM Score into the <code>dependency_analyzer.py</code> visualization, color-coding nodes to create a true diagnostic dashboard for the Quaesitor.
* '''Integrated Formatter Toolchain:''' The sanctioned code formatters ('''[[https://github.com/pretty-php/pretty-php|pretty-php]]''', '''[[https://github.com/JohnnyMorganz/StyLua|StyLua]]''', and '''[[https://prettier.io/|Prettier]]''') will be integrated directly into the SDK. A new command, <code>converti format</code>, will be created to automatically apply the canonized style to any staged codebase.


=== 5.4 Tool: Scribal Quality Assistant ===
=== 5.2 Commands for Analysis and Discovery (The Quaesitor's Toolkit) ===
* Evolve the `active_voice_assistant.py` into a more comprehensive '''Scribal Quality Assistant'''.
This suite of commands allows the [[Collegium (AetherOS)|Quaesitor]] to map and audit the wiki's entire structural landscape.
* Add new checks and modes beyond passive voice, such as:
* '''<code>converti map</code>''': This command replaces the standalone `dependency_resolver.py`. It takes a list of root pages as input and generates the canonical <code>dependency_map.json</code> artifact, which serves as the static worldview for all other commands.
** <code>--check-jargon</code>: To identify overly technical terms that should be linked to a glossary or simplified.
* '''<code>converti audit</code>''': This powerful command replaces both `dependency_analyzer.py` and `scriptor_explico.py`. It consumes the <code>dependency_map.json</code> and performs a full analysis, generating:
** <code>--check-reading-level</code>: To calculate and report a standard readability score (e.g., Flesch-Kincaid) to ensure content is accessible to a broader audience.
** The '''[[Wiki Maneuverability Score]]''' for every page in the map, with an enhanced check to ensure documentation pages exist and are not empty.
** A detailed, "explainable" JSON output that breaks down the calculation for each page's score.
** A human-readable text report summarizing the most foundational and complex pages.
** An enriched, interactive HTML graph where nodes are '''color-coded by their WM Score''' and '''sized by their foundational importance''', creating a true diagnostic dashboard.
 
=== 5.3 Commands for Deployment and Maintenance (The Praetor's Gateway) ===
This suite provides the tools for the [[Collegium (AetherOS)|Praetor]] and [[Collegium (AetherOS)|Custos Animae]] to manage the lifecycle of code on the wiki.
* '''<code>converti deploy</code>''': This command replaces both `wiki_importer.py` and `batch_installer.py`, becoming the sole, sanctioned gateway for deploying code. It is driven by the static dependency map and supports two primary modes:
** <code>converti deploy --page 'Template:Infobox'</code>: For deploying a single asset and its dependencies.
** <code>converti deploy --batch approved_list.txt</code>: For executing a controlled, batch deployment of pre-vetted assets.
* '''Mandatory Dry-Run Protocol:''' The `deploy` command will feature a mandatory <code>--dry-run</code> flag. This provides a pre-flight check that generates a report of all proposed changes (creations, skips, errors) without writing to the wiki, ensuring all deployments are deliberate and auditable.
* '''<code>converti assist</code>''': This command evolves the `active_voice_assistant.py` into a comprehensive '''Scribal Quality Assistant''' for interactive content improvement. It will feature several modes for authors:
** <code>--check-voice</code>: The original check for passive voice.
** <code>--check-jargon</code>: Identifies overly technical terms that should be linked to a glossary or simplified.
** <code>--check-reading-level</code>: Calculates a standard readability score to ensure content is accessible.
Retrieved from "https://www.ooda.wiki/wiki/Collegium_(AetherOS)"