aether-colony 5.3.2 → 5.3.3

package/.aether/aether-utils.sh

@@ -48,6 +48,21 @@ CURRENT_LOCK=${CURRENT_LOCK:-""}
 [[ -f "$SCRIPT_DIR/utils/council.sh" ]] && source "$SCRIPT_DIR/utils/council.sh"
 [[ -f "$SCRIPT_DIR/utils/clash-detect.sh" ]] && source "$SCRIPT_DIR/utils/clash-detect.sh"
 [[ -f "$SCRIPT_DIR/utils/worktree.sh" ]] && source "$SCRIPT_DIR/utils/worktree.sh"
+[[ -f "$SCRIPT_DIR/utils/event-bus.sh" ]] && source "$SCRIPT_DIR/utils/event-bus.sh"
+[[ -f "$SCRIPT_DIR/utils/trust-scoring.sh" ]] && source "$SCRIPT_DIR/utils/trust-scoring.sh"
+[[ -f "$SCRIPT_DIR/utils/instinct-store.sh" ]] && source "$SCRIPT_DIR/utils/instinct-store.sh"
+[[ -f "$SCRIPT_DIR/utils/graph.sh" ]] && source "$SCRIPT_DIR/utils/graph.sh"
+[[ -f "$SCRIPT_DIR/utils/curation-ants/sentinel.sh" ]] && source "$SCRIPT_DIR/utils/curation-ants/sentinel.sh"
+[[ -f "$SCRIPT_DIR/utils/curation-ants/janitor.sh" ]] && source "$SCRIPT_DIR/utils/curation-ants/janitor.sh"
+[[ -f "$SCRIPT_DIR/utils/curation-ants/archivist.sh" ]] && source "$SCRIPT_DIR/utils/curation-ants/archivist.sh"
+[[ -f "$SCRIPT_DIR/utils/curation-ants/scribe.sh" ]] && source "$SCRIPT_DIR/utils/curation-ants/scribe.sh"
+[[ -f "$SCRIPT_DIR/utils/curation-ants/nurse.sh" ]] && source "$SCRIPT_DIR/utils/curation-ants/nurse.sh"
+[[ -f "$SCRIPT_DIR/utils/curation-ants/herald.sh" ]] && source "$SCRIPT_DIR/utils/curation-ants/herald.sh"
+[[ -f "$SCRIPT_DIR/utils/curation-ants/librarian.sh" ]] && source "$SCRIPT_DIR/utils/curation-ants/librarian.sh"
+[[ -f "$SCRIPT_DIR/utils/curation-ants/critic.sh" ]] && source "$SCRIPT_DIR/utils/curation-ants/critic.sh"
+[[ -f "$SCRIPT_DIR/utils/curation-ants/orchestrator.sh" ]] && source "$SCRIPT_DIR/utils/curation-ants/orchestrator.sh"
+[[ -f "$SCRIPT_DIR/utils/consolidation-seal.sh" ]] && source "$SCRIPT_DIR/utils/consolidation-seal.sh"
+[[ -f "$SCRIPT_DIR/utils/consolidation.sh" ]] && source "$SCRIPT_DIR/utils/consolidation.sh"
 
 # Fallback error constants if error-handler.sh wasn't sourced
 # This prevents "unbound variable" errors in older installations
@@ -1260,13 +1275,16 @@ case "$cmd" in
       {"name": "pheromone-export", "description": "Export pheromone data to JSON"},
       {"name": "pheromone-export-xml", "description": "Export pheromone data to XML"},
       {"name": "pheromone-import-xml", "description": "Import pheromone data from XML"},
