aether-colony 5.1.0 → 5.2.1

package/.aether/commands/seal.yaml

@@ -341,6 +341,15 @@ body_claude: |
   bash .aether/aether-utils.sh activity-log "MODIFIED" "Queen" "Colony sealed - wisdom review completed"
   ```
 
+  ### Step 4.4: Checkpoint State
+
+  Before modifying colony state, create a rolling backup:
+
+  Run using the Bash tool with description "Checkpointing colony state before seal...":
+  ```bash
+  bash .aether/aether-utils.sh state-checkpoint "pre-seal" 2>/dev/null || echo "Warning: State checkpoint failed -- continuing without backup" >&2
+  ```
+
   ### Step 4.5: Increment Colony Version
 
   Before writing the Crowned Anthill milestone, increment `colony_version` in COLONY_STATE.json.

package/.aether/commands/status.yaml

@@ -300,9 +300,53 @@ body: |
   ```
 
   {{#claude}}
-  **Data Safety:**
+  **Colony Vital Signs:**
   After the Memory Health table, run:
   ```bash
+  bash .aether/aether-utils.sh colony-vital-signs
+  ```
+
+  Extract from JSON result:
+  - build_velocity.phases_per_day and build_velocity.trend
+  - error_rate.errors_per_day and error_rate.status
+  - signal_health.active_count and signal_health.status
+  - memory_pressure.instinct_count and memory_pressure.status
+  - colony_age_hours
+  - overall_health (0-100 score)
+
+  Map overall_health score to a label:
+  - 80-100: "Thriving"
+  - 60-79: "Healthy"
+  - 40-59: "Stable"
+  - 20-39: "Struggling"
+  - 0-19: "Critical"
+
+  Display:
+  ```
+  💓 Colony Vital Signs
+  ┌─────────────────┬────────────┬─────────────────────────────┐
+  │ Vital Sign      │ Value      │ Status                      │
+  ├─────────────────┼────────────┼─────────────────────────────┤
+  │ Build Velocity  │ {phases_per_day}/d  │ {trend}            │
+  │ Error Rate      │ {errors_per_day}/d  │ {error_status}     │
+  │ Signal Health   │ {active_count}      │ {signal_status}    │
+  │ Memory Pressure │ {instinct_count}    │ {memory_status}    │
+  │ Colony Age      │ {colony_age_hours}h │                    │
+  ├─────────────────┼────────────┼─────────────────────────────┤
+  │ Overall Health  │ {overall_health}%   │ {health_label}     │
+  └─────────────────┴────────────┴─────────────────────────────┘
+  ```
+
+  If the command fails or returns no data, display:
+  ```
+  💓 Colony Vital Signs: No data available
+  ```
+  {{/claude}}
+
+  {{#claude}}
+  **Data Safety:**
+  After the Colony Vital Signs panel, run:
+  ```bash
   bash .aether/aether-utils.sh data-safety-stats
   ```
 

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

@@ -98,7 +98,8 @@ If the command fails (non-zero exit or JSON has ok: false):
 If successful:
 1. Parse the state JSON from result field
 2. Check if goal is null - if so: "No colony initialized. Run /ant:init first." and stop
-3. Extract current_phase and phase name from plan.phases[current_phase - 1].name
+3. Check if `milestone` == `"Crowned Anthill"` - if so: "This colony has been sealed. Start a new colony with `/ant:init \"new goal\"`." and stop
+4. Extract current_phase and phase name from plan.phases[current_phase - 1].name
 4. Display brief resumption context:
    ```
    🔄 Resuming: Phase X - Name

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

@@ -98,7 +98,8 @@ If the command fails (non-zero exit or JSON has ok: false):
 If successful:
 1. Parse the state JSON from result field
 2. Check if goal is null - if so: "No colony initialized. Run /ant:init first." and stop
-3. Extract current_phase and phase name from plan.phases[current_phase - 1].name
+3. Check if `milestone` == `"Crowned Anthill"` - if so: "This colony has been sealed. Start a new colony with `/ant:init \"new goal\"`." and stop
+4. Extract current_phase and phase name from plan.phases[current_phase - 1].name
 4. Display brief resumption context:
    ```
    🔄 Resuming: Phase X - Name

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

@@ -26,6 +26,7 @@ Extract: `goal`, `state`, `current_phase`, `plan.phases`, `errors`, `memory`, `e
 
 **Validation:**
 - If `goal: null` -> output "No colony initialized. Run /ant:init first." and stop.
+- If `milestone` == `"Crowned Anthill"` -> output "This colony has been sealed. Start a new colony with `/ant:init \"new goal\"`." and stop.
 - If `plan.phases` is empty -> output "No project plan. Run /ant:plan first." and stop.
 
 ### Step 1.5: Load State and Show Resumption Context

package/.aether/docs/command-playbooks/continue-verify.md

@@ -26,6 +26,7 @@ Extract: `goal`, `state`, `current_phase`, `plan.phases`, `errors`, `memory`, `e
 
 **Validation:**
 - If `goal: null` -> output "No colony initialized. Run /ant:init first." and stop.
+- If `milestone` == `"Crowned Anthill"` -> output "This colony has been sealed. Start a new colony with `/ant:init \"new goal\"`." and stop.
 - If `plan.phases` is empty -> output "No project plan. Run /ant:plan first." and stop.
 
 ### Step 1.5: Load State and Show Resumption Context

package/.aether/utils/council.sh

@@ -0,0 +1,425 @@
+#!/bin/bash
+# Council deliberation module — Advocate/Challenger/Sage model with spawn budget guards
+# Provides: _council_deliberate, _council_advocate, _council_challenger, _council_sage,
+#           _council_history, _council_budget_check
+#
+# These functions are sourced by aether-utils.sh at startup.
+# All shared infrastructure (json_ok, json_err, atomic_write, acquire_lock,
+# release_lock, LOCK_DIR, COLONY_DATA_DIR, error constants) is available.
+# _spawn_can_spawn is available from spawn.sh (sourced before this module).
+
+# ---------------------------------------------------------------------------
+# Internal helpers
+# ---------------------------------------------------------------------------
+
+_council_data_dir() {
+    echo "$COLONY_DATA_DIR/council"
+}
+
+_council_deliberations_file() {
+    echo "$COLONY_DATA_DIR/council/deliberations.json"
+}
+
+_council_ensure_file() {
+    local cf
+    cf="$(_council_deliberations_file)"
+    mkdir -p "$(_council_data_dir)"
+    if [[ ! -f "$cf" ]]; then
+        printf '%s\n' '{"version":"1.0","deliberations":[]}' > "$cf"
+    fi
+}
+
+# ---------------------------------------------------------------------------
+# _council_deliberate
+# Usage: council-deliberate --proposal <text> [--budget N] [--depth light|standard|deep]
+# ---------------------------------------------------------------------------
+_council_deliberate() {
+    local cd_proposal=""
+    local cd_budget="3"
+    local cd_depth="standard"
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --proposal) cd_proposal="${2:-}"; shift 2 ;;
+            --budget)   cd_budget="${2:-3}";  shift 2 ;;
+            --depth)    cd_depth="${2:-standard}"; shift 2 ;;
+            *) shift ;;
+        esac
+    done
+
+    if [[ -z "$cd_proposal" ]]; then
+        json_err "$E_VALIDATION_FAILED" "council-deliberate requires --proposal"
+        return
+    fi
+
+    if ! [[ "$cd_budget" =~ ^[0-9]+$ ]]; then
+        json_err "$E_VALIDATION_FAILED" "council-deliberate --budget must be a positive integer"
+        return
+    fi
+
+    local cd_ts
+    cd_ts=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+    local cd_unix
+    cd_unix=$(date -u +%s)
+    local cd_id="delib_${cd_unix}"
+
+    _council_ensure_file
+
+    local cd_file
+    cd_file="$(_council_deliberations_file)"
+
+    acquire_lock "$cd_file" 2>/dev/null || true
+    # shellcheck disable=SC2064
+    trap "release_lock '$cd_file' 2>/dev/null || true" EXIT
+
+    local cd_updated
+    cd_updated=$(jq \
+        --arg id "$cd_id" \
+        --arg proposal "$cd_proposal" \
+        --arg ts "$cd_ts" \
+        --argjson budget "$cd_budget" \
+        --arg depth "$cd_depth" \
+        '.deliberations += [{
+            "id": $id,
+            "proposal": $proposal,
+            "advocate": null,
+            "challenger": null,
+            "sage": null,
+            "budget": $budget,
+            "depth": $depth,
+            "created_at": $ts,
+            "status": "pending"
+        }]' "$cd_file") || {
+        release_lock "$cd_file" 2>/dev/null || true
+        trap - EXIT
+        json_err "$E_UNKNOWN" "Failed to write deliberation"
+        return
+    }
+
+    atomic_write "$cd_file" "$cd_updated" || {
+        release_lock "$cd_file" 2>/dev/null || true
+        trap - EXIT
+        json_err "$E_UNKNOWN" "Failed to persist deliberation"
+        return
+    }
+
+    release_lock "$cd_file" 2>/dev/null || true
+    trap - EXIT
+
+    json_ok "$(jq -n \
+        --arg id "$cd_id" \
+        --arg proposal "$cd_proposal" \
+        --argjson budget "$cd_budget" \
+        '{"id":$id,"proposal":$proposal,"status":"pending","budget":$budget}')"
+}
+
+# ---------------------------------------------------------------------------
+# _council_advocate
+# Usage: council-advocate --deliberation-id <id> --argument <text>
+# ---------------------------------------------------------------------------
+_council_advocate() {
+    local ca_id=""
+    local ca_argument=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --deliberation-id) ca_id="${2:-}"; shift 2 ;;
+            --argument)        ca_argument="${2:-}"; shift 2 ;;
+            *) shift ;;
+        esac
+    done
+
+    if [[ -z "$ca_id" ]]; then
+        json_err "$E_VALIDATION_FAILED" "council-advocate requires --deliberation-id"
+        return
+    fi
+
+    if [[ -z "$ca_argument" ]]; then
+        json_err "$E_VALIDATION_FAILED" "council-advocate requires --argument"
+        return
+    fi
+
+    local ca_file
+    ca_file="$(_council_deliberations_file)"
+
+    if [[ ! -f "$ca_file" ]]; then
+        json_err "$E_VALIDATION_FAILED" "No deliberations found; run council-deliberate first"
+        return
+    fi
+
+    local ca_exists
+    ca_exists=$(jq -r --arg id "$ca_id" '.deliberations[] | select(.id == $id) | .id' "$ca_file" 2>/dev/null || echo "")
+    if [[ -z "$ca_exists" ]]; then
+        json_err "$E_VALIDATION_FAILED" "Deliberation not found: $ca_id"
+        return
+    fi
+
+    acquire_lock "$ca_file" 2>/dev/null || true
+    # shellcheck disable=SC2064
+    trap "release_lock '$ca_file' 2>/dev/null || true" EXIT
+
+    local ca_updated
+    ca_updated=$(jq \
+        --arg id "$ca_id" \
+        --arg arg "$ca_argument" \
+        '(.deliberations[] | select(.id == $id)).advocate = $arg
+         | (.deliberations[] | select(.id == $id)).status = "in_progress"' \
+        "$ca_file") || {
+        release_lock "$ca_file" 2>/dev/null || true
+        trap - EXIT
+        json_err "$E_UNKNOWN" "Failed to record advocate argument"
+        return
+    }
+
+    atomic_write "$ca_file" "$ca_updated" || {
+        release_lock "$ca_file" 2>/dev/null || true
+        trap - EXIT
+        json_err "$E_UNKNOWN" "Failed to persist advocate argument"
+        return
+    }
+
+    release_lock "$ca_file" 2>/dev/null || true
+    trap - EXIT
+
+    json_ok '{"role":"advocate","recorded":true}'
+}
+
+# ---------------------------------------------------------------------------
+# _council_challenger
+# Usage: council-challenger --deliberation-id <id> --argument <text>
+# ---------------------------------------------------------------------------
+_council_challenger() {
+    local cc_id=""
+    local cc_argument=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --deliberation-id) cc_id="${2:-}"; shift 2 ;;
+            --argument)        cc_argument="${2:-}"; shift 2 ;;
+            *) shift ;;
+        esac
+    done
+
+    if [[ -z "$cc_id" ]]; then
+        json_err "$E_VALIDATION_FAILED" "council-challenger requires --deliberation-id"
+        return
+    fi
+
+    if [[ -z "$cc_argument" ]]; then
+        json_err "$E_VALIDATION_FAILED" "council-challenger requires --argument"
+        return
+    fi
+
+    local cc_file
+    cc_file="$(_council_deliberations_file)"
+
+    if [[ ! -f "$cc_file" ]]; then
+        json_err "$E_VALIDATION_FAILED" "No deliberations found; run council-deliberate first"
+        return
+    fi
+
+    local cc_exists
+    cc_exists=$(jq -r --arg id "$cc_id" '.deliberations[] | select(.id == $id) | .id' "$cc_file" 2>/dev/null || echo "")
+    if [[ -z "$cc_exists" ]]; then
+        json_err "$E_VALIDATION_FAILED" "Deliberation not found: $cc_id"
+        return
+    fi
+
+    acquire_lock "$cc_file" 2>/dev/null || true
+    # shellcheck disable=SC2064
+    trap "release_lock '$cc_file' 2>/dev/null || true" EXIT
+
+    local cc_updated
+    cc_updated=$(jq \
+        --arg id "$cc_id" \
+        --arg arg "$cc_argument" \
+        '(.deliberations[] | select(.id == $id)).challenger = $arg
+         | (.deliberations[] | select(.id == $id)).status = "in_progress"' \
+        "$cc_file") || {
+        release_lock "$cc_file" 2>/dev/null || true
+        trap - EXIT
+        json_err "$E_UNKNOWN" "Failed to record challenger argument"
+        return
+    }
+
+    atomic_write "$cc_file" "$cc_updated" || {
+        release_lock "$cc_file" 2>/dev/null || true
+        trap - EXIT
+        json_err "$E_UNKNOWN" "Failed to persist challenger argument"
+        return
+    }
+
+    release_lock "$cc_file" 2>/dev/null || true
+    trap - EXIT
+
+    json_ok '{"role":"challenger","recorded":true}'
+}
+
+# ---------------------------------------------------------------------------
+# _council_sage
+# Usage: council-sage --deliberation-id <id> --synthesis <text> --recommendation <text>
+# ---------------------------------------------------------------------------
+_council_sage() {
+    local cs_id=""
+    local cs_synthesis=""
+    local cs_recommendation=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --deliberation-id) cs_id="${2:-}";             shift 2 ;;
+            --synthesis)       cs_synthesis="${2:-}";       shift 2 ;;
+            --recommendation)  cs_recommendation="${2:-}";  shift 2 ;;
+            *) shift ;;
+        esac
+    done
+
+    if [[ -z "$cs_id" ]]; then
+        json_err "$E_VALIDATION_FAILED" "council-sage requires --deliberation-id"
+        return
+    fi
+
+    if [[ -z "$cs_synthesis" ]]; then
+        json_err "$E_VALIDATION_FAILED" "council-sage requires --synthesis"
+        return
+    fi
+
+    if [[ -z "$cs_recommendation" ]]; then
+        json_err "$E_VALIDATION_FAILED" "council-sage requires --recommendation"
+        return
+    fi
+
+    local cs_file
+    cs_file="$(_council_deliberations_file)"
+
+    if [[ ! -f "$cs_file" ]]; then
+        json_err "$E_VALIDATION_FAILED" "No deliberations found; run council-deliberate first"
+        return
+    fi
+
+    local cs_exists
+    cs_exists=$(jq -r --arg id "$cs_id" '.deliberations[] | select(.id == $id) | .id' "$cs_file" 2>/dev/null || echo "")
+    if [[ -z "$cs_exists" ]]; then
+        json_err "$E_VALIDATION_FAILED" "Deliberation not found: $cs_id"
+        return
+    fi
+
+    acquire_lock "$cs_file" 2>/dev/null || true
+    # shellcheck disable=SC2064
+    trap "release_lock '$cs_file' 2>/dev/null || true" EXIT
+
+    local cs_updated
+    cs_updated=$(jq \
+        --arg id "$cs_id" \
+        --arg synthesis "$cs_synthesis" \
+        --arg rec "$cs_recommendation" \
+        '(.deliberations[] | select(.id == $id)).sage = {"synthesis": $synthesis, "recommendation": $rec}
+         | (.deliberations[] | select(.id == $id)).status = "complete"' \
+        "$cs_file") || {
+        release_lock "$cs_file" 2>/dev/null || true
+        trap - EXIT
+        json_err "$E_UNKNOWN" "Failed to record sage synthesis"
+        return
+    }
+
+    atomic_write "$cs_file" "$cs_updated" || {
+        release_lock "$cs_file" 2>/dev/null || true
+        trap - EXIT
+        json_err "$E_UNKNOWN" "Failed to persist sage synthesis"
+        return
+    }
+
+    release_lock "$cs_file" 2>/dev/null || true
+    trap - EXIT
+
+    json_ok "$(jq -n \
+        --arg rec "$cs_recommendation" \
+        '{"role":"sage","recommendation":$rec,"deliberation_complete":true}')"
+}
+
+# ---------------------------------------------------------------------------
+# _council_history
+# Usage: council-history [--limit N]
+# ---------------------------------------------------------------------------
+_council_history() {
+    local ch_limit=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --limit) ch_limit="${2:-}"; shift 2 ;;
+            *) shift ;;
+        esac
+    done
+
+    local ch_file
+    ch_file="$(_council_deliberations_file)"
+
+    if [[ ! -f "$ch_file" ]]; then
+        json_ok '{"total":0,"deliberations":[]}'
+        return
+    fi
+
+    local ch_total
+    ch_total=$(jq '.deliberations | length' "$ch_file" 2>/dev/null || echo 0)
+
+    if [[ -n "$ch_limit" ]] && [[ "$ch_limit" =~ ^[0-9]+$ ]]; then
+        local ch_result
+        ch_result=$(jq \
+            --argjson limit "$ch_limit" \
+            --argjson total "$ch_total" \
+            '{"total":$total,"deliberations":(.deliberations | .[-($limit):])}' \
+            "$ch_file" 2>/dev/null) || ch_result='{"total":0,"deliberations":[]}'
+        json_ok "$ch_result"
+    else
+        local ch_result
+        ch_result=$(jq \
+            --argjson total "$ch_total" \
+            '{"total":$total,"deliberations":.deliberations}' \
+            "$ch_file" 2>/dev/null) || ch_result='{"total":0,"deliberations":[]}'
+        json_ok "$ch_result"
+    fi
+}
+
+# ---------------------------------------------------------------------------
+# _council_budget_check
+# Usage: council-budget-check [--budget N]
+# ---------------------------------------------------------------------------
+_council_budget_check() {
+    local cb_budget="3"
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --budget) cb_budget="${2:-3}"; shift 2 ;;
+            *) shift ;;
+        esac
+    done
+
+    if ! [[ "$cb_budget" =~ ^[0-9]+$ ]]; then
+        json_err "$E_VALIDATION_FAILED" "council-budget-check --budget must be a positive integer"
+        return
+    fi
+
+    # Delegate to spawn-can-spawn at depth 1
+    local cb_spawn_result
+    cb_spawn_result=$(_spawn_can_spawn 1 2>/dev/null || echo '{"can_spawn":false,"current_total":0,"global_cap":10}')
+
+    local cb_can
+    cb_can=$(echo "$cb_spawn_result" | jq -r '.result.can_spawn // .can_spawn // false' 2>/dev/null || echo "false")
+    local cb_current
+    cb_current=$(echo "$cb_spawn_result" | jq -r '.result.current_total // .current_total // 0' 2>/dev/null || echo 0)
+    local cb_cap
+    cb_cap=$(echo "$cb_spawn_result" | jq -r '.result.global_cap // .global_cap // 10' 2>/dev/null || echo 10)
+    local cb_remaining=$(( cb_cap - cb_current ))
+    [[ $cb_remaining -lt 0 ]] && cb_remaining=0
+
+    # allowed is true only if spawn is allowed AND remaining >= requested budget
+    local cb_allowed="false"
+    if [[ "$cb_can" == "true" ]] && [[ $cb_remaining -ge $cb_budget ]]; then
+        cb_allowed="true"
+    fi
+
+    json_ok "$(jq -n \
+        --argjson allowed "$cb_allowed" \
+        --argjson remaining "$cb_remaining" \
+        --argjson budget "$cb_budget" \
+        '{"allowed":$allowed,"remaining":$remaining,"budget":$budget}')"
+}

