aether-colony 5.3.2 → 5.4.0

package/.opencode/commands/ant/resume.md

@@ -32,7 +32,7 @@ Execute the following steps in order when the user runs `/ant:resume`.
 
 Run::
 ```bash
-bash .aether/aether-utils.sh session-read
+aether session-read
 ```
 
 Parse the JSON result.
@@ -102,11 +102,9 @@ Do NOT proceed with stale or fabricated data.
 
 ### Step 3: Read Pheromone Signals
 
-
-
 Run::
 ```bash
-bash .aether/aether-utils.sh pheromone-read all
+aether pheromone-read all
 ```
 
 Parse the JSON result. Extract `.result.signals` array.
@@ -117,7 +115,6 @@ Parse the JSON result. Extract `.result.signals` array.
 
 Note: pheromone-read applies decay calculation automatically. The `effective_strength` field reflects current signal strength after time-based decay. Signals below 0.1 effective strength are already filtered out.
 
-
 ---
 
 ### Step 4: Read CONTEXT.md
@@ -299,12 +296,9 @@ Recent Decisions:
 
 {if signals array from Step 3 is not empty:}
 Active Signals:
-
-
 {for each signal in signals:}
   {signal.type}: "{signal.content}" [{signal.effective_strength * 100 | floor}%]
 {end}
-
 {end}
 ```
 
@@ -314,7 +308,7 @@ Active Signals:
 
 Run::
 ```bash
-bash .aether/aether-utils.sh resume-dashboard
+aether resume-dashboard
 ```
 
 Extract memory_health from the JSON result:
@@ -346,7 +340,7 @@ Session: {session_id}
 
 Run::
 ```bash
-bash .aether/aether-utils.sh session-mark-resumed
+aether session-mark-resumed
 ```
 
 ### Step 10: Next Up
@@ -356,7 +350,7 @@ Generate the state-based Next Up block by Run::
 state=$(jq -r '.state // "IDLE"' .aether/data/COLONY_STATE.json)
 current_phase=$(jq -r '.current_phase // 0' .aether/data/COLONY_STATE.json)
 total_phases=$(jq -r '.plan.phases | length' .aether/data/COLONY_STATE.json)
-bash .aether/aether-utils.sh print-next-up "$state" "$current_phase" "$total_phases"
+aether print-next-up
 ```
 
 ---
@@ -367,10 +361,7 @@ bash .aether/aether-utils.sh print-next-up "$state" "$current_phase" "$total_pha
 |-----------|----------|
 | session.json missing (exists=false) | "No previous session found" — offer /ant:init and /ant:status |
 | COLONY_STATE.json missing or corrupted | Pause, ask user: start fresh or recover |
-
-
 | pheromone-read fails | Skip silently (no pheromones) |
-
 | CONTEXT.md missing | Fall back to COLONY_STATE.json narrative |
 | No plan phases, no generated_at | BLOCK — redirect to /ant:plan |
 | Plan attempted but no phases | BLOCK — redirect to /ant:plan |
@@ -382,10 +373,7 @@ bash .aether/aether-utils.sh print-next-up "$state" "$current_phase" "$total_pha
 
 ## Key Constraints
 
-
-
 - Use Read tool for COLONY_STATE.json (not bash cat/jq). Use Bash tool for pheromone-read (applies decay calculation).
-
 - Use Bash tool only for aether-utils.sh commands and git commands
 - Handle ALL missing/corrupted file cases gracefully
 - Time-agnostic: restore identically regardless of how long ago the session was

package/.opencode/commands/ant/run.md

