aether-colony 3.1.5 → 3.1.16

package/runtime/utils/atomic-write.sh

@@ -62,6 +62,11 @@ atomic_write() {
         return 1
     fi
 
+    # Create backup if target exists (do this BEFORE validation to avoid race condition)
+    if [ -f "$target_file" ]; then
+        create_backup "$target_file"
+    fi
+
     # Validate JSON if it's a JSON file
     if [[ "$target_file" == *.json ]]; then
         if ! python3 -c "import json; json.load(open('$temp_file'))" 2>/dev/null; then
@@ -71,11 +76,6 @@ atomic_write() {
         fi
     fi
 
-    # Create backup if target exists
-    if [ -f "$target_file" ]; then
-        create_backup "$target_file"
-    fi
-
     # Atomic rename (overwrites target if exists)
     if ! mv "$temp_file" "$target_file"; then
         echo "Failed to rename temp file to target: $target_file"

package/runtime/utils/chamber-utils.sh

@@ -15,9 +15,12 @@ set -euo pipefail
 LOCK_ACQUIRED=${LOCK_ACQUIRED:-false}
 CURRENT_LOCK=${CURRENT_LOCK:-""}
 
-# Get script directory for sourcing
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-AETHER_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd 2>/dev/null || echo "$SCRIPT_DIR/../..")"
+# Get script directory for sourcing (preserve parent SCRIPT_DIR if set)
+__chamber_utils_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+AETHER_ROOT="$(cd "$__chamber_utils_dir/../.." && pwd 2>/dev/null || echo "$__chamber_utils_dir/../..")"
+
+# Use parent SCRIPT_DIR if available, otherwise use local
+SCRIPT_DIR="${SCRIPT_DIR:-$__chamber_utils_dir}"
 
 # Source atomic-write for safe file operations
 [[ -f "$SCRIPT_DIR/atomic-write.sh" ]] && source "$SCRIPT_DIR/atomic-write.sh"

package/runtime/utils/error-handler.sh

@@ -0,0 +1,200 @@
+#!/bin/bash
+# Aether Colony Error Handler Module
+# Structured JSON error handling for bash utilities
+#
+# Usage: source "$SCRIPT_DIR/utils/error-handler.sh"
+#
+# Provides consistent error format between Node.js CLI and bash utilities
+
+# --- Error Code Constants (matching Node.js error codes) ---
+E_UNKNOWN="E_UNKNOWN"
+E_HUB_NOT_FOUND="E_HUB_NOT_FOUND"
+E_REPO_NOT_INITIALIZED="E_REPO_NOT_INITIALIZED"
+E_FILE_NOT_FOUND="E_FILE_NOT_FOUND"
+E_JSON_INVALID="E_JSON_INVALID"
+E_LOCK_FAILED="E_LOCK_FAILED"
+E_GIT_ERROR="E_GIT_ERROR"
+E_VALIDATION_FAILED="E_VALIDATION_FAILED"
+E_FEATURE_UNAVAILABLE="E_FEATURE_UNAVAILABLE"
+E_BASH_ERROR="E_BASH_ERROR"
+
+# --- Recovery Suggestion Functions (internal, prefixed with _) ---
+_recovery_hub_not_found() { echo '"Run: aether install"'; }
+_recovery_repo_not_init() { echo '"Run /ant:init in this repo first"'; }
+_recovery_file_not_found() { echo '"Check file path and permissions"'; }
+_recovery_json_invalid() { echo '"Validate JSON syntax"'; }
+_recovery_lock_failed() { echo '"Wait for other operations to complete"'; }
+_recovery_git_error() { echo '"Check git status and resolve conflicts"'; }
+_recovery_default() { echo 'null'; }
+
+# Get recovery suggestion based on error code
+_get_recovery() {
+  local code="$1"
+  case "$code" in
+    "$E_HUB_NOT_FOUND") _recovery_hub_not_found ;;
+    "$E_REPO_NOT_INITIALIZED") _recovery_repo_not_init ;;
+    "$E_FILE_NOT_FOUND") _recovery_file_not_found ;;
+    "$E_JSON_INVALID") _recovery_json_invalid ;;
+    "$E_LOCK_FAILED") _recovery_lock_failed ;;
+    "$E_GIT_ERROR") _recovery_git_error ;;
+    *) _recovery_default ;;
+  esac
+}
+
+# --- Enhanced json_err function ---
+# Signature: json_err [code] [message] [details] [recovery]
+# All parameters optional with sensible defaults
+json_err() {
+  local code="${1:-$E_UNKNOWN}"
+  local message="${2:-An unknown error occurred}"
+  local details="${3:-null}"
+  local recovery="${4:-}"
+  local timestamp
+  timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  # Get recovery suggestion if not provided
+  if [[ -z "$recovery" ]]; then
+    recovery=$(_get_recovery "$code")
+  else
+    # Escape and quote the recovery string
+    recovery=$(echo "$recovery" | sed 's/"/\\"/g' | tr '\n' ' ')
+    recovery="\"$recovery\""
+  fi
+
+  # Escape message for JSON
+  local escaped_message
+  escaped_message=$(echo "$message" | sed 's/"/\\"/g' | tr '\n' ' ')
+
+  # Build details JSON
+  local details_json
+  if [[ "$details" == "null" || -z "$details" ]]; then
+    details_json="null"
+  else
+    details_json="$details"
+  fi
+
+  # Output structured JSON to stderr
+  printf '{"ok":false,"error":{"code":"%s","message":"%s","details":%s,"recovery":%s,"timestamp":"%s"}}\n' \
+    "$code" "$escaped_message" "$details_json" "$recovery" "$timestamp" >&2
+
+  # Log to activity.log (best effort)
+  if [[ -n "${DATA_DIR:-}" ]]; then
+    echo "[$timestamp] ERROR $code: $escaped_message" >> "$DATA_DIR/activity.log" 2>/dev/null || true
+  fi
+
+  exit 1
+}
+
+# --- json_warn function for non-fatal warnings ---
+# Signature: json_warn [code] [message]
+json_warn() {
+  local code="${1:-W_UNKNOWN}"
+  local message="${2:-Warning}"
+  local timestamp
+  timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  # Escape message for JSON
+  local escaped_message
+  escaped_message=$(echo "$message" | sed 's/"/\\"/g' | tr '\n' ' ')
+
+  # Output warning JSON to stdout (not stderr - this is non-fatal)
+  printf '{"ok":true,"warning":{"code":"%s","message":"%s","timestamp":"%s"}}\n' \
+    "$code" "$escaped_message" "$timestamp"
+
+  # Log to activity.log (best effort)
+  if [[ -n "${DATA_DIR:-}" ]]; then
+    echo "[$timestamp] WARN $code: $escaped_message" >> "$DATA_DIR/activity.log" 2>/dev/null || true
+  fi
+}
+
+# --- error_handler function for trap ERR ---
+# Captures: line number, command, exit code
+# Usage: trap 'error_handler ${LINENO} "$BASH_COMMAND" $?' ERR
+error_handler() {
+  local line_num="${1:-unknown}"
+  local command="${2:-unknown}"
+  local exit_code="${3:-1}"
+  local timestamp
+  timestamp=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+  # Escape command for JSON
+  local escaped_command
+  escaped_command=$(echo "$command" | sed 's/"/\\"/g' | tr '\n' ' ')
+
+  # Build details JSON
+  local details
+  details="{\"line\":$line_num,\"command\":\"$escaped_command\",\"exit_code\":$exit_code}"
+
+  # Output structured JSON to stderr
+  printf '{"ok":false,"error":{"code":"%s","message":"Bash command failed","details":%s,"recovery":%s,"timestamp":"%s"}}\n' \
+    "$E_BASH_ERROR" "$details" "$(_recovery_default)" "$timestamp" >&2
+
+  # Log to activity.log (best effort)
+  if [[ -n "${DATA_DIR:-}" ]]; then
+    echo "[$timestamp] ERROR $E_BASH_ERROR: Command failed at line $line_num (exit $exit_code)" >> "$DATA_DIR/activity.log" 2>/dev/null || true
+  fi
+
+  exit 1
+}
+
+# --- Feature flag functions for graceful degradation ---
+# Using simple variables for bash 3.2+ compatibility (no associative arrays)
+
+# Track disabled features as colon-separated list: "feature1:reason1|feature2:reason2"
+_FEATURES_DISABLED=""
+
+# Enable a feature (remove from disabled list if present)
+feature_enable() {
+  local name="$1"
+  # Remove from disabled list if present
+  _FEATURES_DISABLED=$(echo "$_FEATURES_DISABLED" | sed "s/:$name:[^|]*//g" | sed 's/^|//;s/|$//')
+}
+
+# Disable a feature with reason
+feature_disable() {
+  local name="$1"
+  local reason="${2:-disabled}"
+  # Remove existing entry if present, then add new
+  _FEATURES_DISABLED=$(echo "$_FEATURES_DISABLED" | sed "s/:$name:[^|]*//g")
+  if [[ -z "$_FEATURES_DISABLED" ]]; then
+    _FEATURES_DISABLED=":$name:$reason"
+  else
+    _FEATURES_DISABLED="${_FEATURES_DISABLED}|:$name:$reason"
+  fi
+}
+
+# Check if feature is enabled (returns 0 if enabled, 1 if disabled)
+feature_enabled() {
+  local name="$1"
+  if echo "$_FEATURES_DISABLED" | grep -q ":$name:"; then
+    return 1
+  fi
+  return 0
+}
+
+# Get reason for feature being disabled
+_feature_reason() {
+  local name="$1"
+  echo "$_FEATURES_DISABLED" | grep -o ":$name:[^|]*" | sed "s/:$name://" || echo "unknown"
+}
+
+# Log degradation warning
+feature_log_degradation() {
+  local name="$1"
+  local reason="${2:-}"
+  if [[ -z "$reason" ]]; then
+    reason=$(_feature_reason "$name")
+  fi
+  json_warn "W_DEGRADED" "Feature '$name' is disabled: $reason"
+}
+
+# --- Export all functions and variables ---
+export -f json_err json_warn error_handler
+export -f feature_enable feature_disable feature_enabled feature_log_degradation
+export -f _get_recovery _recovery_hub_not_found _recovery_repo_not_init
+export -f _recovery_file_not_found _recovery_json_invalid _recovery_lock_failed
+export -f _recovery_git_error _recovery_default _feature_reason
+export E_UNKNOWN E_HUB_NOT_FOUND E_REPO_NOT_INITIALIZED E_FILE_NOT_FOUND
+export E_JSON_INVALID E_LOCK_FAILED E_GIT_ERROR E_VALIDATION_FAILED
+export E_FEATURE_UNAVAILABLE E_BASH_ERROR
+export _FEATURES_DISABLED