package/.aether/utils/error-handler.sh

@@ -87,7 +87,7 @@ json_err() {
     "$code" "$escaped_message" "$details_json" "$recovery" "$timestamp" >&2
 
   # Log to activity.log (best effort)
-  if [[ -n "${COLONY_DATA_DIR:-}" ]]; then
+  if [[ -n "${COLONY_DATA_DIR:-}" ]] && [[ "${AETHER_TESTING:-}" != "1" ]]; then
     echo "[$timestamp] ERROR $code: $escaped_message" >> "$COLONY_DATA_DIR/activity.log" 2>/dev/null || true
   fi
 
@@ -111,7 +111,7 @@ json_warn() {
     "$code" "$escaped_message" "$timestamp"
 
   # Log to activity.log (best effort)
-  if [[ -n "${COLONY_DATA_DIR:-}" ]]; then
+  if [[ -n "${COLONY_DATA_DIR:-}" ]] && [[ "${AETHER_TESTING:-}" != "1" ]]; then
     echo "[$timestamp] WARN $code: $escaped_message" >> "$COLONY_DATA_DIR/activity.log" 2>/dev/null || true
   fi
 }
@@ -153,7 +153,7 @@ error_handler() {
     "$E_BASH_ERROR" "$details" "$(_recovery_default)" "$timestamp" >&2
 
   # Log to activity.log (best effort)
-  if [[ -n "${COLONY_DATA_DIR:-}" ]]; then
+  if [[ -n "${COLONY_DATA_DIR:-}" ]] && [[ "${AETHER_TESTING:-}" != "1" ]]; then
     echo "[$timestamp] ERROR $E_BASH_ERROR: Command failed at line $line_num (exit $exit_code)" >> "$COLONY_DATA_DIR/activity.log" 2>/dev/null || true
   fi
 

package/.aether/utils/flag.sh

@@ -204,22 +204,33 @@ _flag_list() {
       exit 0
     fi
 
-    # Build jq filter
-    jq_filter='.flags'
-
-    if [[ "$show_all" != "true" ]]; then
-      jq_filter+=' | [.[] | select(.resolved_at == null)]'
-    fi
-
-    if [[ -n "$filter_type" ]]; then
-      jq_filter+=" | [.[] | select(.type == \"$filter_type\")]"
+    # Validate filter_phase as numeric (safe for --argjson)
+    if [[ -n "$filter_phase" && "$filter_phase" =~ ^[0-9]+$ ]]; then
+      phase_num="$filter_phase"
+    else
+      phase_num=""
     fi
 
-    if [[ -n "$filter_phase" && "$filter_phase" =~ ^[0-9]+$ ]]; then
-      jq_filter+=" | [.[] | select(.phase == $filter_phase or .phase == null)]"
+    # Build jq command with --arg to prevent filter injection
+    # filter_type is passed via --arg (safe string interpolation in jq)
+    # phase_num is passed via --argjson (numeric-only, pre-validated)
+    if [[ -n "$phase_num" ]]; then
+      result=$(jq --arg ft "$filter_type" --argjson ph "$phase_num" --argjson all "$show_all" '
+        .flags
+        | (if $all | not then [.[] | select(.resolved_at == null)] else . end)
+        | (if $ft != "" then [.[] | select(.type == $ft)] else . end)
+        | (if $ph != null then [.[] | select(.phase == $ph or .phase == null)] else . end)
+        | {flags: ., count: length}
+      ' "$flags_file")
+    else
+      result=$(jq --arg ft "$filter_type" --argjson all "$show_all" '
+        .flags
+        | (if $all | not then [.[] | select(.resolved_at == null)] else . end)
+        | (if $ft != "" then [.[] | select(.type == $ft)] else . end)
+        | {flags: ., count: length}
+      ' "$flags_file")
     fi
 
-    result=$(jq "{flags: ($jq_filter), count: ($jq_filter | length)}" "$flags_file")
     json_ok "$result"
 }
 

package/.aether/utils/hive.sh

@@ -306,14 +306,14 @@ _hive_read() {
       --argjson limit "$hr_limit" '
       .entries
       | map(
-          select((.confidence | tonumber) >= $min_conf)
+          select(((.confidence // 0) | tonumber) >= $min_conf)
           | if ($domain_filter | length) > 0 then
               select(
                 [.domain_tags[] as $dt | $domain_filter[] | select(. == $dt)] | length > 0
               )
             else . end
         )
-      | sort_by(-(.confidence | tonumber), -.validated_count)
+      | sort_by(-((.confidence // 0) | tonumber), -.validated_count)
       | { total_matched: length, entries: .[:$limit], returned_ids: [.[:$limit][].id] }
     ' "$hr_wisdom_file" 2>/dev/null) || {
       json_ok '{"entries":[],"total_matched":0,"fallback":"filter_error"}'