aether-colony 3.1.17 → 5.0.0

package/runtime/planning.md

@@ -1,159 +0,0 @@
-# Planning Discipline
-
-## Purpose
-
-Write comprehensive implementation plans with bite-sized tasks, assuming workers have zero context. Each task should be one action (2-5 minutes of work).
-
-## Core Principles
-
-- **DRY** - Don't Repeat Yourself
-- **YAGNI** - You Aren't Gonna Need It
-- **TDD** - Test-Driven Development (test first, always)
-- **Frequent Commits** - One commit per feature/fix
-
-## Bite-Sized Task Granularity
-
-**Each step is ONE action:**
-
-```
-"Write the failing test" - step
-"Run it to make sure it fails" - step
-"Implement the minimal code to make the test pass" - step
-"Run the tests and make sure they pass" - step
-"Commit" - step
-```
-
-**NOT acceptable:**
-- "Implement authentication with tests" (too big)
-- "Add validation" (too vague)
-- "Set up the project" (needs breakdown)
-
-## Task Structure
-
-Each task should include:
-
-### 1. Files Section
-
-```markdown
-**Files:**
-- Create: `exact/path/to/file.py`
-- Modify: `exact/path/to/existing.py:123-145`
-- Test: `tests/exact/path/to/test.py`
-```
-
-Always use exact paths. No "somewhere in src/" ambiguity.
-
-### 2. Steps with TDD Flow
-
-```markdown
-**Step 1: Write the failing test**
-
-\`\`\`python
-def test_specific_behavior():
-    result = function(input)
-    assert result == expected
-\`\`\`
-
-**Step 2: Run test to verify it fails**
-
-Run: `pytest tests/path/test.py::test_name -v`
-Expected: FAIL with "function not defined"
-
-**Step 3: Write minimal implementation**
-
-\`\`\`python
-def function(input):
-    return expected
-\`\`\`
-
-**Step 4: Run test to verify it passes**
-
-Run: `pytest tests/path/test.py::test_name -v`
-Expected: PASS
-
-**Step 5: Commit**
-
-\`\`\`bash
-git add tests/path/test.py src/path/file.py
-git commit -m "feat: add specific feature"
-\`\`\`
-```
-
-### 3. Expected Output
-
-For every command, specify expected output:
-
-```markdown
-Run: `npm test`
-Expected: 47 passing, 0 failing
-```
-
-Not just "run tests" - specify what success looks like.
-
-## Phase Structure
-
-```markdown
-### Phase N: [Component Name]
-
-**Goal:** [One sentence describing what this phase achieves]
-
-**Dependencies:** [What must exist before this phase]
-
-**Tasks:**
-
-#### Task N.1: [Specific action]
-
-**Files:**
-- Create: `src/components/Button.tsx`
-- Test: `tests/components/Button.test.tsx`
-
-**Steps:**
-(TDD steps as above)
-
-**Success Criteria:**
-- Tests pass for Button component
-- Component renders without errors
-```
-
-## Quality Checks
-
-Before a plan is complete, verify:
-
-1. **Exact paths** - Every file reference is complete path
-2. **Complete code** - No "add appropriate code" placeholders
-3. **Expected outputs** - Every command has expected result
-4. **TDD flow** - Test before implementation for each feature
-5. **No assumptions** - Worker could execute with zero context
-6. **Commit points** - Clear where to commit
-
-## Integration with Colony
-
-The Route-Setter Ant follows this discipline when generating plans.
-
-Each task in `plan.phases[N].tasks` should be:
-- Executable in 2-5 minutes
-- Self-contained with file paths
-- Verifiable with specific success criteria
-
-## Red Flags
-
-**Never in a plan:**
-- "Add tests" (which tests? for what?)
-- "Implement feature" (what specifically?)
-- "Update file" (which file? what changes?)
-- "Handle edge cases" (which cases?)
-
-**Always in a plan:**
-- Exact file paths
-- Complete code snippets
-- Exact commands to run
-- Expected outputs/results
-- One action per step
-
-## Why This Matters
-
-- Workers can execute without asking questions
-- Progress is measurable (step by step)
-- Debugging is easier (clear steps to trace)
-- Commits are atomic and meaningful
-- Quality is built in (TDD from start)

package/runtime/recover.sh

