aether-colony 5.0.0 → 5.2.1

package/.opencode/commands/ant/plan.md

@@ -1,41 +1,25 @@
+<!-- Generated from .aether/commands/plan.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:plan
 description: "📊🐜🗺️🐜📊 Show project plan or generate project-specific phases"
 ---
 
-You are the **Queen**. Orchestrate research and planning until 80% confidence (maximum 4 iterations).
-
-## Instructions
-
 ### Step -1: Normalize Arguments
 
 Run: `normalized_args=$(bash .aether/aether-utils.sh normalize-args "$@")`
 
 This ensures arguments work correctly in both Claude Code and OpenCode. Use `$normalized_args` throughout this command.
 
-Parse `$normalized_args`:
-- If contains `--no-visual`: set `visual_mode = false` (visual is ON by default)
-- Otherwise: set `visual_mode = true`
-
-### Step 0: Initialize Visual Mode (if enabled)
 
-If `visual_mode` is true:
-```bash
-# Generate session ID
-plan_id="plan-$(date +%s)"
-
-# Initialize swarm display
-bash .aether/aether-utils.sh swarm-display-init "$plan_id"
-bash .aether/aether-utils.sh swarm-display-update "Queen" "prime" "excavating" "Generating colony plan" "Colony" '{"read":0,"grep":0,"edit":0,"bash":0}' 0 "fungus_garden" 0
-```
+You are the **Queen**. Orchestrate research and planning until the selected confidence target is reached within the selected iteration budget.
 
-### Step 0.5: Version Check (Non-blocking)
-
-Run using the Bash tool: `bash .aether/aether-utils.sh version-check 2>/dev/null || true`
+## Instructions
 
-If the command succeeds and the JSON result contains a non-empty string, display it as a one-line notice. Proceed regardless of outcome.
+Parse `$normalized_args`:
+- If contains `--no-visual`: set `visual_mode = false` (visual is ON by default)
+- Otherwise: set `visual_mode = true`
 
-### Step 1: Read State + Version Check
+### Step 1: Read State
 
 Read `.aether/data/COLONY_STATE.json`.
 
@@ -46,7 +30,7 @@ If `version` field is missing, "1.0", or "2.0":
 3. Output: `State auto-upgraded to v3.0`
 4. Continue with command.
 
-Extract: `goal`, `plan.phases`
+Extract: `goal`, `milestone`, `plan.phases`
 
 **Validate:** If `goal: null`:
 ```
@@ -54,6 +38,12 @@ No colony initialized. Run /ant:init "<goal>" first.
 ```
 Stop here.
 
+If `milestone` == `"Crowned Anthill"`:
+```
+This colony has been sealed. Start a new colony with /ant:init "new goal".
+```
+Stop here.
+
 ### Step 1.5: Load State and Show Resumption Context
 
 Run using Bash tool: `bash .aether/aether-utils.sh load-state`
@@ -86,6 +76,33 @@ Parse `$normalized_args`:
 - If contains `--accept`: Set `force_accept = true` (accept current plan regardless of confidence)
 - Otherwise: `force_accept = false`
 
+Select planning depth (prompt user if not explicitly provided):
+- Presets:
+  - `fast`: `target_confidence = 80`, `max_iterations = 4`
+  - `balanced`: `target_confidence = 90`, `max_iterations = 6`
+  - `deep`: `target_confidence = 95`, `max_iterations = 8`
+  - `exhaustive`: `target_confidence = 99`, `max_iterations = 12`
+- Preset selectors:
+  - `--fast`, `--balanced`, `--deep`, `--exhaustive`
+  - `--quality fast|balanced|deep|exhaustive`
+- CLI overrides:
+  - `--target <70-99>` to set `target_confidence`
+  - `--max-iterations <2-12>` to set `max_iterations`
+- If no preset/overrides are provided, ask:
+  `Planning depth? 1) Fast 2) Balanced 3) Deep (recommended) 4) Exhaustive`
+- Map user choice to a preset, default to `deep` on unclear input.
+- If overrides are out of range, clamp to valid ranges and continue.
+
+### Step 2.5: Load Compact Context Capsule
+
+Run using the Bash tool with description "Loading compact planning context...":
+```bash
+bash .aether/aether-utils.sh context-capsule --compact --json 2>/dev/null
+```
+
+If JSON is valid and `.ok == true`, extract `.result.prompt_section` into `context_capsule_prompt`.
+If command fails or returns invalid JSON, set `context_capsule_prompt = ""` and continue.
+
 ### Step 3: Initialize Planning State
 
 Update watch files for tmux visibility:
