aether-colony 1.1.0

package/.aether/schemas/queen-wisdom.xsd

@@ -0,0 +1,325 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Queen-Wisdom XML Schema (XSD)
+
+  Purpose: Define the eternal memory structure for Aether colony wisdom.
+           This schema enables structured storage of learned patterns,
+           philosophical principles, and evolution tracking across sessions.
+
+  Architecture: Hybrid JSON/XML - JSON for runtime efficiency, XML for
+                eternal memory with full validation and versioning support.
+
+  Version: 1.0.0
+  Namespace: http://aether.colony/schemas/queen-wisdom/1.0
+-->
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
+           xmlns:qw="http://aether.colony/schemas/queen-wisdom/1.0"
+           elementFormDefault="unqualified"
+           attributeFormDefault="unqualified">
+
+  <!-- ============================================================ -->
+  <!-- Simple Types                                                 -->
+  <!-- ============================================================ -->
+
+  <!-- Confidence score: 0.0 to 1.0 -->
+  <xs:simpleType name="confidenceType">
+    <xs:restriction base="xs:decimal">
+      <xs:minInclusive value="0.0"/>
+      <xs:maxInclusive value="1.0"/>
+      <xs:fractionDigits value="2"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- ISO 8601 timestamp -->
+  <xs:simpleType name="timestampType">
+    <xs:restriction base="xs:dateTime">
+      <xs:pattern value="\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- Version string (semver format) -->
+  <xs:simpleType name="versionType">
+    <xs:restriction base="xs:string">
+      <xs:pattern value="\d+\.\d+\.\d+(-[a-zA-Z0-9]+)?"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- Domain classification -->
+  <xs:simpleType name="domainType">
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="architecture"/>
+      <xs:enumeration value="testing"/>
+      <xs:enumeration value="security"/>
+      <xs:enumeration value="performance"/>
+      <xs:enumeration value="ux"/>
+      <xs:enumeration value="process"/>
+      <xs:enumeration value="communication"/>
+      <xs:enumeration value="debugging"/>
+      <xs:enumeration value="general"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- Source type -->
+  <xs:simpleType name="sourceType">
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="queen"/>
+      <xs:enumeration value="user"/>
+      <xs:enumeration value="colony"/>
+      <xs:enumeration value="oracle"/>
+      <xs:enumeration value="observation"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- Priority level -->
+  <xs:simpleType name="priorityType">
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="critical"/>
+      <xs:enumeration value="high"/>
+      <xs:enumeration value="normal"/>
+      <xs:enumeration value="low"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- Wisdom ID: kebab-case identifier -->
+  <xs:simpleType name="wisdomIdType">
+    <xs:restriction base="xs:string">
+      <xs:pattern value="[a-z][a-z0-9-]*"/>
+      <xs:minLength value="3"/>
+      <xs:maxLength value="64"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- ============================================================ -->
+  <!-- Complex Types                                                -->
+  <!-- ============================================================ -->
+
+  <!-- Base wisdom entry type -->
+  <xs:complexType name="wisdomEntryType">
+    <xs:sequence>
+      <xs:element name="content" type="xs:string">
+        <xs:annotation>
+          <xs:documentation>The actual wisdom content - plain text or markdown</xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="context" type="xs:string" minOccurs="0">
+        <xs:annotation>
+          <xs:documentation>Optional context about when/where this wisdom applies</xs:documentation>
+        </xs:annotation>
+      </xs:element>
+      <xs:element name="examples" type="examplesType" minOccurs="0"/>
+      <xs:element name="related" type="relatedType" minOccurs="0"/>
+      <xs:element name="evolution" type="evolutionType" minOccurs="0"/>
+    </xs:sequence>
+    <xs:attribute name="id" type="wisdomIdType" use="required"/>
+    <xs:attribute name="confidence" type="confidenceType" use="required"/>
+    <xs:attribute name="domain" type="domainType" use="required"/>
+    <xs:attribute name="source" type="sourceType" use="required"/>
+    <xs:attribute name="created_at" type="timestampType" use="required"/>
+    <xs:attribute name="applied_count" type="xs:nonNegativeInteger" use="optional" default="0"/>
+    <xs:attribute name="last_applied" type="timestampType" use="optional"/>
+    <xs:attribute name="priority" type="priorityType" use="optional" default="normal"/>
+  </xs:complexType>
+
+  <!-- Examples container -->
+  <xs:complexType name="examplesType">
+    <xs:sequence>
+      <xs:element name="example" maxOccurs="unbounded">
+        <xs:complexType>
+          <xs:sequence>
+            <xs:element name="scenario" type="xs:string"/>
+            <xs:element name="application" type="xs:string"/>
+            <xs:element name="outcome" type="xs:string" minOccurs="0"/>
+          </xs:sequence>
+        </xs:complexType>
+      </xs:element>
+    </xs:sequence>
+  </xs:complexType>
+
+  <!-- Related wisdom references -->
+  <xs:complexType name="relatedType">
+    <xs:sequence>
+      <xs:element name="ref" maxOccurs="unbounded">
+        <xs:complexType>
+          <xs:attribute name="id" type="wisdomIdType" use="required"/>
+          <xs:attribute name="relationship" use="required">
+            <xs:simpleType>
+              <xs:restriction base="xs:string">
+                <xs:enumeration value="supersedes"/>
+                <xs:enumeration value="extends"/>
+                <xs:enumeration value="contradicts"/>
+                <xs:enumeration value="complements"/>
+                <xs:enumeration value="depends-on"/>
+              </xs:restriction>
+            </xs:simpleType>
+          </xs:attribute>
+        </xs:complexType>
+      </xs:element>
+    </xs:sequence>
+  </xs:complexType>
+
+  <!-- Evolution tracking -->
+  <xs:complexType name="evolutionType">
+    <xs:sequence>
+      <xs:element name="version" type="versionType"/>
+      <xs:element name="supersedes" type="wisdomIdType" minOccurs="0"/>
+      <xs:element name="changelog" type="xs:string" minOccurs="0"/>
+      <xs:element name="deprecated" type="xs:boolean" minOccurs="0" default="false"/>
+      <xs:element name="deprecated_reason" type="xs:string" minOccurs="0"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <!-- Philosophy entry (extends base) -->
+  <xs:complexType name="philosophyType">
+    <xs:complexContent>
+      <xs:extension base="wisdomEntryType">
+        <xs:sequence>
+          <xs:element name="principles" minOccurs="0">
+            <xs:complexType>
+              <xs:sequence>
+                <xs:element name="principle" type="xs:string" maxOccurs="unbounded"/>
+              </xs:sequence>
+            </xs:complexType>
+          </xs:element>
+        </xs:sequence>
+      </xs:extension>
+    </xs:complexContent>
+  </xs:complexType>
+
+  <!-- Pattern entry (extends base) -->
+  <xs:complexType name="patternType">
+    <xs:complexContent>
+      <xs:extension base="wisdomEntryType">
+        <xs:sequence>
+          <xs:element name="pattern_type" minOccurs="0">
+            <xs:simpleType>
+              <xs:restriction base="xs:string">
+                <xs:enumeration value="success"/>
+                <xs:enumeration value="failure"/>
+                <xs:enumeration value="anti-pattern"/>
+                <xs:enumeration value="emerging"/>
+              </xs:restriction>
+            </xs:simpleType>
+          </xs:element>
+          <xs:element name="detection_criteria" type="xs:string" minOccurs="0"/>
+        </xs:sequence>
+      </xs:extension>
+    </xs:complexContent>
+  </xs:complexType>
+
+  <!-- Redirect entry (hard constraints) -->
+  <xs:complexType name="redirectType">
+    <xs:complexContent>
+      <xs:extension base="wisdomEntryType">
+        <xs:sequence>
+          <xs:element name="constraint_type" minOccurs="0">
+            <xs:simpleType>
+              <xs:restriction base="xs:string">
+                <xs:enumeration value="must"/>
+                <xs:enumeration value="must-not"/>
+                <xs:enumeration value="avoid"/>
+                <xs:enumeration value="prefer"/>
+              </xs:restriction>
+            </xs:simpleType>
+          </xs:element>
+          <xs:element name="enforcement" type="xs:string" minOccurs="0"/>
+        </xs:sequence>
+      </xs:extension>
+    </xs:complexContent>
+  </xs:complexType>
+
+  <!-- Stack wisdom (technical learnings) -->
+  <xs:complexType name="stackWisdomType">
+    <xs:complexContent>
+      <xs:extension base="wisdomEntryType">
+        <xs:sequence>
+          <xs:element name="technology" type="xs:string" minOccurs="0"/>
+          <xs:element name="version_range" type="xs:string" minOccurs="0"/>
+          <xs:element name="workaround" type="xs:string" minOccurs="0"/>
+        </xs:sequence>
+      </xs:extension>
+    </xs:complexContent>
+  </xs:complexType>
+
+  <!-- Decree (authoritative directive) -->
+  <xs:complexType name="decreeType">
+    <xs:complexContent>
+      <xs:extension base="wisdomEntryType">
+        <xs:sequence>
+          <xs:element name="authority" type="xs:string" minOccurs="0"/>
+          <xs:element name="expiration" type="timestampType" minOccurs="0"/>
+          <xs:element name="scope" minOccurs="0">
+            <xs:simpleType>
+              <xs:restriction base="xs:string">
+                <xs:enumeration value="global"/>
+                <xs:enumeration value="project"/>
+                <xs:enumeration value="phase"/>
+                <xs:enumeration value="task"/>
+              </xs:restriction>
+            </xs:simpleType>
+          </xs:element>
+        </xs:sequence>
+      </xs:extension>
+    </xs:complexContent>
+  </xs:complexType>
+
+  <!-- Container types for each wisdom category -->
+  <xs:complexType name="philosophiesType">
+    <xs:sequence>
+      <xs:element name="philosophy" type="philosophyType" maxOccurs="unbounded"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <xs:complexType name="patternsType">
+    <xs:sequence>
+      <xs:element name="pattern" type="patternType" maxOccurs="unbounded"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <xs:complexType name="redirectsType">
+    <xs:sequence>
+      <xs:element name="redirect" type="redirectType" maxOccurs="unbounded"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <xs:complexType name="stackWisdomsType">
+    <xs:sequence>
+      <xs:element name="wisdom" type="stackWisdomType" maxOccurs="unbounded"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <xs:complexType name="decreesType">
+    <xs:sequence>
+      <xs:element name="decree" type="decreeType" maxOccurs="unbounded"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <!-- Metadata type -->
+  <xs:complexType name="metadataType">
+    <xs:sequence>
+      <xs:element name="version" type="versionType"/>
+      <xs:element name="created" type="timestampType"/>
+      <xs:element name="modified" type="timestampType"/>
+      <xs:element name="colony_id" type="xs:string"/>
+      <xs:element name="queen_signature" type="xs:string" minOccurs="0"/>
+      <xs:element name="checksum" type="xs:string" minOccurs="0"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <!-- ============================================================ -->
+  <!-- Root Element                                                 -->
+  <!-- ============================================================ -->
+
+  <xs:element name="queen-wisdom">
+    <xs:complexType>
+      <xs:sequence>
+        <xs:element name="metadata" type="metadataType"/>
+        <xs:element name="philosophies" type="philosophiesType"/>
+        <xs:element name="patterns" type="patternsType"/>
+        <xs:element name="redirects" type="redirectsType"/>
+        <xs:element name="stack-wisdom" type="stackWisdomsType"/>
+        <xs:element name="decrees" type="decreesType"/>
+      </xs:sequence>
+    </xs:complexType>
+  </xs:element>
+
+</xs:schema>