-      {"name": "pheromone-validate-xml", "description": "Validate pheromone XML against schema"}
+      {"name": "pheromone-validate-xml", "description": "Validate pheromone XML against schema"},
+      {"name": "pheromone-snapshot-inject", "description": "Copy active pheromone signals into a new worktree branch"},
+      {"name": "pheromone-export-branch", "description": "Export branch-specific pheromone signals for merge"},
+      {"name": "pheromone-merge-back", "description": "Merge eligible branch pheromone signals back to main"}
     ],
     "Utilities": [
       {"name": "generate-ant-name", "description": "Generate a unique ant name with caste prefix"},
       {"name": "activity-log", "description": "Append an entry to the activity log"},
       {"name": "activity-log-init", "description": "Initialize the activity log file"},
-      {"name": "activity-log-read", "description": "Read recent activity log entries"},
+      {"name": "activity-log-read", "description": "Read recent activity log entries; --no-errors excludes ERROR/WARN lines"},
       {"name": "generate-commit-message", "description": "Generate a commit message (types: milestone, pause, fix, contextual, seal)"},
       {"name": "version-check", "description": "Check if Aether version meets requirement"},
       {"name": "registry-add", "description": "Register a repo with Aether (supports --tags, --goal, --active)"},
@@ -1295,7 +1313,9 @@ case "$cmd" in
       {"name": "suggest-quick-dismiss", "description": "Dismiss all suggestions without approving"}
     ],
     "Maintenance": [
-      {"name": "data-clean", "description": "Scan and remove test/synthetic artifacts from colony data files"}
+      {"name": "data-clean", "description": "Scan and remove test/synthetic artifacts from colony data files"},
+      {"name": "backup-prune-global", "description": "Prune .aether/data/backups/ to 50-file global cap (newest kept)"},
+      {"name": "temp-clean", "description": "Remove files from .aether/temp/ older than 7 days"}
     ],
     "Autopilot": [
       {"name": "autopilot-init", "description": "Initialize autopilot run state (run-state.json)"},
@@ -1793,6 +1813,12 @@ HELP_EOF
     json_ok "{\"archived\":$archived_flag}"
     ;;
   activity-log-read)
+    # Parse optional --no-errors flag before positional caste_filter
+    _alr_no_errors=false
+    if [[ "${1:-}" == "--no-errors" ]]; then
+      _alr_no_errors=true
+      shift
+    fi
     caste_filter="${1:-}"
 
     # Graceful degradation: check if activity logging is enabled
@@ -1808,6 +1834,12 @@ HELP_EOF
     else
       content=$(cat "$log_file")
     fi
+
+    # Filter out ERROR/WARN lines if --no-errors flag was set
+    if [[ "$_alr_no_errors" == "true" ]]; then
+      content=$(echo "$content" | grep -vE 'ERROR|WARN' || true)
+    fi
+
     json_ok "$(echo "$content" | jq -Rs '.')"
     ;;
   learning-promote) _learning_promote "$@" ;;
@@ -3567,12 +3599,14 @@ Files: ${files_changed} files changed"
 
   memory-capture)
     # Capture learning/failure events with deterministic memory actions.
-    # Usage: memory-capture <event_type> <content> [wisdom_type] [source]
+    # Usage: memory-capture <event_type> <content> [wisdom_type] [source] [source_type] [evidence_type]
     # event_type: learning|failure|redirect|feedback|success|resolution
     mc_event="${1:-}"
     mc_content="${2:-}"
     mc_wisdom_type="${3:-}"
     mc_source="${4:-system:memory-capture}"
+    mc_source_type="${5:-observation}"
+    mc_evidence_type="${6:-anecdotal}"
 
     [[ -z "$mc_event" ]] && json_err "$E_VALIDATION_FAILED" "Usage: memory-capture <event_type> <content> [wisdom_type] [source]" '{"missing":"event_type"}'
     [[ -z "$mc_content" ]] && json_err "$E_VALIDATION_FAILED" "Usage: memory-capture <event_type> <content> [wisdom_type] [source]" '{"missing":"content"}'
@@ -3595,7 +3629,7 @@ Files: ${files_changed} files changed"
     [[ -z "$colony_name" ]] && colony_name="unknown"
 
     # SUPPRESS:OK -- read-default: returns fallback on failure
-    observe_result=$(bash "$0" learning-observe "$mc_content" "$mc_wisdom_type" "$colony_name" 2>/dev/null || echo '{}')
+    observe_result=$(bash "$0" learning-observe "$mc_content" "$mc_wisdom_type" "$colony_name" "$mc_source_type" "$mc_evidence_type" 2>/dev/null || echo '{}')
     if ! echo "$observe_result" | jq -e '.ok == true' >/dev/null 2>&1; then  # SUPPRESS:OK -- validation: testing JSON field
       # SUPPRESS:OK -- read-default: query may return empty
       obs_msg=$(echo "$observe_result" | jq -r '.error.message // "learning_observe_failed"' 2>/dev/null || echo "learning_observe_failed")