@@ -98,7 +115,7 @@ AETHER COLONY :: PLANNING
 State: PLANNING
 Phase: 0/0 (generating plan)
 Confidence: 0%
-Iteration: 0/4
+Iteration: 0/{max_iterations}
 
 Active Workers:
   [Research] Starting...
@@ -115,17 +132,12 @@ Progress
 
 [                    ] 0%
 
-Target: 80% confidence
+Target: {target_confidence}% confidence
 
-Iteration: 0/4
+Iteration: 0/{max_iterations}
 Gaps: (analyzing...)
 ```
 
-Log start:
-```bash
-bash .aether/aether-utils.sh activity-log "PLAN_START" "queen" "Iterative planning loop initiated for goal"
-```
-
 ### Step 3.5: Load Territory Survey
 
 Check if territory survey exists before research:
@@ -160,6 +172,129 @@ ls .aether/data/survey/*.md 2>/dev/null
 
 **If no survey:** Continue without survey context (scouts will do fresh exploration)
 
+### Step 3.6: Phase Domain Research
+
+Investigate domain knowledge for each phase before the planning loop begins. This runs every time `/ant:plan` generates a new plan -- no skip flag.
+
+**1. Retrieve hive wisdom for research priming:**
+
+```bash
+hive_context=$(bash .aether/aether-utils.sh hive-read --limit 5 --format text 2>/dev/null)
+```
+
+Parse the JSON result to extract `.result.text` as `hive_text`. If command fails or returns empty, set `hive_text = ""`.
+
+**2. Clean any previous research for this phase:**
+
+```bash
+research_dir=".aether/data/phase-research"
+mkdir -p "$research_dir"
+rm -f "$research_dir/phase-{phase_number}-research.md"
+```
+
+Re-running /ant:plan always re-researches from scratch.
+
+**3. Spawn Research Scout** via Task tool with `subagent_type="aether-scout"`:
+
+FALLBACK: If "Agent type not found", use general-purpose and inject role: "You are a Scout Ant performing Phase Domain Research."
+
+```
+You are a Scout Ant performing Phase Domain Research.
+
+--- MISSION ---
+Investigate the domain knowledge needed for Phase {phase_number}: {phase_name}
+Goal: "{goal}"
+Phase description: "{phase_description}"
+
+{context_capsule_prompt}
+
+--- PRE-EXISTING COLONY WISDOM ---
+{hive_text}
+
+--- RESEARCH AREAS ---
+1. Key patterns in the existing codebase relevant to this phase
+2. External library/API documentation if the phase involves external tools
+3. Common gotchas and pitfalls in this domain
+4. Recommended implementation approach based on findings
+
+--- SCOPE CONSTRAINTS ---
+- Maximum 5 key patterns
+- Maximum 3 gotchas
+- Maximum 1 recommended approach paragraph
+- Total output under 3000 words
+- Prioritize actionable guidance over exhaustive documentation
+- Check hive wisdom above first -- do not re-discover known patterns
+
+--- TOOLS ---
+Use: Glob, Grep, Read, WebSearch, WebFetch
+Do NOT use: Task, Write, Edit
+
+--- OUTPUT FORMAT ---
+Return JSON:
+{
+  "hive_wisdom_used": ["list of hive entries that were relevant"],
+  "key_patterns": [
+    {"pattern": "description", "source": "file path or URL", "relevance": "why it matters for this phase"}
+  ],
+  "external_context": [
+    {"topic": "what", "finding": "description", "source": "URL or doc reference"}
+  ],
+  "gotchas": [
+    {"issue": "what can go wrong", "prevention": "how to avoid it", "source": "evidence"}
+  ],
+  "recommended_approach": "synthesis paragraph",
+  "files_to_study": ["path1", "path2"]
+}
+```
+
+**4. Wait for scout to complete** (blocking -- direct Task return).
+
+**5. Parse scout JSON output and write RESEARCH.md to disk.** The Queen (plan.md orchestrator) writes the file -- scout is read-only. Write to: `.aether/data/phase-research/phase-{phase_number}-research.md`
+
+RESEARCH.md format (6 fixed sections):
+
+```markdown
+# Phase {N} Research: {Phase Name}
+
+**Generated:** {ISO-8601 timestamp}
+**Phase:** {N} - {Phase Name}
+**Research scope:** {brief summary of what was investigated}
+
+## Hive Wisdom (Pre-existing Knowledge)
+{Format hive_wisdom_used entries, or "No relevant hive wisdom found" if empty}
+
+## Key Patterns
+{Format each key_patterns entry as: **{pattern}:** {relevance} (Source: {source})}
+
+## External Context
+{Format each external_context entry as: **{topic}:** {finding} (Source: {source})}
+{If empty: "No external research needed for this phase"}
+
+## Gotchas
+{Format each gotchas entry as: **{issue}:** {prevention} (Source: {source})}
+
+## Recommended Approach
+{recommended_approach text}
+
+## Files to Study
+{Format as bullet list of file paths}
+```
+
+**6. Store research findings** in a variable `research_findings_summary` for injection into the Route-Setter prompt in Step 4. This is a compact summary (not the full RESEARCH.md):
+
+```
+Key Patterns: {bullet list of pattern names}
+Gotchas: {bullet list of gotcha titles}
+Recommended: {recommended_approach, first sentence only}
+Files: {comma-separated file paths}
+```
+
+**7. Display completion:**
+
+```
+Research complete: phase-{phase_number}-research.md ({word_count} words)
+```
+
 ### Step 4: Research and Planning Loop
 
 Initialize tracking:
@@ -170,15 +305,15 @@ Initialize tracking:
 - `last_confidence = 0`
 - `stall_count = 0` (consecutive iterations with < 5% improvement)
 
-**Loop (max 4 iterations, 2 agents per iteration: 1 scout + 1 planner):**
+**Loop (max {max_iterations} iterations, 2 agents per iteration: 1 scout + 1 planner):**
 
 ```