package/.aether/schemas/worker-priming.xsd

@@ -0,0 +1,276 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  Worker Priming XML Schema (XSD)
+
+  Purpose: Define modular configuration composition for worker initialization
+           using XInclude to compose queen-wisdom, active-trails, and stack-profiles.
+
+  Architecture: Declarative composition - workers are primed by including
+                multiple configuration sources into a unified document.
+
+  Version: 1.0.0
+  Namespace: http://aether.colony/schemas/worker-priming/1.0
+-->
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
+           xmlns:wp="http://aether.colony/schemas/worker-priming/1.0"
+           xmlns:xi="http://www.w3.org/2001/XInclude"
+           targetNamespace="http://aether.colony/schemas/worker-priming/1.0"
+           elementFormDefault="qualified"
+           attributeFormDefault="unqualified">
+
+  <!-- Import XInclude namespace for composition support -->
+  <xs:import namespace="http://www.w3.org/2001/XInclude"
+             schemaLocation="http://www.w3.org/2001/XInclude.xsd"/>
+
+  <!-- ============================================================ -->
+  <!-- Simple Types                                                 -->
+  <!-- ============================================================ -->
+
+  <!-- Worker ID: kebab-case identifier -->
+  <xs:simpleType name="workerIdType">
+    <xs:restriction base="xs:string">
+      <xs:pattern value="[a-z][a-z0-9-]*"/>
+      <xs:minLength value="3"/>
+      <xs:maxLength value="64"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- Caste enumeration (matches pheromone.xsd) -->
+  <xs:simpleType name="casteType">
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="builder"/>
+      <xs:enumeration value="watcher"/>
+      <xs:enumeration value="scout"/>
+      <xs:enumeration value="chaos"/>
+      <xs:enumeration value="oracle"/>
+      <xs:enumeration value="architect"/>
+      <xs:enumeration value="prime"/>
+      <xs:enumeration value="colonizer"/>
+      <xs:enumeration value="route_setter"/>
+      <xs:enumeration value="archaeologist"/>
+      <xs:enumeration value="ambassador"/>
+      <xs:enumeration value="auditor"/>
+      <xs:enumeration value="chronicler"/>
+      <xs:enumeration value="gatekeeper"/>
+      <xs:enumeration value="guardian"/>
+      <xs:enumeration value="includer"/>
+      <xs:enumeration value="keeper"/>
+      <xs:enumeration value="measurer"/>
+      <xs:enumeration value="probe"/>
+      <xs:enumeration value="sage"/>
+      <xs:enumeration value="tracker"/>
+      <xs:enumeration value="weaver"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- Priming mode: how the worker should be initialized -->
+  <xs:simpleType name="primingModeType">
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="full"/>
+      <xs:enumeration value="minimal"/>
+      <xs:enumeration value="inherit"/>
+      <xs:enumeration value="override"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- Priority for configuration sources -->
+  <xs:simpleType name="sourcePriorityType">
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="highest"/>
+      <xs:enumeration value="high"/>
+      <xs:enumeration value="normal"/>
+      <xs:enumeration value="low"/>
+      <xs:enumeration value="lowest"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- ISO 8601 timestamp -->
+  <xs:simpleType name="timestampType">
+    <xs:restriction base="xs:string">
+      <xs:pattern value="\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- Version string (semver format) -->
+  <xs:simpleType name="versionType">
+    <xs:restriction base="xs:string">
+      <xs:pattern value="\d+\.\d+\.\d+(-[a-zA-Z0-9]+)?"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- ============================================================ -->
+  <!-- Complex Types                                                -->
+  <!-- ============================================================ -->
+
+  <!-- Worker identity -->
+  <xs:complexType name="workerIdentityType">
+    <xs:sequence>
+      <xs:element name="name" type="xs:string"/>
+      <xs:element name="caste" type="wp:casteType"/>
+      <xs:element name="generation" type="xs:positiveInteger" minOccurs="0"/>
+      <xs:element name="parent-colony" type="xs:string" minOccurs="0"/>
+    </xs:sequence>
+    <xs:attribute name="id" type="wp:workerIdType" use="required"/>
+  </xs:complexType>
+
+  <!-- Configuration source with XInclude support -->
+  <xs:complexType name="configSourceType">
+    <xs:sequence>
+      <!-- XInclude directive for external content -->
+      <xs:element ref="xi:include" minOccurs="0" maxOccurs="1"/>
+      <!-- Inline content (alternative to XInclude) -->
+      <xs:element name="inline" type="xs:string" minOccurs="0" maxOccurs="1"/>
+      <!-- Source metadata -->
+      <xs:element name="source-info" type="wp:sourceInfoType" minOccurs="0"/>
+    </xs:sequence>
+    <xs:attribute name="name" type="xs:string" use="required"/>
+    <xs:attribute name="priority" type="wp:sourcePriorityType" use="optional" default="normal"/>
+    <xs:attribute name="required" type="xs:boolean" use="optional" default="true"/>
+  </xs:complexType>
+
+  <!-- Source metadata for traceability -->
+  <xs:complexType name="sourceInfoType">
+    <xs:sequence>
+      <xs:element name="origin" type="xs:string"/>
+      <xs:element name="version" type="wp:versionType" minOccurs="0"/>
+      <xs:element name="checksum" type="xs:string" minOccurs="0"/>
+      <xs:element name="loaded-at" type="wp:timestampType" minOccurs="0"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <!-- Queen wisdom section -->
+  <xs:complexType name="queenWisdomSectionType">
+    <xs:sequence>
+      <xs:element name="description" type="xs:string" minOccurs="0"/>
+      <xs:element name="wisdom-source" type="wp:configSourceType" minOccurs="0" maxOccurs="unbounded"/>
+    </xs:sequence>
+    <xs:attribute name="enabled" type="xs:boolean" use="optional" default="true"/>
+  </xs:complexType>
+
+  <!-- Active trails section (pheromones) -->
+  <xs:complexType name="activeTrailsSectionType">
+    <xs:sequence>
+      <xs:element name="description" type="xs:string" minOccurs="0"/>
+      <xs:element name="trail-source" type="wp:configSourceType" minOccurs="0" maxOccurs="unbounded"/>
+    </xs:sequence>
+    <xs:attribute name="enabled" type="xs:boolean" use="optional" default="true"/>
+    <xs:attribute name="inherit-from-parent" type="xs:boolean" use="optional" default="true"/>
+  </xs:complexType>
+
+  <!-- Stack profiles section -->
+  <xs:complexType name="stackProfilesSectionType">
+    <xs:sequence>
+      <xs:element name="description" type="xs:string" minOccurs="0"/>
+      <xs:element name="profile-source" type="wp:configSourceType" minOccurs="0" maxOccurs="unbounded"/>
+      <xs:element name="technology-filter" type="wp:technologyFilterType" minOccurs="0"/>
+    </xs:sequence>
+    <xs:attribute name="enabled" type="xs:boolean" use="optional" default="true"/>
+  </xs:complexType>
+
+  <!-- Technology filter for stack profiles -->
+  <xs:complexType name="technologyFilterType">
+    <xs:sequence>
+      <xs:element name="include" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
+      <xs:element name="exclude" type="xs:string" minOccurs="0" maxOccurs="unbounded"/>
+    </xs:sequence>
+    <xs:attribute name="match-mode" type="xs:string" use="optional" default="any"/>
+  </xs:complexType>
+
+  <!-- Override rules for configuration merging -->
+  <xs:complexType name="overrideRulesType">
+    <xs:sequence>
+      <xs:element name="rule" type="wp:overrideRuleType" minOccurs="0" maxOccurs="unbounded"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <!-- Individual override rule -->
+  <xs:complexType name="overrideRuleType">
+    <xs:sequence>
+      <xs:element name="target-path" type="xs:string"/>
+      <xs:element name="action" type="wp:overrideActionType"/>
+      <xs:element name="value" type="xs:string" minOccurs="0"/>
+    </xs:sequence>
+    <xs:attribute name="id" type="xs:string" use="required"/>
+    <xs:attribute name="priority" type="wp:sourcePriorityType" use="optional" default="normal"/>
+  </xs:complexType>
+
+  <!-- Override action enumeration -->
+  <xs:simpleType name="overrideActionType">
+    <xs:restriction base="xs:string">
+      <xs:enumeration value="replace"/>
+      <xs:enumeration value="merge"/>
+      <xs:enumeration value="append"/>
+      <xs:enumeration value="prepend"/>
+      <xs:enumeration value="remove"/>
+    </xs:restriction>
+  </xs:simpleType>
+
+  <!-- Priming metadata -->
+  <xs:complexType name="primingMetadataType">
+    <xs:sequence>
+      <xs:element name="version" type="wp:versionType"/>
+      <xs:element name="created" type="wp:timestampType"/>
+      <xs:element name="modified" type="wp:timestampType"/>
+      <xs:element name="colony-id" type="xs:string"/>
+      <xs:element name="template" type="xs:string" minOccurs="0"/>
+      <xs:element name="composition-checksum" type="xs:string" minOccurs="0"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <!-- Composition result (post-processing) -->
+  <xs:complexType name="compositionResultType">
+    <xs:sequence>
+      <xs:element name="resolved-at" type="wp:timestampType"/>
+      <xs:element name="sources-resolved" type="xs:nonNegativeInteger"/>
+      <xs:element name="sources-failed" type="xs:nonNegativeInteger"/>
+      <xs:element name="composition-size" type="xs:nonNegativeInteger"/>
+      <xs:element name="validation-status" type="xs:string"/>
+    </xs:sequence>
+  </xs:complexType>
+
+  <!-- ============================================================ -->
+  <!-- Root Element                                                 -->
+  <!-- ============================================================ -->
+
+  <xs:element name="worker-priming">
+    <xs:complexType>
+      <xs:sequence>
+        <!-- Metadata about this priming document -->
+        <xs:element name="metadata" type="wp:primingMetadataType"/>
+
+        <!-- Worker identity -->
+        <xs:element name="worker-identity" type="wp:workerIdentityType"/>
+
+        <!-- Priming mode configuration -->
+        <xs:element name="priming-config" minOccurs="0">
+          <xs:complexType>
+            <xs:sequence>
+              <xs:element name="mode" type="wp:primingModeType"/>
+              <xs:element name="inherit-from-parent" type="xs:boolean" minOccurs="0" default="true"/>
+              <xs:element name="apply-redirects" type="xs:boolean" minOccurs="0" default="true"/>
+              <xs:element name="load-pheromones" type="xs:boolean" minOccurs="0" default="true"/>
+            </xs:sequence>
+          </xs:complexType>
+        </xs:element>
+
+        <!--
+          Configuration Composition Sections
+          Each section can use XInclude to pull in external documents
+        -->
+        <xs:element name="queen-wisdom" type="wp:queenWisdomSectionType" minOccurs="0"/>
+        <xs:element name="active-trails" type="wp:activeTrailsSectionType" minOccurs="0"/>
+        <xs:element name="stack-profiles" type="wp:stackProfilesSectionType" minOccurs="0"/>
+
+        <!-- Override rules for merging -->
+        <xs:element name="override-rules" type="wp:overrideRulesType" minOccurs="0"/>
+
+        <!-- Composition result (populated after resolution) -->
+        <xs:element name="composition-result" type="wp:compositionResultType" minOccurs="0"/>
+      </xs:sequence>
+
+      <!-- Document version -->
+      <xs:attribute name="version" type="wp:versionType" use="required"/>
+    </xs:complexType>
+  </xs:element>
+
+</xs:schema>