@@ -3907,6 +3941,9 @@ Files: ${files_changed} files changed"
   pheromone-count) _pheromone_count "$@" ;;
   pheromone-display) _pheromone_display "$@" ;;
   pheromone-read) _pheromone_read "$@" ;;
+  pheromone-snapshot-inject) _pheromone_snapshot_inject "$@" ;;
+  pheromone-export-branch) _pheromone_export_branch "$@" ;;
+  pheromone-merge-back) _pheromone_merge_back "$@" ;;
 
   instinct-read) _instinct_read "$@" ;;
   instinct-create) _instinct_create "$@" ;;
@@ -5174,6 +5211,50 @@ DRYRUN_EOF
       '{ok:true, removed:{pheromones:$phero, queen:$queen, observations:$obs, midden:$midden, spawn_tree:$spawn, constraints:$constraints}, total:$total}')"
     ;;
 
+  # --- Housekeeping Subcommands ---
+
+  backup-prune-global)
+    # Prune .aether/data/backups/ to a global cap of 50 files (newest kept).
+    # Per-filename rotation (MAX_BACKUPS=3) already runs in atomic-write.sh.
+    # This is the global sweep for unique-filename growth.
+    _bpg_cap=50
+    _bpg_dir="${BACKUP_DIR:-$DATA_DIR/backups}"
+
+    if [[ ! -d "$_bpg_dir" ]]; then
+      json_ok '{"pruned":0,"kept":0,"dir_exists":false}'; exit 0
+    fi
+
+    _bpg_total=$(find "$_bpg_dir" -maxdepth 1 -type f 2>/dev/null | wc -l | tr -d ' ')
+
+    if [[ "$_bpg_total" -le "$_bpg_cap" ]]; then
+      json_ok "$(jq -n --argjson pruned 0 --argjson kept "$_bpg_total" '{pruned:$pruned,kept:$kept}')"; exit 0
+    fi
+
+    _bpg_pruned=0
+    while IFS= read -r _bpg_file; do
+      rm -f "$_bpg_file" 2>/dev/null && _bpg_pruned=$((_bpg_pruned + 1))
+    done < <(find "$_bpg_dir" -maxdepth 1 -type f -print0 2>/dev/null | xargs -0 ls -t 2>/dev/null | tail -n +$((_bpg_cap + 1)))
+
+    _bpg_kept=$((_bpg_total - _bpg_pruned))
+    json_ok "$(jq -n --argjson pruned "$_bpg_pruned" --argjson kept "$_bpg_kept" '{pruned:$pruned,kept:$kept}')"
+    ;;
+
+  temp-clean)
+    # Remove files from .aether/temp/ older than 7 days.
+    _tc_dir="$AETHER_ROOT/.aether/temp"
+    _tc_cleaned=0
+
+    if [[ ! -d "$_tc_dir" ]]; then
+      json_ok '{"cleaned":0,"dir_exists":false}'; exit 0
+    fi
+
+    while IFS= read -r _tc_file; do
+      rm -f "$_tc_file" 2>/dev/null && _tc_cleaned=$((_tc_cleaned + 1))
+    done < <(find "$_tc_dir" -maxdepth 1 -type f -mtime +7 2>/dev/null)
+
+    json_ok "$(jq -n --argjson cleaned "$_tc_cleaned" '{cleaned:$cleaned}')"
+    ;;
+
   # --- Autopilot State Tracking ---
   # Tracks /ant:run autopilot sessions in run-state.json (separate from COLONY_STATE.json)
   # Optional — colonies without /ant:run are unaffected
@@ -5462,6 +5543,101 @@ DRYRUN_EOF
   worktree-cleanup)
     _worktree_cleanup "$@"
     ;;