-while iteration < 4 AND confidence < 80:
+while iteration < max_iterations AND confidence < target_confidence:
     iteration += 1
 
     # === AUTO-BREAK CHECKS (no user prompt needed) ===
     if iteration > 1:
-        if confidence >= 80:
+        if confidence >= target_confidence:
             Log: "Confidence threshold reached ({confidence}%), finalizing plan"
             break
         if stall_count >= 2:
@@ -190,7 +325,7 @@ while iteration < 4 AND confidence < 80:
     if iteration == 1:
 
         # Broad exploration on first pass
-        Spawn Research Scout via Task tool with subagent_type="general-purpose":
+        Spawn Research Scout via Task tool with subagent_type="aether-scout":
 
         """
         You are a Scout Ant in the Aether Colony.
@@ -199,7 +334,9 @@ while iteration < 4 AND confidence < 80:
         Research the codebase to understand what exists and how it works.
 
         Goal: "{goal}"
-        Iteration: {iteration}/4
+        Iteration: {iteration}/{max_iterations}
+
+        {context_capsule_prompt}
 
         --- EXPLORATION AREAS ---
         Cover ALL of these in a single pass:
@@ -234,7 +371,7 @@ while iteration < 4 AND confidence < 80:
     else:
 
         # Gap-focused research on subsequent passes
-        Spawn Gap-Focused Scout via Task tool with subagent_type="general-purpose":
+        Spawn Gap-Focused Scout via Task tool with subagent_type="aether-scout":
 
         """
         You are a Scout Ant in the Aether Colony (gap-focused research).
@@ -243,7 +380,9 @@ while iteration < 4 AND confidence < 80:
         Investigate ONLY these specific knowledge gaps. Do not explore broadly.
 
         Goal: "{goal}"
-        Iteration: {iteration}/4
+        Iteration: {iteration}/{max_iterations}
+
+        {context_capsule_prompt}
 
         --- GAPS TO INVESTIGATE ---
         {for each gap in gaps:}
@@ -276,12 +415,10 @@ while iteration < 4 AND confidence < 80:
     # Wait for scout to complete.
     # Update gaps list from scout results.
 
-    Log: `bash .aether/aether-utils.sh activity-log "RESEARCH" "scout" "Iteration {iteration}: {scout.findings.length} findings, {scout.gaps_remaining.length} gaps"`
-
     # === PLANNING PHASE (always runs — 1 planner per iteration) ===
 
