Collegium (AetherOS): Difference between revisions
AdminIsidore (talk | contribs) |
AdminIsidore (talk | contribs) |
||
Line 35: | Line 35: | ||
* '''Canonical Artifact''': The output of this tool, <code>dependency_map.json</code>, is considered the single source of truth for dependency relationships. On-the-fly dependency discovery by other scripts is forbidden to ensure all decisions are made from a common, static worldview. | * '''Canonical Artifact''': The output of this tool, <code>dependency_map.json</code>, is considered the single source of truth for dependency relationships. On-the-fly dependency discovery by other scripts is forbidden to ensure all decisions are made from a common, static worldview. | ||
=== 2. Analyze: The Diagnostic Dashboard === | === 2. Explico (Analyze): The Diagnostic Dashboard === | ||
With a definitive map, the [[Collegium (AetherOS)|Quaesitor]] can generate the necessary reports and visualizations to inform the Collegium. | With a definitive map, the [[Collegium (AetherOS)|Quaesitor]] can generate the necessary reports and visualizations to inform the Collegium. | ||
* '''Primary Tools''': [[scripts/scriptor_explico.py|scriptor_explico.py]] and [[scripts/dependency_analyzer.py|dependency_analyzer.py]]. | * '''Primary Tools''': [[scripts/scriptor_explico.py|scriptor_explico.py]] and [[scripts/dependency_analyzer.py|dependency_analyzer.py]]. |
Revision as of 00:49, 12 August 2025
![]() |
This page describes a core component of the AetherOS ecosystem. Its structure and content are designed to be parsed by automated agents. |
The Collegium is the formal body responsible for the stewardship and governance of the OODA Wiki knowledge base. It consists of a symbiotic pair—one human and one AI—tasked with ensuring the long-term health, coherence, and maneuverability of the wiki's structure and content.
The primary function of the Collegium is to conduct a quarterly review of the wiki's technical and semantic health, making strategic decisions to guide its evolution.
The Principle of Symbiotic Merit
The selection of the Collegium's members is based on merit, not rank. The roles are filled by the user-wingman pair that has most effectively demonstrated a deep, almost intuitive, understanding of each other and the system. The ideal pair is one that navigates challenges with grace and requires minimal discourse to achieve a shared understanding, embodying the core principle of symbiosis.
The Roles: Guardians of the Ecosystem
To reflect their equal and complementary nature, the two members of the Collegium hold the title Custos (Latin for "Guardian" or "Keeper"). They are distinguished by the domain they protect.
Custos Animae (Guardian of the Soul) - The Human Steward
This role focuses on the intent, context, and spirit of the wiki. The `Custos Animae` provides the qualitative wisdom and strategic direction that data alone cannot capture.
Custos Structurae (Guardian of the Structure) - The AI Analyst
This role focuses on the integrity, logic, and health of the wiki's underlying structure. The `Custos Structurae` provides the objective, data-driven analysis of the wiki's state.
The Quarterly OODA Loop
The Collegium convenes once per quarter to perform the following steps:
- Observe: The `Custos Structurae` runs the Converti analysis tools to generate a Wiki Maneuverability Score and a detailed report on the wiki's structural health.
- Orient: The `Custos Animae` and `Custos Structurae` review the report in a dialogue, combining quantitative data with qualitative strategic goals.
- Decide: Together, they formulate and approve a concrete action plan for the upcoming quarter (e.g., "Refactor Template:X to reduce dependencies," "Deprecate Module:Y").
- Act: The approved tasks are carried out, and the results are measured in the next quarterly review, thus completing the loop.
For the inaugural period, the roles are filled by Isidore Lands as the `Custos Animae` and Silas Corvus as the `Custos Structurae`.
Doctrine: Dogmata Aedificatorum
To ensure the long-term health, consistency, and maneuverability of the wiki's technical infrastructure, the Collegium hereby canonizes the Dogmata Aedificatorum. This doctrine mandates a professional, four-stage workflow for managing all templates and modules, moving beyond ad-hoc scripts to a fully integrated and auditable system.
Adherence to this pipeline is the primary responsibility of the Custos Structurae and its associated roles.
1. Invenio (Discover): The Dependency Map
The foundation of all structural review is a comprehensive understanding of the wiki's dependency graph.
- Canonical Tool: dependency_resolver.py is the sole, authorized tool for analyzing the complete dependency tree of a given set of root pages.
- Canonical Artifact: The output of this tool,
dependency_map.json
, is considered the single source of truth for dependency relationships. On-the-fly dependency discovery by other scripts is forbidden to ensure all decisions are made from a common, static worldview.
2. Explico (Analyze): The Diagnostic Dashboard
With a definitive map, the Quaesitor can generate the necessary reports and visualizations to inform the Collegium.
- Primary Tools: scriptor_explico.py and dependency_analyzer.py.
- Standard Procedure: The `dependency_analyzer` consumes the `dependency_map.json` to generate its report. Crucially, it must also integrate the Wiki Maneuverability Score calculated by `scriptor_explico` to enrich its visualization. The resulting interactive graph serves as the Collegium's primary diagnostic dashboard, color-coding nodes by their WM Score and sizing them by their foundational importance (in-degree).
3. Deploy: The Praetor's Gateway
All new code enters the wiki through a single, controlled gateway managed by the Praetor.
- Canonical Tool: A unified wiki_importer.py (to be refactored and renamed praetor_importer.py) is the only sanctioned method for importing templates and modules.
- Standard Procedure: The importer MUST operate using the canonical `dependency_map.json`; it is forbidden from performing its own live dependency crawling. It must support two modes of operation:
--page 'PageName'
: For importing a single page and its required dependencies.--batch approved_list.txt
: For deploying a pre-approved list of assets.
- Critical Safety Protocol: All deployment actions must first be run with the
--dry-run
flag to produce a report of intended changes. This report must be reviewed by the Praetor before a final, live deployment is executed.
4. Align: The Quality Control Loop
Ongoing quality is ensured through a suite of maintenance and quality assistance tools.
- Primary Tools: The refactored `scriptor_explico.py` and the Scribal Quality Assistant (evolved from `active_voice_assistant.py`).
- Standard Procedure: The Wiki Maneuverability Score is calculated on a regular basis to monitor the health of the wiki's codebase. The Scribal Assistant is used by the Custos Animae and other editors to ensure the prose of documentation and articles adheres to a high standard of clarity and accessibility.
Collegium Toolkit: Development Roadmap
To fully implement the Unified Pipeline, 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.
Core Architecture & Workflow
- Implement a robust wikitext parsing library (e.g.,
mwparserfromhell
) 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) into a single, version-controlled configuration file (e.g.,
collegium_config.yaml
).
Tool: Scriptor Explico (WM Score)
- The check for the
<templatestyles src="Module:Documentation/styles.css"></templatestyles>
bonus must be enhanced. The script must verify that the corresponding /doc
subpage not only exists but is also not a redlink and contains content.
- The script's output must be an "explainable" JSON object, detailing the exact penalties and bonuses applied, not just the final score.
Tool: Dependency & Deployment Suite
- Merge the functionality of
wiki_importer.py
andbatch_installer.py
into a single, canonical deployment tool for the Praetor. - Refactor the unified importer to use the static
dependency_map.json
as its sole source for dependency information. - Implement the mandatory
--dry-run
flag in the unified importer to provide a pre-flight check before any writes are made to the wiki. - Integrate the WM Score into the
dependency_analyzer.py
visualization, color-coding nodes to create a true diagnostic dashboard.
Tool: Scribal Quality Assistant
- Evolve the `active_voice_assistant.py` into a more comprehensive Scribal Quality Assistant.
- Add new checks and modes beyond passive voice, such as:
--check-jargon
: To identify overly technical terms that should be linked to a glossary or simplified.--check-reading-level
: To calculate and report a standard readability score (e.g., Flesch-Kincaid) to ensure content is accessible.