+  worktree-merge)
+    _worktree_merge "$@"
+    ;;
+
+  # ── Event Bus ───────────────────────────────────────────────────────────────
+  event-publish)
+    _event_publish "$@"
+    ;;
+  event-subscribe)
+    _event_subscribe "$@"
+    ;;
+  event-cleanup)
+    _event_cleanup "$@"
+    ;;
+  event-replay)
+    _event_replay "$@"
+    ;;
+
+  # ── Trust Scoring ──────────────────────────────────────────────────────────
+  trust-calculate)
+    _trust_calculate "$@"
+    ;;
+  trust-decay)
+    _trust_decay "$@"
+    ;;
+  trust-tier)
+    _trust_tier "$@"
+    ;;
+
+  # ── Instinct Store ─────────────────────────────────────────────────────────
+  instinct-store)
+    _instinct_store "$@"
+    ;;
+  instinct-read-trusted)
+    _instinct_read_trusted "$@"
+    ;;
+  instinct-decay-all)
+    _instinct_decay_all "$@"
+    ;;
+  instinct-archive)
+    _instinct_archive "$@"
+    ;;
+
+  # ── Graph Traversal ────────────────────────────────────────────────────────
+  graph-link)
+    _graph_link "$@"
+    ;;
+  graph-neighbors)
+    _graph_neighbors "$@"
+    ;;
+  graph-reach)
+    _graph_reach "$@"
+    ;;
+  graph-cluster)
+    _graph_cluster "$@"
+    ;;
+
+  # ── Curation Ants ──────────────────────────────────────────────────────────
+  curation-sentinel)
+    _curation_sentinel "$@"
+    ;;
+  curation-janitor)
+    _curation_janitor "$@"
+    ;;
+  curation-archivist)
+    _curation_archivist "$@"
+    ;;
+  curation-scribe)
+    _curation_scribe "$@"
+    ;;
+  curation-nurse)
+    _curation_nurse "$@"
+    ;;
+  curation-herald)
+    _curation_herald "$@"
+    ;;
+  curation-librarian)
+    _curation_librarian "$@"
+    ;;
+  curation-critic)
+    _curation_critic "$@"
+    ;;
+  curation-run)
+    _curation_run "$@"
+    ;;
+
+  # ── Consolidation Seal ─────────────────────────────────────────────────────
+  consolidation-seal)
+    _consolidation_seal "$@"
+    ;;
+
+  # ── Consolidation Phase End ───────────────────────────────────────────────
+  consolidation-phase-end)
+    _consolidation_phase_end "$@"
+    ;;
 
   *)
     json_err "$E_VALIDATION_FAILED" "Unknown command: $cmd"

package/.aether/commands/build.yaml

@@ -931,6 +931,41 @@ body_opencode: |
 
   This ensures verification failures are persisted as blockers that survive context resets. Chaos Ant findings are flagged in Step 5.7.
 
+  ### Stage Audit Gate (Pre-Synthesis Check)
+
+  **This gate runs before Step 5.9. All build stages must have completed before synthesizing results.**
+
+  Verify that each of the following stages has a recorded completion status:
+
+  | Stage | Steps | Required |
+  |-------|-------|----------|
+  | Builder waves | Steps 5.1–5.3 | At least 1 worker completed (status "completed") |
+  | Watcher | Steps 5.4–5.5 | Watcher returned a result (any status) |
+  | Chaos | Steps 5.6–5.7 | Chaos ant returned a result (any status) |
+
+  Check by reviewing the in-memory worker results accumulated during Steps 5.1–5.7:
+  - `builder_results` — results from all builder wave tasks
+  - `watcher_result` — result from Step 5.5
+  - `chaos_result` — result from Step 5.7
+
+  **If any stage result is absent (stage did not run or returned no result):**
+  - HALT — do not proceed to Step 5.9
+  - Display:
+    ```
+    Stage Audit FAILED — cannot synthesize results.
+
+    Missing or incomplete stages:
+      {list each missing stage: "Builders — no results recorded" / "Watcher — did not complete" / "Chaos — did not complete"}
+
+    Recovery options:
+      1. Re-run /ant:build to restart this phase
+      2. Run /ant:flags to review blockers
+      3. Run /ant:swarm to auto-repair failed tasks
+    ```
+  - Return `{"status": "failed", "summary": "Stage audit failed — stages did not complete"}` and stop.
+
+  **If all stages have results (even if some workers failed):** proceed to Step 5.9.
+
   ### Step 5.9: Synthesize Results
 
   **This step runs after all worker tasks have completed (Builders, Watcher, Chaos).**

package/.aether/commands/entomb.yaml