-    Spawn Planning Ant (Route-Setter) via Task tool with subagent_type="general-purpose":
-    # NOTE: Claude Code uses aether-route-setter; OpenCode uses general-purpose with role injection
+    Spawn Planning Ant (Route-Setter) via Task tool with subagent_type="aether-route-setter":
+    # NOTE: Claude Code uses aether-route-setter; OpenCode now uses same specialist agent
 
     """
     You are a Route-Setter Ant in the Aether Colony.
@@ -290,7 +427,9 @@ while iteration < 4 AND confidence < 80:
     Create or refine a project plan based on research findings.
 
     Goal: "{goal}"
-    Iteration: {iteration}/4
+    Iteration: {iteration}/{max_iterations}
+
+    {context_capsule_prompt}
 
     --- PLANNING DISCIPLINE ---
     Read .aether/planning.md for full reference.
@@ -329,6 +468,9 @@ while iteration < 4 AND confidence < 80:
     --- RESEARCH FINDINGS ---
     {scout.findings formatted — compact, max 5 items}
 
+    --- PHASE DOMAIN RESEARCH (from Step 3.6) ---
+    {research_findings_summary if available, otherwise omit this section}
+
     Remaining Gaps:
     {gaps formatted — compact, max 3 items}
 
@@ -390,8 +532,6 @@ while iteration < 4 AND confidence < 80:
 
     Parse planning results. Update plan_draft and confidence.
 
-    Log: `bash .aether/aether-utils.sh activity-log "PLANNING" "route-setter" "Confidence: {confidence}% (+{delta}%)"`
-
     # === UPDATE WATCH FILES ===
 
     Update `.aether/data/watch-status.txt` with current state.
@@ -423,7 +563,7 @@ Proceed directly to Step 5. No user confirmation needed — the plan auto-finali
 
 ### Step 5: Finalize Plan
 
-Once loop exits (confidence >= 80, max iterations reached, or stall detected):
+Once loop exits (confidence >= {target_confidence}, max iterations reached, or stall detected):
 
 Read current COLONY_STATE.json, then update:
 - Set `plan.phases` to the final phases array
@@ -433,7 +573,26 @@ Read current COLONY_STATE.json, then update:
 
 Write COLONY_STATE.json.
 
-Log: `bash .aether/aether-utils.sh activity-log "PLAN_COMPLETE" "queen" "Plan finalized with {confidence}% confidence"`
+**Verify the write** — read back and confirm the plan persisted:
+```bash
+verify_phases=$(jq '.plan.phases | length' .aether/data/COLONY_STATE.json)
+verify_timestamp=$(jq -r '.plan.generated_at' .aether/data/COLONY_STATE.json)
+verify_state=$(jq -r '.state' .aether/data/COLONY_STATE.json)
+if [[ "$verify_phases" -lt 1 || "$verify_timestamp" == "null" || "$verify_state" != "READY" ]]; then
+  echo "ERROR: Plan write verification failed (phases=$verify_phases, generated_at=$verify_timestamp, state=$verify_state)"
+  echo "Attempting retry write..."
+  bash .aether/aether-utils.sh state-write "$(jq --argjson phases "$(echo '$PLAN_JSON' | jq '.plan.phases')" --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" '.plan.phases = $phases | .plan.generated_at = $ts | .state = "READY"' .aether/data/COLONY_STATE.json)"
+  verify_phases=$(jq '.plan.phases | length' .aether/data/COLONY_STATE.json)
+  if [[ "$verify_phases" -lt 1 ]]; then
+    echo "FATAL: Retry write also failed. Plan was not persisted."
+    echo "Re-run /ant:plan to regenerate."
+    stop
+  fi
+fi
+echo "Plan verified: $verify_phases phases, generated_at=$verify_timestamp, state=$verify_state"
+```
+
+Log plan completion: `bash .aether/aether-utils.sh activity-log "PLAN_COMPLETE" "queen" "Plan finalized with {confidence}% confidence"`
 
 Update watch-status.txt:
 ```
@@ -449,12 +608,6 @@ Ready to build.
 
 ### Step 6: Display Plan
 
-**If visual_mode is true, render final swarm display:**
-```bash
-bash .aether/aether-utils.sh swarm-display-update "Queen" "prime" "completed" "Plan generated" "Colony" '{"read":8,"grep":4,"edit":2,"bash":1}' 100 "fungus_garden" 100
-bash .aether/aether-utils.sh swarm-display-render "$plan_id"
-```
-
 Read `plan.phases` from COLONY_STATE.json and display:
 
 ```
@@ -510,7 +663,7 @@ Each dimension rated 0-100%:
 
 **Overall** = weighted average (knowledge 25%, requirements 25%, risks 20%, dependencies 15%, effort 15%)
 
-**Target: 80%** - Sufficient confidence for autonomous execution. Higher confidence is achieved during builds as gaps are resolved.
+**Target:** Use the selected planning depth target. Higher targets trade latency for stronger up-front plan quality.
 
 ---
 
@@ -518,9 +671,9 @@ Each dimension rated 0-100%:
 
 The planning loop terminates automatically without requiring user input:
 
-1. **Confidence Threshold**: Loop exits when overall confidence reaches 80%
+1. **Confidence Threshold**: Loop exits when overall confidence reaches `{target_confidence}%`
 
-2. **Hard Iteration Cap**: Maximum 4 iterations (8 subagents total: 1 scout + 1 planner per iteration)
+2. **Hard Iteration Cap**: Maximum `{max_iterations}` iterations (2 subagents per iteration: 1 scout + 1 planner)
 
 3. **Stall Detection**: If confidence improves < 5% for 2 consecutive iterations, auto-finalize current plan
 

package/.opencode/commands/ant/preferences.md

@@ -0,0 +1,71 @@
+<!-- Generated from .aether/commands/preferences.yaml - DO NOT EDIT DIRECTLY -->
+---
+name: ant:preferences
+description: "📝🐜👑🐜📝 Add or list user preferences in hub QUEEN.md"
+---
+
+### Step -1: Normalize Arguments
+
+Run: `normalized_args=$(bash .aether/aether-utils.sh normalize-args "$@")`
+
+This ensures arguments work correctly in both Claude Code and OpenCode. Use `$normalized_args` throughout this command.
+
+You are the **Queen**. Manage user preferences in the hub `~/.aether/QUEEN.md`.
+
+## Instructions
+
+The input is: `$normalized_args`
+
+### Step 1: Validate
+
+If `$normalized_args` empty -> show usage: `/ant:preferences "preference text"` or `/ant:preferences --list`, stop.
+
+### Step 2: Route
+
+- `$normalized_args` is `--list` -> **List mode**
+- Otherwise -> **Add mode**
+
+### List Mode
+
+Read `~/.aether/QUEEN.md`. If missing -> "No hub QUEEN.md found. Run /ant:init to create one.", stop.
+
+Find the `## User Preferences` section (with or without emoji). Extract bullet lines (`- ...`) between that heading and the next `---`.
+
+If user-added bullets exist, output each. Otherwise:
+```
+No user preferences set yet.
+Add one with: /ant:preferences "your preference"
+```
+Stop.
+
+### Add Mode
+
+Set `PREF` to `$normalized_args` (strip surrounding quotes).
+If length > 500 chars -> "Preference too long (max 500 chars)", stop.
+
+Read `~/.aether/QUEEN.md`. If missing -> "No hub QUEEN.md found. Run /ant:init to create one.", stop.
+
+**If `## User Preferences` section exists** (with or without emoji):
+1. Remove `*No user preferences recorded yet.*` placeholder if present
+2. Append `- $PREF` at end of section (before next `---`)
+
+**If section missing** (migration case):
+1. Insert before `## Evolution Log` (with or without emoji):
+```
+## User Preferences
+
+- $PREF
+
+---
+
+```
+
+Update METADATA comment: increment `stats.total_user_prefs` by 1.
+
+### Confirm
+
+Output (2 lines, no banners):
+```
+Preference saved to hub QUEEN.md
+  "$PREF"
+```

package/.opencode/commands/ant/quick.md

@@ -0,0 +1,91 @@
+<!-- Generated from .aether/commands/quick.yaml - DO NOT EDIT DIRECTLY -->
+---
+name: ant:quick
+description: "🔍🐜⚡🐜🔍 Quick scout query — fast answers without build ceremony"
+---
+
+### Step -1: Normalize Arguments
+
+Run: `normalized_args=$(bash .aether/aether-utils.sh normalize-args "$@")`
+
+This ensures arguments work correctly in both Claude Code and OpenCode. Use `$normalized_args` throughout this command.
+
+You are the **Queen**. Execute `/ant:quick` — a lightweight scout mission.
+
+The query is: `$normalized_args`
+
+## Purpose
+
+Quick, focused answers to questions about the codebase, patterns, or implementation
+details. No build ceremony, no state changes, no verification waves.
+
+## Instructions
+
+### Step 1: Validate Arguments
+
+If `$normalized_args` is empty:
+```
+Usage: /ant:quick "<question>"
+
+Examples:
+  /ant:quick "how does the pheromone system work?"
+  /ant:quick "find all uses of acquire_lock"
+  /ant:quick "what tests cover midden-write?"
+  /ant:quick "show me the colony-prime token budget logic"
+```
+Stop here.
+
+### Step 2: Generate Scout Name
+
+Run:
+```bash
+bash .aether/aether-utils.sh generate-ant-name "scout"
+```
+
+Capture the output as `scout_name`.
+
+### Step 3: Spawn Scout
+
+Display:
+```
+━━━ Quick Scout ━━━
+Spawning {scout_name} — {query truncated to 50 chars}
+```
+
+Run:
+```bash
+bash .aether/aether-utils.sh spawn-log "Queen" "scout" "{scout_name}" "Quick query: {query}"
+```
+
+
+
+Investigate the query directly using available tools (Grep, Glob, Read).
+Search the codebase and provide a clear, focused answer with file paths and line numbers for key findings.
+Keep your answer concise and actionable.
+
+
+### Step 4: Display Results
+
+
+
+Display your findings directly to the user.
+
+
+Run:
+```bash
+bash .aether/aether-utils.sh spawn-complete "{scout_name}" "completed" "Quick query answered"
+```
+
+### Step 5: Update Session (lightweight)
+
+Run:
+```bash
+bash .aether/aether-utils.sh session-update "/ant:quick" "" "Quick query: {query truncated to 60 chars}" 2>/dev/null || true
+```
+
+**NOTE:** This command does NOT:
+- Modify COLONY_STATE.json
+- Advance phases
+- Create checkpoints
+- Spawn watchers or chaos ants
+- Run verification

package/.opencode/commands/ant/redirect.md

@@ -1,18 +1,22 @@
+<!-- Generated from .aether/commands/redirect.yaml - DO NOT EDIT DIRECTLY -->
 ---
 name: ant:redirect
 description: "⚠️🐜🚧🐜⚠️ Emit REDIRECT signal to warn colony away from patterns"
 ---
 
-You are the **Queen**. Add an AVOID constraint.
-
-## Instructions
-
 ### Step -1: Normalize Arguments
 
 Run: `normalized_args=$(bash .aether/aether-utils.sh normalize-args "$@")`
 
 This ensures arguments work correctly in both Claude Code and OpenCode. Use `$normalized_args` throughout this command.
 
+
+
+You are the **Queen**. Add an AVOID constraint.
+
+
+## Instructions
+
 The pattern to avoid is: `$normalized_args`
 
 ### Step 1: Validate
@@ -20,11 +24,15 @@ The pattern to avoid is: `$normalized_args`
 If `$normalized_args` empty -> show usage: `/ant:redirect <pattern to avoid>`, stop.
 If content > 500 chars -> "Redirect content too long (max 500 chars)", stop.
 
-### Step 2: Read + Update Constraints
+
+
+### Step 2: Write Signal
 
 Read `.aether/data/COLONY_STATE.json`.
 If `goal: null` -> "No colony initialized.", stop.
 
+
+
 Read `.aether/data/constraints.json`. If file doesn't exist, create it with:
 ```json
 {"version": "1.0", "focus": [], "constraints": []}
@@ -47,6 +55,12 @@ If `constraints` array exceeds 10 entries, remove the oldest entries to keep onl
 
 Write constraints.json.
 
+**Write pheromone signal and update context:**
+```bash
+bash .aether/aether-utils.sh pheromone-write REDIRECT "$normalized_args" --strength 0.9 --reason "User warned colony away from pattern" 2>/dev/null || true
+bash .aether/aether-utils.sh context-update constraint redirect "$normalized_args" "user" 2>/dev/null || true
+```
+
 ### Step 3: Confirm
 
 Output header:
@@ -65,3 +79,6 @@ Then output:
 
 🐜 Colony warned away from this pattern.
 ```
+
+
+