package/.aether/templates/QUEEN.md.template

@@ -0,0 +1,79 @@
+# QUEEN.md — Colony Wisdom
+
+> Last evolved: {TIMESTAMP}
+> Colonies contributed: 0
+> Wisdom version: 1.0.0
+
+---
+
+## 📜 Philosophies
+
+Core beliefs that guide all colony work. These are validated through repeated successful application across multiple colonies.
+
+*No philosophies recorded yet. Philosophies are promoted from PHILOSOPHY pheromones after 5+ validations.*
+
+---
+
+## 🧭 Patterns
+
+Validated approaches that consistently work. These represent discovered best practices that have proven themselves in the field.
+
+*No patterns recorded yet. Patterns are promoted from PATTERN pheromones after 3+ validations.*
+
+---
+
+## ⚠️ Redirects
+
+Anti-patterns to avoid. These represent approaches that have caused problems and should be redirected away from.
+
+*No redirects recorded yet. Redirects are promoted from REDIRECT pheromones after 2+ triggers.*
+
+---
+
+## 🔧 Stack Wisdom
+
+Technology-specific insights and constraints detected through codebase analysis.
+
+*No stack wisdom recorded yet. Stack wisdom is auto-populated by `/ant:colonize`.*
+
+---
+
+## 🏛️ Decrees
+
+User-mandated rules that override other guidance. These represent explicit directives from the Queen.
+
+*No decrees recorded yet. Decrees are added via `/ant:decree "<rule>"`.*
+
+---
+
+## 📊 Evolution Log
+
+Track how wisdom has evolved over time.
+
+| Date | Colony | Change | Details |
+|------|--------|--------|---------|
+| {TIMESTAMP} | system | initialized | QUEEN.md created from template |
+
+---
+
+<!-- METADATA
+{
+  "version": "1.0.0",
+  "last_evolved": "{TIMESTAMP}",
+  "colonies_contributed": [],
+  "promotion_thresholds": {
+    "philosophy": 5,
+    "pattern": 3,
+    "redirect": 2,
+    "stack": 1,
+    "decree": 0
+  },
+  "stats": {
+    "total_philosophies": 0,
+    "total_patterns": 0,
+    "total_redirects": 0,
+    "total_stack_entries": 0,
+    "total_decrees": 0
+  }
+}
+-->