@@ -441,7 +441,7 @@ body_claude: |
   Display:
   ```
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-     C O L O N Y   E N T O M B E D
+  ⚰️ C O L O N Y   E N T O M B E D
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   Entombed v{colony_version}

package/.aether/commands/init.yaml

@@ -44,7 +44,6 @@ body: |
   - .aether/dreams/ (user notes)
   - .aether/chambers/ (archived colonies)
   - .env* files
-  - .claude/settings.json
   - .github/workflows/
   </read_only>
 
@@ -159,7 +158,7 @@ body: |
   Display a brief header:
   ```
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-     A E T H E R   C O L O N Y   I N I T
+  🥚 A E T H E R   C O L O N Y   I N I T
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   ```
 
@@ -473,30 +472,48 @@ body: |
   **If xml_import_available is false (no chambers, no XML, or no xmllint):**
 
   Skip silently -- proceed directly to Step 8 without any mention of import (per D-11).
+  ### Step 7.5: Install Clash Detection Hook
+
+  If `.aether/utils/clash-detect.sh` exists, run:
+
+  ```bash
+  bash .aether/aether-utils.sh clash-setup --install 2>/dev/null || true
+  ```
+
+  This installs the PreToolUse hook that prevents conflicting edits across worktrees.
+  Non-blocking — if it fails, init continues normally.
+
+  Also configure the merge driver for package-lock.json:
+
+  ```bash
+  git config merge.lockfile.driver "bash .aether/utils/merge-driver-lockfile.sh %O %A %B" 2>/dev/null || true
+  git config merge.lockfile.name "npm lockfile auto-merge" 2>/dev/null || true
+  ```
+
   ### Step 8: Display Result
 
   Display the success header and result block:
 
   ```
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-     A E T H E R   C O L O N Y
+  🥚 A E T H E R   C O L O N Y
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-  Queen has set the colony's intention
+  👑 Queen has set the colony's intention
 
      "{approved_intent}"
 
-     Colony Status: READY
+     🟢 Colony Status: READY
 
-  {If re-init: "   Mode: Re-init (charter updated, state preserved)"}
-  {If fresh and seeded_count > 0: "   Hive wisdom: {seeded_count} cross-colony pattern(s) seeded into QUEEN.md"}
+  {If re-init: "   🔄 Mode: Re-init (charter updated, state preserved)"}
+  {If fresh and seeded_count > 0: "   🧠 Hive wisdom: {seeded_count} cross-colony pattern(s) seeded into QUEEN.md"}
 
-  State persisted -- safe to /clear, then run /ant:plan
+  💾 State persisted -- safe to /clear, then run /ant:plan
 
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-     Next Up
+  🐜 Next Up
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-     /ant:plan                 Generate execution plan
-     /ant:status               Check colony state
-     /ant:focus                Set initial focus
+     /ant:plan                 📊 Generate execution plan
+     /ant:status               📋 Check colony state
+     /ant:focus                🎯 Set initial focus
   ```

package/.aether/commands/oracle.yaml

@@ -276,6 +276,41 @@ body_claude: |
 
   (The user will type their topic via the "Other" free-text option.)
 
+  **Question 1.5: Research Brief — Formulate and Approve**
+
+  Take the user's raw topic (from `$ARGUMENTS` or Question 1) and reformulate it into a structured research brief. The user may have typed casual natural language — your job is to sharpen it into a clear, well-scoped research prompt that will produce better results.
+
+  Display the brief for approval:
+
+  ```
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  🔮 R E S E A R C H   B R I E F
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  **Topic:** {reformulated topic — clear, specific, actionable}
+  **Core Question:** {the single most important question this research should answer}
+  **Context:** {what we already know from the codebase or user input}
+  **Success Criteria:** {what a good answer looks like — what would make this research useful}
+  ```
+
+  Guidelines for formulation:
+  - Turn vague topics into specific ones ("auth stuff" → "Authentication architecture: session-based vs token-based for this Node.js API")
+  - Add codebase context if relevant (tech stack, existing patterns)
+  - Make the core question answerable — not open-ended philosophy
+  - Keep success criteria concrete ("A recommendation with trade-offs" not "understand everything")
+
+  Then ask the user to approve:
+
+  ```
+  Does this capture what you're looking for? (approve / edit)
+  ```
+
+  - If the user approves: use the reformulated topic as the research topic going forward
+  - If the user edits: incorporate their changes, display the updated brief, and ask again
+  - Max 2 revision rounds (same as init). After 2, ask for final approval or cancel.
+
+  The approved **Topic** from the brief becomes the topic used in all subsequent steps (state.json, plan.json, research-plan.md).
+
   **Question 2: Research Template**
 
   ```