package/runtime/utils/queen-to-md.xsl

@@ -0,0 +1,395 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  XSLT Stylesheet: queen-wisdom to Markdown
+
+  Purpose: Transform queen-wisdom.xml into human-readable QUEEN.md format
+           for display and documentation purposes.
+
+  Usage: xsltproc queen-to-md.xsl queen-wisdom.xml > QUEEN.md
+
+  Version: 1.0.0
+  Namespace: http://aether.colony/schemas/queen-wisdom/1.0
+-->
+<xsl:stylesheet version="1.0"
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
+
+  <xsl:output method="text" encoding="UTF-8" indent="no"/>
+
+  <!-- ============================================================ -->
+  <!-- Main Template                                                -->
+  <!-- ============================================================ -->
+
+  <xsl:template match="/queen-wisdom">
+    <xsl:text># QUEEN.md — Colony Wisdom&#10;&#10;</xsl:text>
+
+    <!-- Metadata Header -->
+    <xsl:text>&gt; Last evolved: </xsl:text>
+    <xsl:value-of select="metadata/modified"/>
+    <xsl:text>&#10;</xsl:text>
+
+    <xsl:text>&gt; Colonies contributed: </xsl:text>
+    <xsl:value-of select="count(//evidence/colony-ref/@id)"/>
+    <xsl:text>&#10;</xsl:text>
+
+    <xsl:text>&gt; Wisdom version: </xsl:text>
+    <xsl:value-of select="metadata/version"/>
+    <xsl:text>&#10;&#10;</xsl:text>
+
+    <xsl:text>---&#10;&#10;</xsl:text>
+
+    <!-- Philosophies Section -->
+    <xsl:apply-templates select="philosophies"/>
+
+    <!-- Patterns Section -->
+    <xsl:apply-templates select="patterns"/>
+
+    <!-- Redirects Section -->
+    <xsl:apply-templates select="redirects"/>
+
+    <!-- Stack Wisdom Section -->
+    <xsl:apply-templates select="stack-wisdom"/>
+
+    <!-- Decrees Section -->
+    <xsl:apply-templates select="decrees"/>
+
+    <!-- Evolution Log Section -->
+    <xsl:apply-templates select="evolution-log"/>
+
+    <xsl:text>---&#10;&#10;</xsl:text>
+
+    <!-- JSON Metadata Block (for backward compatibility) -->
+    <xsl:call-template name="metadata-block"/>
+  </xsl:template>
+
+  <!-- ============================================================ -->
+  <!-- Section Templates                                            -->
+  <!-- ============================================================ -->
+
+  <xsl:template match="philosophies">
+    <xsl:text>## 📜 Philosophies&#10;&#10;</xsl:text>
+    <xsl:text>Core beliefs that guide all colony work. These are validated through repeated successful application across multiple colonies.&#10;&#10;</xsl:text>
+
+    <xsl:for-each select="philosophy">
+      <xsl:text>- **</xsl:text>
+      <xsl:value-of select="@id"/>
+      <xsl:text>** (</xsl:text>
+      <xsl:value-of select="@created_at"/>
+      <xsl:text>): </xsl:text>
+      <xsl:value-of select="content"/>
+      <xsl:text>&#10;</xsl:text>
+
+      <!-- Principles subsection if present -->
+      <xsl:if test="principles/principle">
+        <xsl:text>  - Principles:&#10;</xsl:text>
+        <xsl:for-each select="principles/principle">
+          <xsl:text>    - </xsl:text>
+          <xsl:value-of select="."/>
+          <xsl:text>&#10;</xsl:text>
+        </xsl:for-each>
+      </xsl:if>
+
+      <!-- Evidence subsection -->
+      <xsl:if test="evidence/colony-ref">
+        <xsl:text>  - Validated by: </xsl:text>
+        <xsl:for-each select="evidence/colony-ref">
+          <xsl:value-of select="@id"/>
+          <xsl:if test="position() != last()">, </xsl:if>
+        </xsl:for-each>
+        <xsl:text>&#10;</xsl:text>
+      </xsl:if>
+    </xsl:for-each>
+
+    <xsl:text>&#10;</xsl:text>
+  </xsl:template>
+
+  <xsl:template match="patterns">
+    <xsl:text>## 🧭 Patterns&#10;&#10;</xsl:text>
+    <xsl:text>Validated approaches that consistently work. These represent discovered best practices that have proven themselves in the field.&#10;&#10;</xsl:text>
+
+    <xsl:for-each select="pattern">
+      <xsl:text>- **</xsl:text>
+      <xsl:value-of select="@id"/>
+      <xsl:text>**</xsl:text>
+
+      <xsl:if test="pattern_type">
+        <xsl:text> [</xsl:text>
+        <xsl:value-of select="pattern_type"/>
+        <xsl:text>]</xsl:text>
+      </xsl:if>
+
+      <xsl:text> (</xsl:text>
+      <xsl:value-of select="@created_at"/>
+      <xsl:text>): </xsl:text>
+      <xsl:value-of select="content"/>
+      <xsl:text>&#10;</xsl:text>
+
+      <!-- Detection criteria if present -->
+      <xsl:if test="detection_criteria">
+        <xsl:text>  - When to apply: </xsl:text>
+        <xsl:value-of select="detection_criteria"/>
+        <xsl:text>&#10;</xsl:text>
+      </xsl:if>
+
+      <!-- Examples if present -->
+      <xsl:if test="examples/example">
+        <xsl:text>  - Examples:&#10;</xsl:text>
+        <xsl:for-each select="examples/example">
+          <xsl:text>    - Scenario: </xsl:text>
+          <xsl:value-of select="scenario"/>
+          <xsl:text> → Application: </xsl:text>
+          <xsl:value-of select="application"/>
+          <xsl:if test="outcome">
+            <xsl:text> (Outcome: </xsl:text>
+            <xsl:value-of select="outcome"/>
+            <xsl:text>)</xsl:text>
+          </xsl:if>
+          <xsl:text>&#10;</xsl:text>
+        </xsl:for-each>
+      </xsl:if>
+    </xsl:for-each>
+
+    <xsl:text>&#10;</xsl:text>
+  </xsl:template>
+
+  <xsl:template match="redirects">
+    <xsl:text>## ⚠️ Redirects&#10;&#10;</xsl:text>
+    <xsl:text>Anti-patterns to avoid. These represent approaches that have caused problems and should be redirected away from.&#10;&#10;</xsl:text>
+
+    <xsl:for-each select="redirect">
+      <xsl:text>- **</xsl:text>
+      <xsl:value-of select="@id"/>
+      <xsl:text>**</xsl:text>
+
+      <xsl:if test="@confidence">
+        <xsl:text> [strength: </xsl:text>
+        <xsl:value-of select="@confidence"/>
+        <xsl:text>]</xsl:text>
+      </xsl:if>
+
+      <xsl:text> (</xsl:text>
+      <xsl:value-of select="@created_at"/>
+      <xsl:text>): </xsl:text>
+      <xsl:value-of select="content"/>
+      <xsl:text>&#10;</xsl:text>
+
+      <!-- Constraint type if present -->
+      <xsl:if test="constraint_type">
+        <xsl:text>  - Constraint: </xsl:text>
+        <xsl:value-of select="constraint_type"/>
+        <xsl:text>&#10;</xsl:text>
+      </xsl:if>
+
+      <!-- Context if present -->
+      <xsl:if test="context">
+        <xsl:text>  - Context: </xsl:text>
+        <xsl:value-of select="context"/>
+        <xsl:text>&#10;</xsl:text>
+      </xsl:if>
+    </xsl:for-each>
+
+    <xsl:text>&#10;</xsl:text>
+  </xsl:template>
+
+  <xsl:template match="stack-wisdom">
+    <xsl:text>## 🔧 Stack Wisdom&#10;&#10;</xsl:text>
+    <xsl:text>Technology-specific insights and constraints detected through codebase analysis.&#10;&#10;</xsl:text>
+
+    <xsl:for-each select="wisdom">
+      <xsl:text>- **</xsl:text>
+      <xsl:value-of select="@id"/>
+      <xsl:text>**</xsl:text>
+
+      <xsl:if test="technology">
+        <xsl:text> [</xsl:text>
+        <xsl:value-of select="technology"/>
+        <xsl:text>]</xsl:text>
+      </xsl:if>
+
+      <xsl:text> (</xsl:text>
+      <xsl:value-of select="@created_at"/>
+      <xsl:text>): </xsl:text>
+      <xsl:value-of select="content"/>
+      <xsl:text>&#10;</xsl:text>
+
+      <!-- Version range if present -->
+      <xsl:if test="version_range">
+        <xsl:text>  - Applies to: </xsl:text>
+        <xsl:value-of select="version_range"/>
+        <xsl:text>&#10;</xsl:text>
+      </xsl:if>
+
+      <!-- Workaround if present -->
+      <xsl:if test="workaround">
+        <xsl:text>  - Workaround: </xsl:text>
+        <xsl:value-of select="workaround"/>
+        <xsl:text>&#10;</xsl:text>
+      </xsl:if>
+    </xsl:for-each>
+
+    <xsl:text>&#10;</xsl:text>
+  </xsl:template>
+
+  <xsl:template match="decrees">
+    <xsl:text>## 🏛️ Decrees&#10;&#10;</xsl:text>
+    <xsl:text>User-mandated rules that override other guidance. These represent explicit directives from the Queen.&#10;&#10;</xsl:text>
+
+    <xsl:for-each select="decree">
+      <xsl:text>- **</xsl:text>
+      <xsl:value-of select="@id"/>
+      <xsl:text>**</xsl:text>
+
+      <xsl:if test="scope">
+        <xsl:text> [</xsl:text>
+        <xsl:value-of select="scope"/>
+        <xsl:text>]</xsl:text>
+      </xsl:if>
+
+      <xsl:text> (</xsl:text>
+      <xsl:value-of select="@created_at"/>
+      <xsl:text>): </xsl:text>
+      <xsl:value-of select="content"/>
+      <xsl:text>&#10;</xsl:text>
+
+      <!-- Authority if present -->
+      <xsl:if test="authority">
+        <xsl:text>  - Authority: </xsl:text>
+        <xsl:value-of select="authority"/>
+        <xsl:text>&#10;</xsl:text>
+      </xsl:if>
+
+      <!-- Expiration if present -->
+      <xsl:if test="expiration">
+        <xsl:text>  - Expires: </xsl:text>
+        <xsl:value-of select="expiration"/>
+        <xsl:text>&#10;</xsl:text>
+      </xsl:if>
+    </xsl:for-each>
+
+    <xsl:text>&#10;</xsl:text>
+  </xsl:template>
+
+  <xsl:template match="evolution-log">
+    <xsl:text>## 📊 Evolution Log&#10;&#10;</xsl:text>
+    <xsl:text>Track how wisdom has evolved over time.&#10;&#10;</xsl:text>
+
+    <xsl:text>| Date | Colony | Change | Details |&#10;</xsl:text>
+    <xsl:text>|------|--------|--------|---------|&#10;</xsl:text>
+
+    <xsl:for-each select="entry">
+      <xsl:text>| </xsl:text>
+      <xsl:value-of select="@timestamp"/>
+      <xsl:text> | </xsl:text>
+      <xsl:value-of select="@colony"/>
+      <xsl:text> | </xsl:text>
+      <xsl:value-of select="@action"/>
+      <xsl:text> | </xsl:text>
+
+      <!-- Build details string -->
+      <xsl:choose>
+        <xsl:when test="@type and @from">
+          <xsl:text>Promoted </xsl:text>
+          <xsl:value-of select="@type"/>
+          <xsl:text> from </xsl:text>
+          <xsl:value-of select="@from"/>
+        </xsl:when>
+        <xsl:when test="@type">
+          <xsl:text>Added: </xsl:text>
+          <xsl:value-of select="@type"/>
+        </xsl:when>
+        <xsl:otherwise>
+          <xsl:text>Entry recorded</xsl:text>
+        </xsl:otherwise>
+      </xsl:choose>
+
+      <xsl:if test="note">
+        <xsl:text> - </xsl:text>
+        <xsl:value-of select="note"/>
+      </xsl:if>
+
+      <xsl:text> |&#10;</xsl:text>
+    </xsl:for-each>
+
+    <xsl:text>&#10;</xsl:text>
+  </xsl:template>
+
+  <!-- ============================================================ -->
+  <!-- Metadata Block Template                                      -->
+  <!-- ============================================================ -->
+
+  <xsl:template name="metadata-block">
+    <xsl:text>&lt;!-- METADATA&#10;</xsl:text>
+    <xsl:text>{&#10;</xsl:text>
+
+    <xsl:text>  "version": "</xsl:text>
+    <xsl:value-of select="metadata/version"/>
+    <xsl:text>",&#10;</xsl:text>
+
+    <xsl:text>  "last_evolved": "</xsl:text>
+    <xsl:value-of select="metadata/modified"/>
+    <xsl:text>",&#10;</xsl:text>
+
+    <!-- Count colonies contributed -->
+    <xsl:text>  "colonies_contributed": [</xsl:text>
+    <xsl:for-each select="//evidence/colony-ref[not(@id=preceding::colony-ref/@id)]">
+      <xsl:text>"</xsl:text>
+      <xsl:value-of select="@id"/>
+      <xsl:text>"</xsl:text>
+      <xsl:if test="position() != last()">, </xsl:if>
+    </xsl:for-each>
+    <xsl:text>],&#10;</xsl:text>
+
+    <!-- Promotion thresholds -->
+    <xsl:text>  "promotion_thresholds": {&#10;</xsl:text>
+    <xsl:text>    "philosophy": 5,&#10;</xsl:text>
+    <xsl:text>    "pattern": 3,&#10;</xsl:text>
+    <xsl:text>    "redirect": 2,&#10;</xsl:text>
+    <xsl:text>    "stack": 1,&#10;</xsl:text>
+    <xsl:text>    "decree": 0&#10;</xsl:text>
+    <xsl:text>  },&#10;</xsl:text>
+
+    <!-- Stats -->
+    <xsl:text>  "stats": {&#10;</xsl:text>
+    <xsl:text>    "total_philosophies": </xsl:text>
+    <xsl:value-of select="count(//philosophy)"/>
+    <xsl:text>,&#10;</xsl:text>
+
+    <xsl:text>    "total_patterns": </xsl:text>
+    <xsl:value-of select="count(//pattern)"/>
+    <xsl:text>,&#10;</xsl:text>
+
+    <xsl:text>    "total_redirects": </xsl:text>
+    <xsl:value-of select="count(//redirect)"/>
+    <xsl:text>,&#10;</xsl:text>
+
+    <xsl:text>    "total_stack_entries": </xsl:text>
+    <xsl:value-of select="count(//stack-wisdom/wisdom)"/>
+    <xsl:text>,&#10;</xsl:text>
+
+    <xsl:text>    "total_decrees": </xsl:text>
+    <xsl:value-of select="count(//decree)"/>
+    <xsl:text>&#10;</xsl:text>
+
+    <xsl:text>  }&#10;</xsl:text>
+    <xsl:text>}&#10;</xsl:text>
+    <xsl:text>--&gt;&#10;</xsl:text>
+  </xsl:template>
+
+  <!-- ============================================================ -->
+  <!-- Utility Templates                                            -->
+  <!-- ============================================================ -->
+
+  <!-- Strip trailing/leading whitespace -->
+  <xsl:template name="trim">
+    <xsl:param name="string"/>
+    <xsl:value-of select="normalize-space($string)"/>
+  </xsl:template>
+
+  <!-- Escape markdown special characters in content -->
+  <xsl:template name="escape-markdown">
+    <xsl:param name="text"/>
+    <!-- Note: In XSLT 1.0, complex string replacement requires recursive templates -->
+    <!-- For simplicity, we assume content doesn't contain problematic markdown -->
+    <xsl:value-of select="$text"/>
+  </xsl:template>
+
+</xsl:stylesheet>