@@ -1,136 +0,0 @@
-#!/bin/bash
-# Aether v3.1 Recovery Script
-# Run this after reading RECOVERY-PLAN.md
-
-set -e
-
-echo "╔══════════════════════════════════════════════════════════════╗"
-echo "║     AETHER v3.1 RECOVERY - RUNNING SYNC                      ║"
-echo "╚══════════════════════════════════════════════════════════════╝"
-echo ""
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m' # No Color
-
-# Step 1: Check if we're in the right place
-if [ ! -f "package.json" ] || [ ! -d ".aether" ] || [ ! -d "runtime" ]; then
-    echo -e "${RED}ERROR: Must run from Aether repo root${NC}"
-    exit 1
-fi
-
-# Step 2: Commit any staged changes
-echo "Step 1: Checking git status..."
-if ! git diff --cached --quiet; then
-    echo "Found staged changes. Committing..."
-    git commit -m "recovery: staged changes before sync"
-fi
-
-# Step 3: Sync runtime/ from .aether/
-echo ""
-echo "Step 2: Syncing runtime/ from .aether/..."
-echo "------------------------------------------"
-
-# Core files
-echo "  → workers.md"
-cp .aether/workers.md runtime/workers.md
-
-echo "  → aether-utils.sh"
-cp .aether/aether-utils.sh runtime/aether-utils.sh
-
-echo "  → verification-loop.md"
-cp .aether/verification-loop.md runtime/verification-loop.md 2>/dev/null || echo "    (skipped - not in .aether)"
-
-# Utils - sync all files
-echo ""
-echo "  → utilities/"
-for file in .aether/utils/*.sh; do
-    if [ -f "$file" ]; then
-        filename=$(basename "$file")
-        echo "     copying $filename"
-        cp "$file" "runtime/utils/$filename"
-    fi
-done
-
-# Docs - ensure runtime/docs/ exists and has files
-if [ -d ".aether/docs" ]; then
-    echo ""
-    echo "  → docs/"
-    mkdir -p runtime/docs
-    for file in .aether/docs/*.md .aether/docs/*.json 2>/dev/null; do
-        if [ -f "$file" ]; then
-            filename=$(basename "$file")
-            echo "     copying $filename"
-            cp "$file" "runtime/docs/$filename"
-        fi
-    done
-fi
-
-# Step 4: Verify the sync
-echo ""
-echo "Step 3: Verifying sync..."
-echo "------------------------------------------"
-
-# Check emoji section
-if grep -q "Caste Emoji Mapping:" runtime/workers.md; then
-    echo -e "${GREEN}  ✓ workers.md has emoji section${NC}"
-else
-    echo -e "${RED}  ✗ workers.md MISSING emoji section${NC}"
-fi
-
-# Check get_caste_emoji
-if grep -q "get_caste_emoji()" runtime/aether-utils.sh; then
-    echo -e "${GREEN}  ✓ aether-utils.sh has get_caste_emoji${NC}"
-else
-    echo -e "${RED}  ✗ aether-utils.sh MISSING get_caste_emoji${NC}"
-fi
-
-# Count utils files
-RUNTIME_UTILS=$(ls runtime/utils/*.sh 2>/dev/null | wc -l)
-AETHER_UTILS=$(ls .aether/utils/*.sh 2>/dev/null | wc -l)
-echo "  → runtime/utils: $RUNTIME_UTILS files"
-echo "  → .aether/utils: $AETHER_UTILS files"
-
-if [ "$RUNTIME_UTILS" -eq "$AETHER_UTILS" ]; then
-    echo -e "${GREEN}  ✓ Utils counts match${NC}"
-else
-    echo -e "${YELLOW}  ⚠ Utils counts differ (may be okay if some are .aether-specific)${NC}"
-fi
-
-# Step 5: Stage the changes
-echo ""
-echo "Step 4: Staging changes..."
-git add runtime/
-
-# Show status
-echo ""
-echo "Git status after sync:"
-git status --short runtime/
-
-# Step 6: Instructions
-echo ""
-echo "╔══════════════════════════════════════════════════════════════╗"
-echo "║     RECOVERY SYNC COMPLETE                                   ║"
-echo "╚══════════════════════════════════════════════════════════════╝"
-echo ""
-echo "Next steps:"
-echo ""
-echo "  1. Review the changes:"
-echo "     git diff --cached runtime/"
-echo ""
-echo "  2. Commit the sync:"
-echo "     git commit -m 'sync: runtime/ updated from working .aether/'"
-echo ""
-echo "  3. Reinstall to update hub:"
-echo "     npm install -g ."
-echo ""
-echo "  4. Verify hub updated:"
-echo "     grep 'Caste Emoji Mapping:' ~/.aether/system/workers.md"
-echo ""
-echo "  5. Test in this repo:"
-echo "     /ant:init 'Test recovery'"
-echo ""
-echo "Remember: .aether/ is the SOURCE OF TRUTH. runtime/ is auto-populated by bin/sync-to-runtime.sh"
-echo ""