@@ -913,6 +948,41 @@ body_opencode: |
 
   (The user will type their topic via the "Other" free-text option.)
 
+  **Question 1.5: Research Brief — Formulate and Approve**
+
+  Take the user's raw topic (from `$normalized_args` or Question 1) and reformulate it into a structured research brief. The user may have typed casual natural language — your job is to sharpen it into a clear, well-scoped research prompt that will produce better results.
+
+  Display the brief for approval:
+
+  ```
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  🔮 R E S E A R C H   B R I E F
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+  **Topic:** {reformulated topic — clear, specific, actionable}
+  **Core Question:** {the single most important question this research should answer}
+  **Context:** {what we already know from the codebase or user input}
+  **Success Criteria:** {what a good answer looks like — what would make this research useful}
+  ```
+
+  Guidelines for formulation:
+  - Turn vague topics into specific ones ("auth stuff" → "Authentication architecture: session-based vs token-based for this Node.js API")
+  - Add codebase context if relevant (tech stack, existing patterns)
+  - Make the core question answerable — not open-ended philosophy
+  - Keep success criteria concrete ("A recommendation with trade-offs" not "understand everything")
+
+  Then ask the user to approve:
+
+  ```
+  Does this capture what you're looking for? (approve / edit)
+  ```
+
+  - If the user approves: use the reformulated topic as the research topic going forward
+  - If the user edits: incorporate their changes, display the updated brief, and ask again
+  - Max 2 revision rounds (same as init). After 2, ask for final approval or cancel.
+
+  The approved **Topic** from the brief becomes the topic used in all subsequent steps (state.json, plan.json, research-plan.md).
+
   **Question 2: Research Template**
 
   ```

package/.aether/commands/patrol.yaml

@@ -78,7 +78,7 @@ body: |
   Display audit header:
   ```
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-     C O L O N Y   A U D I T
+  🔍 C O L O N Y   A U D I T
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   Goal: {goal}
@@ -502,7 +502,7 @@ body: |
 
   ```
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-     A U D I T   R E S U L T S
+  📋 A U D I T   R E S U L T S
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   Goal: {goal}

package/.aether/commands/run.yaml

@@ -47,7 +47,7 @@ body: |
   (applying `--max-phases` cap), display the plan, then stop without executing.
 
   ```
-  ━━━ A U T O P I L O T   P R E V I E W ━━━
+  ━━━ 🤖 A U T O P I L O T   P R E V I E W ━━━
   Goal: {goal} | Current: Phase {N} | Remaining: {count} | Max: {max or "all"}
 
     Phase {id}: {name} ({task_count} tasks) -> build -> continue -> advance
@@ -185,7 +185,7 @@ body: |
   If `result.should_replan == true`: **PAUSE** with replan suggestion banner:
 
   ```
-  ━━━ R E P L A N   S U G G E S T E D ━━━
+  ━━━ 🔄 R E P L A N   S U G G E S T E D ━━━
   Phases auto-completed: {N} | Learnings accumulated: {learnings_since_last}
 
   The colony has completed {N} phases since the last plan review.
@@ -203,7 +203,7 @@ body: |
   ### Step 6: Final Summary
 
   ```
-  ━━━ A U T O P I L O T   C O M P L E T E ━━━
+  ━━━ ✅ A U T O P I L O T   C O M P L E T E ━━━
   Phases completed: {N} | Elapsed: {Xm Ys} | Now at: Phase {current}
 
   {all complete}  -> Colony goal achieved! Run /ant:seal

package/.aether/commands/swarm.yaml