@@ -55,7 +55,7 @@ If `--dry-run`: read COLONY_STATE.json, list remaining incomplete phases
 (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
@@ -74,9 +74,9 @@ replan suggestion (every {replan_interval} phases)
    - If `milestone` == `"Crowned Anthill"`: output "This colony has been sealed. Start a new colony with `/ant:init \"new goal\"`." and stop
 2. Determine remaining incomplete phases; apply `--max-phases` cap
 3. Set `phases_completed = 0`, `autopilot_start = $(date +%s)`
-4. Record pre-build blocker count: `bash .aether/aether-utils.sh flag-check-blockers {phase}`
+4. Record pre-build blocker count: `aether flag-check-blockers {phase}`
 5. If `--headless` flag is present:
-   - Run: `bash .aether/aether-utils.sh autopilot-set-headless true`
+   - Run: `aether autopilot-set-headless true`
    - Display: `Headless mode: ON — interactive prompts will be queued as pending decisions`
 6. Display: `AUTOPILOT ENGAGED | Goal: {goal} | Phase {N} | Max: {max or "all"}`
 
@@ -113,7 +113,7 @@ Log: `"<timestamp>|autopilot_paused|run|Paused at Phase {id}: {reason}"`
 visual checkpoint prompt would normally be shown to the user, instead queue it as
 a pending decision:
 ```bash
-bash .aether/aether-utils.sh pending-decision-add \
+aether pending-decision-add \
   --title "Visual checkpoint: Phase {id}" \
   --type "checkpoint" \
   --description "{checkpoint_description}" \
@@ -142,7 +142,7 @@ Skip the AskUserQuestion prompt. Instead, auto-PAUSE with reason
 **Headless override for runtime verification:** If headless mode is active and
 runtime verification would normally pause, queue as a pending decision instead:
 ```bash
-bash .aether/aether-utils.sh pending-decision-add \
+aether pending-decision-add \
   --title "Runtime verification needed: Phase {id}" \
   --type "runtime-verification" \
   --description "Manual testing required before advancing past Phase {id}" \
@@ -173,7 +173,7 @@ replan suggestion (see Step 5.5). For all others: PAUSE with reason, log event,
 ### Step 5: Auto-Advance and Loop
 
 1. Increment `phases_completed`
-2. Update autopilot state: `bash .aether/aether-utils.sh autopilot-update --action advance --phase {next} --result success`
+2. Update autopilot state: `aether autopilot-update --action advance --phase {next} --result success`
 3. Log: `"<timestamp>|autopilot_advance|run|Phase {prev} -> {next} ({phases_completed}/{max})"`
 4. Display: `--- Autopilot: Phase {prev} done -> Phase {next} ({N}/{max}) ---`
 5. **Replan check** (see Step 5.5)
@@ -185,7 +185,7 @@ replan suggestion (see Step 5.5). For all others: PAUSE with reason, log event,
 After each successful phase advance, check if a replan pause should fire:
 
 ```bash
-bash .aether/aether-utils.sh autopilot-check-replan --interval {replan_interval}
+aether autopilot-check-replan --interval {replan_interval}
 ```
 
 If `--continue` flag was passed: skip this check entirely (user dismissed replan).
@@ -193,7 +193,7 @@ If `--continue` flag was passed: skip this check entirely (user dismissed replan
 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.
@@ -211,7 +211,7 @@ If `result.should_replan == false`: proceed normally (no pause).
 ### 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
@@ -226,7 +226,7 @@ Pending decisions: {N} — run `pending-decision-list` to review
 ```
 
 Update session:
-`bash .aether/aether-utils.sh session-update "/ant:run" "/ant:run" "Autopilot: {N} phases, now Phase {current}"`
+`aether session-update --command "/ant:run" --worker "/ant:run" --summary "Autopilot: {N} phases, now Phase {current}"`
 
 ## Execution Contract
 

package/.opencode/commands/ant/seal.md

@@ -171,7 +171,7 @@ Build a summary of what the colony accomplished across all phases:
 - Summarize the goal and key outcomes in one line
 
 ```bash
-bash .aether/aether-utils.sh changelog-append \
+aether changelog-append \
   "$(date +%Y-%m-%d)" \
   "seal-crowned-anthill" \
   "00" \
@@ -192,7 +192,7 @@ Mark the colony as inactive in the global registry. This is silent on failure
 
 Run using the Bash tool (ignore errors):
 ```bash
-bash .aether/aether-utils.sh registry-add "$(pwd)" "$(jq -r '.version // "unknown"' ~/.aether/version.json 2>/dev/null || echo 'unknown')" --active false 2>/dev/null || true
+aether registry-add --path "$(pwd)" "$(jq -r '.version // "unknown"' ~/.aether/version.json 2>/dev/null || echo 'unknown')" --active false 2>/dev/null || true
 ```
 
 If the command fails, proceed silently. This is optional bookkeeping.
@@ -237,7 +237,7 @@ for encoded in $high_conf_instincts; do
   [[ -n "$repo_domain_tags" ]] && promote_args+=(--domain "$repo_domain_tags")
 
   # Call hive-promote which orchestrates abstract + store
-  result=$(bash .aether/aether-utils.sh "${promote_args[@]}" 2>/dev/null || echo '{}')
+  result=$(aether "${promote_args[@]}" 2>/dev/null || echo '{}')
   was_promoted=$(echo "$result" | jq -r '.result.action // "skipped"' 2>/dev/null || echo "skipped")
 
   if [[ "$was_promoted" == "promoted" || "$was_promoted" == "merged" ]]; then
@@ -283,7 +283,7 @@ Export colony data as a combined XML archive and a standalone pheromones.xml. Bo
 ```bash
 # Check if xmllint is available
 if command -v xmllint >/dev/null 2>&1; then
-  xml_result=$(bash .aether/aether-utils.sh colony-archive-xml ".aether/exchange/colony-archive.xml" 2>&1)
+  xml_result=$(aether colony-archive-xml --output ".aether/exchange/colony-archive.xml" 2>&1)
   xml_ok=$(echo "$xml_result" | jq -r '.ok // false' 2>/dev/null)
   if [[ "$xml_ok" == "true" ]]; then
     xml_pheromone_count=$(echo "$xml_result" | jq -r '.result.pheromone_count // 0' 2>/dev/null)
@@ -293,7 +293,7 @@ if command -v xmllint >/dev/null 2>&1; then
   fi
 
   # Also export standalone pheromones.xml for cross-colony sharing
-  pher_result=$(bash .aether/aether-utils.sh pheromone-export-xml ".aether/exchange/pheromones.xml" 2>&1)
+  pher_result=$(aether pheromone-export-xml --output ".aether/exchange/pheromones.xml" 2>&1)
   pher_ok=$(echo "$pher_result" | jq -r '.ok // false' 2>/dev/null)
   if [[ "$pher_ok" == "true" ]]; then
     pher_signal_count=$(jq '[.signals[] | select(.active != false)] | length' .aether/data/pheromones.json 2>/dev/null || echo "0")
@@ -303,7 +303,7 @@ if command -v xmllint >/dev/null 2>&1; then
   fi
 
   # Export standalone queen-wisdom.xml for cross-colony wisdom sharing
-  wisdom_result=$(bash .aether/aether-utils.sh wisdom-export-xml ".aether/exchange/queen-wisdom.xml" 2>&1)
+  wisdom_result=$(aether wisdom-export-xml ".aether/exchange/queen-wisdom.xml" 2>&1)
   wisdom_ok=$(echo "$wisdom_result" | jq -r '.ok // false' 2>/dev/null)
   if [[ "$wisdom_ok" == "true" ]]; then
     wisdom_count=$(echo "$wisdom_result" | jq -r '.result.entries // 0' 2>/dev/null)
@@ -313,7 +313,7 @@ if command -v xmllint >/dev/null 2>&1; then
   fi
 
   # Export standalone colony-registry.xml for lineage tracking
-  registry_result=$(bash .aether/aether-utils.sh registry-export-xml ".aether/exchange/colony-registry.xml" 2>&1)
+  registry_result=$(aether registry-export-xml ".aether/exchange/colony-registry.xml" 2>&1)
   registry_ok=$(echo "$registry_result" | jq -r '.ok // false' 2>/dev/null)
   if [[ "$registry_ok" == "true" ]]; then
     registry_count=$(echo "$registry_result" | jq -r '.result.colonies // 0' 2>/dev/null)
@@ -384,7 +384,7 @@ After the ceremony, offer to commit all colony work.
 
 Generate a seal commit message:
 ```bash
-seal_commit=$(bash .aether/aether-utils.sh generate-commit-message seal "$phases_completed" "$goal" "$colony_age_days" 2>/dev/null)
+seal_commit=$(aether generate-commit-message seal "$phases_completed" "$goal" "$colony_age_days" 2>/dev/null)
 seal_message=$(echo "$seal_commit" | jq -r '.result.message // "aether-seal: colony sealed"')
 seal_body=$(echo "$seal_commit" | jq -r '.result.body // ""')
 ```

package/.opencode/commands/ant/skill-create.md

@@ -57,7 +57,7 @@ Create the skill file with proper frontmatter and body:
 ### Step 4: Write and Verify
 
 1. Write to `~/.aether/skills/domain/{name}/SKILL.md`
-2. Run: `bash .aether/aether-utils.sh skill-parse-frontmatter ~/.aether/skills/domain/{name}/SKILL.md`
-3. Run: `bash .aether/aether-utils.sh skill-cache-rebuild`
+2. Run: `aether skill-parse-frontmatter ~/.aether/skills/domain/{name}/SKILL.md`
+3. Run: `aether skill-cache-rebuild`
 4. Show the generated skill to the user
 5. Ask if they want to adjust anything

package/.opencode/commands/ant/status.md

@@ -16,7 +16,7 @@ You are the **Queen**. Show colony status.
 
 ### Step 0: Version Check (Non-blocking)
 
-Run: `bash .aether/aether-utils.sh version-check-cached 2>/dev/null || true`
+Run: `aether version-check-cached 2>/dev/null || true`
 
 If the command succeeds and the JSON result contains a non-empty string, display it as a one-line notice. Proceed regardless of outcome.
 
@@ -58,7 +58,7 @@ If `version` field is missing, "1.0", or "2.0":
 
 ### Step 1.5: Load State and Show Resumption Context
 
-Run: `bash .aether/aether-utils.sh load-state`
+Run: `aether load-state`
 
 If successful and goal is not null:
 1. Extract current_phase from state
@@ -76,7 +76,7 @@ If successful and goal is not null:
    - Read .aether/HANDOFF.md content for additional context
    - Remove .aether/HANDOFF.md after displaying (cleanup)
 
-Run: `bash .aether/aether-utils.sh unload-state` to release lock.
+Run: `aether unload-state` to release lock.
 
 ### Step 2: Compute Summary
 
@@ -137,7 +137,7 @@ Read `.aether/data/constraints.json` if exists:
 - Constraints count: `constraints.length`
 
 **Flags:**
-Run: `bash .aether/aether-utils.sh flag-check-blockers`
+Run: `aether flag-check-blockers`
 Extract:
 - Blockers count (critical, block advancement)
 - Issues count (high, warnings)
@@ -148,7 +148,7 @@ Count escalated flags by checking for blocker flags with source "escalation":
 
 Run:
 ```bash
-escalated_count=$(bash .aether/aether-utils.sh flag-list --type blocker 2>/dev/null | jq '[.result.flags[] | select(.source == "escalation")] | length' 2>/dev/null || echo "0")
+escalated_count=$(aether flag-list --type blocker --json 2>/dev/null | jq '[.result.flags[] | select(.source == "escalation")] | length' 2>/dev/null || echo "0")
 echo "escalated_count=$escalated_count"
 ```
 
@@ -167,7 +167,7 @@ From `memory.instincts`:
 
 ### Step 2.6: Detect Milestone
 
-Run: `bash .aether/aether-utils.sh milestone-detect`
+Run: `aether milestone-detect`
 
 Extract from JSON result:
 - `milestone`: Current milestone name
@@ -179,7 +179,7 @@ Extract from JSON result:
 
 Run:
 ```bash
-bash .aether/aether-utils.sh memory-metrics
+aether memory-metrics
 ```
 
 Extract from JSON result:
@@ -213,8 +213,8 @@ else
 fi
 
 # Generate progress bars
-phase_bar=$(bash .aether/aether-utils.sh generate-progress-bar "$current_phase" "$total_phases" 20)
-task_bar=$(bash .aether/aether-utils.sh generate-progress-bar "$tasks_completed" "$tasks_total" 20)
+phase_bar=$(aether generate-progress-bar "$current_phase" "$total_phases" 20)
+task_bar=$(aether generate-progress-bar "$tasks_completed" "$tasks_total" 20)
 
 echo "phase_bar=$phase_bar"
 echo "task_bar=$task_bar"
@@ -301,7 +301,7 @@ state=$(jq -r '.state // "IDLE"' .aether/data/COLONY_STATE.json)
 current_phase=$(jq -r '.current_phase // 0' .aether/data/COLONY_STATE.json)
 total_phases=$(jq -r '.plan.phases | length' .aether/data/COLONY_STATE.json)
 
-bash .aether/aether-utils.sh print-next-up "$state" "$current_phase" "$total_phases"
+aether print-next-up
 ```
 
 This auto-generates state-based recommendations (IDLE → init, READY → build, EXECUTING → continue, PLANNING → plan).

package/.opencode/commands/ant/tunnels.md

@@ -32,7 +32,7 @@ Stop here.
 
 ### Step 2: List All Chambers
 
-Run: `bash .aether/aether-utils.sh chamber-list`
+Run: `aether chamber-list`
 
 Parse JSON result into array of chambers.
 
@@ -95,7 +95,7 @@ Run /ant:tunnels to return to chamber list.
 ```
 
 To get the counts and hash status:
-- Run `bash .aether/aether-utils.sh chamber-verify .aether/chambers/{chamber_name}`
+- Run `aether chamber-verify --path .aether/chambers/{chamber_name}`
 - If verified: hash_status = "✅"
 - If not verified: hash_status = "⚠️ hash mismatch"
 - If error: hash_status = "⚠️ error"
@@ -338,7 +338,7 @@ Pass the extracted pheromone-only temp file (NOT the combined `colony-archive.xm
 # Import the EXTRACTED pheromone-only XML (NOT the combined colony-archive.xml)
 # $import_tmp_pheromones has <pheromones> as root — the format pheromone-import-xml expects
 # Second argument triggers prefix-tagging — imported signal IDs become "{source_colony}:original_id"
-import_result=$(bash .aether/aether-utils.sh pheromone-import-xml "$import_tmp_pheromones" "$source_colony" 2>&1)
+import_result=$(aether pheromone-import-xml --input "$import_tmp_pheromones" --colony "$source_colony" 2>&1)
 import_ok=$(echo "$import_result" | jq -r '.ok // false' 2>/dev/null)
 
 if [[ "$import_ok" == "true" ]]; then

package/.opencode/commands/ant/verify-castes.md

@@ -69,7 +69,7 @@ Caste slots come from agent frontmatter (`model:` field).
 
 
 
-Run using Bash tool: `bash .aether/aether-utils.sh version-check 2>/dev/null || echo "Utils available"`
+Run using Bash tool: `aether version-check-cached 2>/dev/null || echo "Utils available"`
 
 
 Check LiteLLM proxy status:

package/.opencode/commands/ant/watch.md

@@ -183,21 +183,21 @@ Attaching now...
 Workers and commands update watch files as they work:
 
 ### Activity Log
-Workers write via: `bash .aether/aether-utils.sh activity-log "ACTION" "caste" "description"`
+Workers write via: `aether activity-log "ACTION" "caste" "description"`
 
 For named ants (recommended):
 ```bash
 # Generate a name first
-ant_name=$(bash .aether/aether-utils.sh generate-ant-name "builder" | jq -r '.result')
+ant_name=$(aether generate-ant-name --caste "builder" | jq -r '.result')
 # Log with ant name
-bash .aether/aether-utils.sh activity-log "CREATED" "$ant_name (Builder)" "Implemented auth module"
+aether activity-log "CREATED" "$ant_name (Builder)" "Implemented auth module"
 ```
 
 ### Spawn Tracking
 Log spawns for tree visualization:
 ```bash
-bash .aether/aether-utils.sh spawn-log "Prime" "builder" "Hammer-42" "implementing auth"
-bash .aether/aether-utils.sh spawn-complete "Hammer-42" "completed" "auth module done"
+aether spawn-log --name "Prime" --caste "builder" --id "Hammer-42" --description "implementing auth"
+aether spawn-complete --id "Hammer-42" --status "completed" --summary "auth module done"
 ```
 
 ### Status File
@@ -208,11 +208,11 @@ Commands update `.aether/data/watch-status.txt` with current state:
 - Last Activity: most recent log entry
 
 ### Progress File
-Update via: `bash .aether/aether-utils.sh update-progress <percent> "<message>" <phase> <total>`
+Update via: `aether update-progress <percent> "<message>" <phase> <total>`
 
 Example:
 ```bash
-bash .aether/aether-utils.sh update-progress 45 "Building auth module..." 2 5
+aether update-progress 45 "Building auth module..." 2 5
 ```
 
 ---

package/CHANGELOG.md

@@ -690,3 +690,86 @@ The following entries are automatically generated by the colony during work phas
 - **Files:** `aether-utils.sh`, `utils/hive.sh`, `utils/learning.sh`, `tests/`
 - **Decisions:** Colony sealed at Crowned Anthill; hardened ~40 json_ok sites + checkpointing + hive null safety
 - **What Worked:** 5 phases completed; 9 instincts created; 4 hive-eligible
+
+## 2026-03-31
+
+### Phase 0 — Plan 01
+
+- **Files:** `build-complete.md`, `build.yaml`, `build.md`
+- **Decisions:** Add Stage Audit Gate to build orchestrators
+- **What Worked:** Pre-synthesis verification gate ensures all stages complete
+
+### Phase 3 — Plan 01
+
+- **What Worked:** lint:sync clean; lint clean; 524 tests pass
+
+### Phase 0 — Plan 00
+
+- **Files:** `build-complete.md`, `build.yaml`, `update-transaction.test.js`
+- **Decisions:** Colony sealed at Crowned Anthill; Enforce non-skippable build playbook execution and verify exchange fix
+- **What Worked:** 3 phases completed; Colony wisdom promoted to QUEEN.md
+
+### Phase 1 — Plan 01
+
+- **Files:** `build-complete.md`, `state-contract-design.md`
+- **Decisions:** Deleted wrong test file; Fixed step numbering; Added DATA_DIR exception clause
+- **What Worked:** Swarm parallel audit; Pre-existing quality issues logged
+
+## 2026-04-01
+
+### Phase 2 — Plan 01
+
+- **Files:** `trust-scoring.sh`, `event-bus.sh`, `aether-utils.sh`
+- **Decisions:** Stateless calculation module; JSONL event bus with file locking
+- **What Worked:** Parallel builders; Self-registration pattern
+
+### Phase 3 — Plan 01
+
+- **Files:** `instinct-store.sh`, `graph.sh`, `learning.sh`, `aether-utils.sh`
+- **Decisions:** Standalone instinct storage; jq graph traversal; Trust-scored observations
+- **What Worked:** Additive parallel modification
+
+### Phase 4 — Plan 01
+
+- **Files:** `nurse.sh`, `herald.sh`, `librarian.sh`, `critic.sh`, `sentinel.sh`, `janitor.sh`, `archivist.sh`, `scribe.sh`, `orchestrator.sh`
+- **Decisions:** 8 curation ants; curation-run orchestrator; Sentinel-first execution order
+- **What Worked:** Parallel core/ops builders; Orchestrator integration
+
+### Phase 5 — Plan 01
+
+- **Files:** `consolidation.sh`, `consolidation-seal.sh`, `test-e2e-pipeline.sh`
+- **Decisions:** Lightweight phase-end; Full seal consolidation; E2E integration test
+
+### Phase 6 — Plan 01
+
+- **Files:** `structural-learning-stack.md`, `CLAUDE.md`
+- **Decisions:** Architecture documentation; Updated component counts; Full test sweep
+
+### Phase 0 — Plan 00
+
+- **Files:** `trust-scoring.sh`, `event-bus.sh`, `instinct-store.sh`, `graph.sh`, `consolidation.sh`, `curation-ants`
+- **Decisions:** Colony sealed at Crowned Anthill; Structural Learning Stack complete
+- **What Worked:** 6 phases completed; Colony wisdom promoted to QUEEN.md
+
+### Phase 0 — Plan 01
+
+- **Files:** `go.mod`, `pkg/storage/storage.go`, `pkg/storage/storage_test.go`
+- **Decisions:** Go module at github.com/aether-colony/aether; atomic writes via temp+rename; per-path RWMutex for concurrent safety
+- **What Worked:** Parallel builders for independent packages; TDD with race detector
+- **Requirements:** go build, test, vet pass;91.2% coverage;524 npm tests unaffected addressed
+
+### Phase 0 — Plan 02
+
+- **Files:** `.aether/utils/trust-scoring.sh`, `.aether/utils/event-bus.sh`
+
+### Phase 3 — Plan 03
+
+- **Files:** `learning.sh`, `instinct-store.sh`, `graph.sh`, `test-instinct-store.sh`
+- **Decisions:** Standalone instinct storage; Backward-compatible trust score migration; jq graph layer for instinct relationships
+- **What Worked:** Trust score integration with learning-observe; Full instinct schema with provenance; Graph link/neighbors/reach/cluster
+
+### Phase 0 — Plan 00
+
+- **Files:** `learning.sh`, `instinct-store.sh`, `graph.sh`, `test-instinct-store.sh`, `trust-scoring.sh`, `event-bus.sh`
+- **Decisions:** Colony sealed at Crowned Anthill; Structural Learning Stack verified
+- **What Worked:** 3 phases completed; Colony wisdom promoted to QUEEN.md

package/README.md

@@ -8,11 +8,20 @@
 
 <br>
 
-[![npm](https://img.shields.io/npm/v/aether-colony?style=for-the-badge&logo=npm&logoColor=white&label=npm&color=7B3FE4)](https://www.npmjs.com/package/aether-colony)
-[![downloads](https://img.shields.io/npm/dw/aether-colony?style=for-the-badge&logo=npm&logoColor=white&color=333333)](https://www.npmjs.com/package/aether-colony)
-[![license](https://img.shields.io/github/license/calcosmic/Aether?style=for-the-badge&color=333333)](LICENSE)
-[![stars](https://img.shields.io/github/stars/calcosmic/Aether?style=for-the-badge&logo=github&logoColor=white&color=333333)](https://github.com/calcosmic/Aether/stargazers)
-[![sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-ea4aaa?style=for-the-badge&logo=github-sponsors&logoColor=white)](https://github.com/sponsors/calcosmic)
+[![npm version](https://img.shields.io/npm/v/aether-colony.svg?style=flat-square)](https://www.npmjs.com/package/aether-colony?utm_source=github&utm_medium=readme&utm_campaign=aether)
+[![npm downloads](https://img.shields.io/npm/dw/aether-colony.svg?style=flat-square)](https://www.npmjs.com/package/aether-colony?utm_source=github&utm_medium=readme&utm_campaign=aether)
+[![License: MIT](https://img.shields.io/github/license/calcosmic/Aether.svg?style=flat-square)](LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/calcosmic/Aether.svg?style=flat-square)](https://github.com/calcosmic/Aether/stargazers)
+[![Sponsor](https://img.shields.io/badge/Sponsor-GitHub-%23ea4aaa.svg?style=flat-square&logo=github)](https://github.com/sponsors/calcosmic?utm_source=github&utm_medium=readme&utm_campaign=aether)
+
+[![weekly downloads](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/calcosmic/Aether/main/docs/badges/weekly-downloads.json&style=flat-square)](https://www.npmjs.com/package/aether-colony?utm_source=github&utm_medium=readme&utm_campaign=aether)
+[![monthly downloads](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/calcosmic/Aether/main/docs/badges/monthly-downloads.json&style=flat-square)](https://www.npmjs.com/package/aether-colony?utm_source=github&utm_medium=readme&utm_campaign=aether)
+[![total downloads](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/calcosmic/Aether/main/docs/badges/total-downloads.json&style=flat-square)](https://www.npmjs.com/package/aether-colony?utm_source=github&utm_medium=readme&utm_campaign=aether)
+[![bundle size](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/calcosmic/Aether/main/docs/badges/bundle-size.json&style=flat-square)](https://www.npmjs.com/package/aether-colony?utm_source=github&utm_medium=readme&utm_campaign=aether)
+![test count](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/calcosmic/Aether/main/docs/badges/test-count.json&style=flat-square)
+![commands](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/calcosmic/Aether/main/docs/badges/commands.json&style=flat-square)
+![agents](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/calcosmic/Aether/main/docs/badges/agents.json&style=flat-square)
+[![colony version](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/calcosmic/Aether/main/docs/badges/colony-version.json&style=flat-square)](https://github.com/calcosmic/Aether/releases)
 
 <br>
 
@@ -24,6 +33,10 @@ $ npx aether-colony
 
 *The whole is greater than the sum of its ants.* 🐜
 
+<br>
+
+[![🐜 aetherantcolony.com](https://img.shields.io/badge/%F0%9F%90%9C_aetherantcolony.com-7B3FE4?style=for-the-badge&logoColor=white)](https://aetherantcolony.com?utm_source=github&utm_medium=readme&utm_campaign=aether)
+
 </div>
 
 ---
@@ -215,14 +228,14 @@ Five commands from zero to shipped.
 
 ## Works With
 
-- **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** — 45 slash commands + 24 agent definitions
-- **[OpenCode](https://github.com/opencode-ai/opencode)** — 45 slash commands + agent definitions
+- **[Claude Code](https://docs.anthropic.com/en/docs/claude-code?utm_source=github&utm_medium=readme&utm_campaign=aether)** — 45 slash commands + 24 agent definitions
+- **[OpenCode](https://github.com/opencode-ai/opencode?utm_source=github&utm_medium=readme&utm_campaign=aether)** — 45 slash commands + agent definitions
 
 ## Support
 
 If Aether has been useful to you:
 
-**[Sponsor on GitHub](https://github.com/sponsors/calcosmic)**
+**[Sponsor on GitHub](https://github.com/sponsors/calcosmic?utm_source=github&utm_medium=readme&utm_campaign=aether)**
 
 <details>
 <summary>Crypto</summary>
@@ -234,7 +247,7 @@ If Aether has been useful to you:
 
 </details>
 
-[PayPal](https://www.paypal.com/ncp/payment/RENG7ZMW5F59L) · [Buy Me a Coffee](https://buymeacoffee.com/music5y)
+[PayPal](https://www.paypal.com/ncp/payment/RENG7ZMW5F59L?utm_source=github&utm_medium=readme&utm_campaign=aether) · [Buy Me a Coffee](https://buymeacoffee.com/music5y?utm_source=github&utm_medium=readme&utm_campaign=aether)
 
 ## License