@@ -235,7 +235,7 @@ body_claude: |
   Rank fix options:
   ```
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-                S O L U T I O N   R A N K I N G
+  🏆 S O L U T I O N   R A N K I N G
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   #1 [0.85 confidence] {best solution}

package/.aether/docs/command-playbooks/build-complete.md

@@ -1,3 +1,36 @@
+### Stage Audit Gate (Pre-Synthesis Check)
+
+**This gate runs before Step 5.9. All 4 prior playbook stages must have completed with "ok" status.**
+
+Check the cross-stage state record for each of the following stages:
+
+| Stage | Playbook | Required Status |
+|-------|----------|----------------|
+| 1 | build-prep | ok |
+| 2 | build-context | ok |
+| 3 | build-wave | ok |
+| 4 | build-verify | ok |
+
+To verify, read the cross-stage state (typically `.aether/data/build-stage-state.json` or the in-memory record accumulated during the build run) and confirm each stage entry has `"status": "ok"`.
+
+**If any stage is missing or did not complete with "ok" status:**
+- HALT — do not proceed to Step 5.9
+- Display:
+  ```
+  Stage Audit FAILED — cannot synthesize results.
+
+  Missing or failed stages:
+    {list each stage name with its recorded status, or "not recorded" if absent}
+
+  Recovery options:
+    1. Re-run the missing stage(s) manually, then retry /ant:build
+    2. Run /ant:flags to review blockers
+    3. Run /ant:swarm to auto-repair failed tasks
+  ```
+- Return `{"status": "failed", "summary": "Stage audit failed — stages {names} did not complete successfully"}` and stop.
+
+**If all 4 stages passed:** proceed to Step 5.9.
+
 ### Step 5.9: Synthesize Results
 
 **This step runs after all worker tasks have completed (Builders, Watcher, Chaos).**
@@ -253,7 +286,7 @@ Write the result to .aether/HANDOFF.md using the Write tool.
 
 This ensures the handoff always reflects the latest build state, even if the session crashes before explicit pause.
 
-### Step 6.5: Update Context Document
+### Step 6.6: Update Context Document
 
 Log this build activity to `.aether/CONTEXT.md`:
 
@@ -263,7 +296,7 @@ Also update safe-to-clear status:
 - If build completed successfully: `context-update safe-to-clear "YES" "Build complete, ready to continue"`
 - If build failed: `context-update safe-to-clear "NO" "Build failed — run /ant:swarm or /ant:flags"`
 
-### Step 5.10: Check for Promotion Proposals
+### Step 6.7: Check for Promotion Proposals
 
 After build completion (success or failure), check if any observations have met promotion thresholds.
 
@@ -295,14 +328,14 @@ Calculate `elapsed` using `build_started_at_epoch` (epoch integer captured at St
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-   B U I L D   S U M M A R Y
+🔨 B U I L D   S U M M A R Y
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Phase {id}: {name}
-Pattern:  {selected_pattern}
+📍 Phase {id}: {name}
+🎲 Pattern:  {selected_pattern}
 
-Workers:  {pass_count} passed  {fail_count} failed  ({total} total)
-Tools:    {total_tools} calls across all workers
-Duration: {elapsed}
+🐜 Workers:  {pass_count} passed  {fail_count} failed  ({total} total)
+🛠️ Tools:    {total_tools} calls across all workers
+⏱️ Duration: {elapsed}
 
 {if measurer_ran:}
 📊 Measurer: {baseline_count} baselines established, {bottleneck_count} bottlenecks identified

package/.aether/docs/command-playbooks/build-full.md

@@ -268,7 +268,7 @@ Output header:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-   B U I L D I N G   P H A S E   {id}
+🔨 B U I L D I N G   P H A S E   {id}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 📍 Phase {id}: {name}
@@ -1629,14 +1629,14 @@ Calculate `elapsed` using `build_started_at_epoch` (epoch integer captured at St
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-   B U I L D   S U M M A R Y
+🔨 B U I L D   S U M M A R Y
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Phase {id}: {name}
-Pattern:  {selected_pattern}
+📍 Phase {id}: {name}
+🎲 Pattern:  {selected_pattern}
 
-Workers:  {pass_count} passed  {fail_count} failed  ({total} total)
-Tools:    {total_tools} calls across all workers
-Duration: {elapsed}
+🐜 Workers:  {pass_count} passed  {fail_count} failed  ({total} total)
+🛠️ Tools:    {total_tools} calls across all workers
+⏱️ Duration: {elapsed}
 
 {if measurer_ran:}
 📊 Measurer: {baseline_count} baselines established, {bottleneck_count} bottlenecks identified

package/.aether/docs/command-playbooks/build-prep.md

@@ -275,7 +275,7 @@ Output header:
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-   B U I L D I N G   P H A S E   {id}
+🔨 B U I L D I N G   P H A S E   {id}
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 📍 Phase {id}: {name}