Merge branch 'main' into fix/912

config/zero_touch_forge.json

@@ -0,0 +1,54 @@
+{
+  "epic_issue": 912,
+  "title": "The Zero-Touch Forge: Bare-Metal Fleet Bootstrap in 60 Minutes",
+  "checks": [
+    {
+      "id": "os_bootstrap",
+      "label": "OS bootstrap foothold",
+      "required_files": ["scripts/provision-runner.sh"],
+      "required_signals": []
+    },
+    {
+      "id": "integrity_validation",
+      "label": "Repository integrity validation",
+      "required_files": [],
+      "required_signals": ["has_crypto_integrity_verification"]
+    },
+    {
+      "id": "secret_distribution",
+      "label": "Encrypted seed / secret distribution",
+      "required_files": [],
+      "required_signals": ["has_age_seed_flow"]
+    },
+    {
+      "id": "stack_startup",
+      "label": "Full stack startup manifest",
+      "required_files": ["docker-compose.yml", "fleet/fleet-routing.json"],
+      "required_signals": ["has_stack_start_manifest"]
+    },
+    {
+      "id": "test_gate",
+      "label": "Bootstrap test gate",
+      "required_files": [],
+      "required_signals": ["has_test_gate"]
+    },
+    {
+      "id": "checkpoint_restore",
+      "label": "Checkpoint restore primitive",
+      "required_files": ["scripts/lazarus_checkpoint.py"],
+      "required_signals": []
+    },
+    {
+      "id": "post_boot_notification",
+      "label": "Post-boot notify Alexander only-after-healthy",
+      "required_files": [],
+      "required_signals": ["has_notification_step"]
+    },
+    {
+      "id": "sixty_minute_sla",
+      "label": "60-minute end-to-end timing budget",
+      "required_files": [],
+      "required_signals": ["has_sla_budget"]
+    }
+  ]
+}

docs/zero-touch-forge-readiness.md

@@ -0,0 +1,51 @@
+# Zero-Touch Forge Readiness
+
+Epic: #912 — The Zero-Touch Forge: Bare-Metal Fleet Bootstrap in 60 Minutes
+
+## Impossible Goal
+
+Take a raw VPS plus only a git URL and encrypted seed, then bootstrap a full Timmy Foundation fleet in under 60 minutes with no human intervention after trigger.
+
+This document does **not** claim the goal is solved. It grounds the epic in the current repo state.
+
+Current primitive readiness: 2 ready / 6 blocked.
+
+## Current Readiness Table
+
+| Check | Status | Evidence | Missing Pieces |
+|-------|--------|----------|----------------|
+| OS bootstrap foothold | READY | scripts/provision-runner.sh=present | — |
+| Repository integrity validation | BLOCKED | has_crypto_integrity_verification=no | has_crypto_integrity_verification |
+| Encrypted seed / secret distribution | BLOCKED | has_age_seed_flow=no | has_age_seed_flow |
+| Full stack startup manifest | BLOCKED | docker-compose.yml=present, fleet/fleet-routing.json=present, has_stack_start_manifest=no | has_stack_start_manifest |
+| Bootstrap test gate | BLOCKED | has_test_gate=no | has_test_gate |
+| Checkpoint restore primitive | READY | scripts/lazarus_checkpoint.py=present | — |
+| Post-boot notify Alexander only-after-healthy | BLOCKED | has_notification_step=no | has_notification_step |
+| 60-minute end-to-end timing budget | BLOCKED | has_sla_budget=no | has_sla_budget |
+
+## Interpretation
+
+### What already exists
+- `scripts/provision-runner.sh` proves we already automate part of bare-metal service bootstrap.
+- `scripts/lazarus_checkpoint.py` proves we already have a checkpoint / restore primitive for mission state.
+- `docker-compose.yml`, `fleet/fleet-routing.json`, `operations/fleet-topology.md`, and `config/fleet_agents.json` show a real fleet shape, not just a philosophical wish.
+
+### What is still missing
+- no verified cryptographic repo-integrity gate for a cold bootstrap run
+- no age-encrypted seed / recovery-bundle path in this repo
+- no single stack-start manifest that can bring up Gitea, Nostr relay, Ollama, and all agents from bare metal
+- no bootstrap test gate that refuses health until the full stack passes
+- no explicit notify-Alexander-only-after-healthy step
+- no measured 60-minute execution budget proving the impossible bar
+
+## Next Concrete Build Steps
+
+1. Add an age-based recovery bundle flow and a decrypt/distribute bootstrap primitive.
+2. Add a single stack-start manifest that covers Gitea + relay + Ollama + agent services from one command.
+3. Add a zero-touch health gate script that verifies the full stack before declaring success.
+4. Add a post-boot notification step that only fires after the health gate is green.
+5. Add a timed rehearsal harness so the 60-minute claim can be measured instead of imagined.
+
+## Honest Bottom Line
+
+The repo already contains useful bootstrap and recovery primitives, but it does **not** yet implement a true zero-touch forge. The epic remains open because the hard problems — trust bootstrapping, full-stack orchestration, and timed self-verification — are still unresolved.

js/spatial-search.js

@@ -1,317 +0,0 @@
-// ═══════════════════════════════════════════════════════════════
-// SPATIAL SEARCH — Find nearest user/object by name
-// ═══════════════════════════════════════════════════════════════
-//
-// Search for users/objects by name with distance and direction.
-// Provides autocomplete, pathfinding arrow, and keyboard shortcuts.
-//
-// Usage:
-//   const search = new SpatialSearch({ maxDistance: 1000 });
-//   search.registerEntity('id', { name, type, position });
-//   const results = search.searchEntities('query');
-// ═══════════════════════════════════════════════════════════════
-
-class SpatialSearch {
-  constructor(options = {}) {
-    this.maxDistance = options.maxDistance || 1000;
-    this.onResultSelect = options.onResultSelect || null;
-    this.entities = new Map();
-    this.selectedIndex = -1;
-    this.results = [];
-    this.isOpen = false;
-    this._initUI();
-    this._bindKeys();
-  }
-
-  // ─── Entity Management ─────────────────────────────────
-  
-  registerEntity(id, { name, type = 'object', position }) {
-    this.entities.set(id, {
-      id,
-      name: name.toLowerCase(),
-      displayName: name,
-      type,
-      position: { ...position }
-    });
-  }
-
-  unregisterEntity(id) {
-    this.entities.delete(id);
-  }
-
-  updateEntityPosition(id, position) {
-    const entity = this.entities.get(id);
-    if (entity) {
-      entity.position = { ...position };
-    }
-  }
-
-  // ─── Search ────────────────────────────────────────────
-
-  searchEntities(query, cameraPosition = null) {
-    if (!query || query.length < 1) {
-      this.results = [];
-      this._renderResults();
-      return [];
-    }
-
-    const q = query.toLowerCase();
-    const results = [];
-
-    for (const [id, entity] of this.entities) {
-      if (!entity.name.includes(q)) continue;
-
-      let distance = 0;
-      let direction = '';
-
-      if (cameraPosition) {
-        distance = this._calculateDistance(cameraPosition, entity.position);
-        if (distance > this.maxDistance) continue;
-        direction = this._calculateDirection(cameraPosition, entity.position);
-      }
-
-      results.push({
-        id,
-        name: entity.displayName,
-        type: entity.type,
-        distance: Math.round(distance * 10) / 10,
-        direction,
-        position: entity.position
-      });
-    }
-
-    // Sort by distance
-    results.sort((a, b) => a.distance - b.distance);
-    
-    this.results = results.slice(0, 10); // Limit to 10 results
-    this.selectedIndex = this.results.length > 0 ? 0 : -1;
-    this._renderResults();
-    
-    return this.results;
-  }
-
-  selectResult(index) {
-    if (index < 0 || index >= this.results.length) return;
-    
-    this.selectedIndex = index;
-    this._renderResults();
-    
-    const result = this.results[index];
-    if (result && this.onResultSelect) {
-      this.onResultSelect(result);
-    }
-    
-    this.close();
-  }
-
-  // ─── Distance & Direction ──────────────────────────────
-
-  _calculateDistance(from, to) {
-    const dx = to.x - from.x;
-    const dy = to.y - from.y;
-    const dz = to.z - from.z;
-    return Math.sqrt(dx * dx + dy * dy + dz * dz);
-  }
-
-  _calculateDirection(from, to) {
-    const dx = to.x - from.x;
-    const dz = to.z - from.z;
-    const angle = Math.atan2(dx, dz) * (180 / Math.PI);
-    
-    // Convert to compass direction
-    if (angle >= -22.5 && angle < 22.5) return 'N';
-    if (angle >= 22.5 && angle < 67.5) return 'NE';
-    if (angle >= 67.5 && angle < 112.5) return 'E';
-    if (angle >= 112.5 && angle < 157.5) return 'SE';
-    if (angle >= 157.5 || angle < -157.5) return 'S';
-    if (angle >= -157.5 && angle < -112.5) return 'SW';
-    if (angle >= -112.5 && angle < -67.5) return 'W';
-    if (angle >= -67.5 && angle < -22.5) return 'NW';
-    return 'N';
-  }
-
-  // ─── UI ────────────────────────────────────────────────
-
-  _initUI() {
-    // Search container
-    this.container = document.createElement('div');
-    this.container.id = 'spatial-search';
-    this.container.className = 'spatial-search';
-    this.container.style.display = 'none';
-    
-    // Input
-    this.input = document.createElement('input');
-    this.input.type = 'text';
-    this.input.className = 'spatial-search-input';
-    this.input.placeholder = 'Search by name... (Ctrl+F)';
-    this.input.addEventListener('input', () => this._onInput());
-    this.input.addEventListener('keydown', (e) => this._onKeyDown(e));
-    
-    // Results dropdown
-    this.dropdown = document.createElement('div');
-    this.dropdown.className = 'spatial-search-dropdown';
-    
-    // Path arrow
-    this.arrow = document.createElement('div');
-    this.arrow.className = 'spatial-search-arrow';
-    this.arrow.style.display = 'none';
-    this.arrow.innerHTML = '<span class="arrow-icon">➤</span><span class="arrow-info"></span>';
-    
-    this.container.appendChild(this.input);
-    this.container.appendChild(this.dropdown);
-    
-    document.body.appendChild(this.container);
-    document.body.appendChild(this.arrow);
-  }
-
-  _bindKeys() {
-    document.addEventListener('keydown', (e) => {
-      // Ctrl+F or Cmd+F to toggle
-      if ((e.ctrlKey || e.metaKey) && e.key === 'f') {
-        e.preventDefault();
-        this.toggle();
-        return;
-      }
-      
-      // Escape to close
-      if (e.key === 'Escape' && this.isOpen) {
-        e.preventDefault();
-        this.close();
-        return;
-      }
-    });
-  }
-
-  _onInput() {
-    const query = this.input.value;
-    // Get camera position if available
-    const cameraPos = window.camera ? {
-      x: window.camera.position.x,
-      y: window.camera.position.y,
-      z: window.camera.position.z
-    } : null;
-    
-    this.searchEntities(query, cameraPos);
-  }
-
-  _onKeyDown(e) {
-    if (!this.isOpen || this.results.length === 0) return;
-    
-    switch (e.key) {
-      case 'ArrowDown':
-        e.preventDefault();
-        this.selectedIndex = Math.min(this.selectedIndex + 1, this.results.length - 1);
-        this._renderResults();
-        break;
-      case 'ArrowUp':
-        e.preventDefault();
-        this.selectedIndex = Math.max(this.selectedIndex - 1, 0);
-        this._renderResults();
-        break;
-      case 'Enter':
-        e.preventDefault();
-        if (this.selectedIndex >= 0) {
-          this.selectResult(this.selectedIndex);
-        }
-        break;
-    }
-  }
-
-  _renderResults() {
-    this.dropdown.innerHTML = '';
-    
-    if (this.results.length === 0) {
-      if (this.input.value) {
-        this.dropdown.innerHTML = '<div class="spatial-search-empty">No results found</div>';
-      }
-      return;
-    }
-    
-    this.results.forEach((result, index) => {
-      const item = document.createElement('div');
-      item.className = `spatial-search-item ${index === this.selectedIndex ? 'selected' : ''}`;
-      item.innerHTML = `
-        <span class="item-name">${this._escapeHtml(result.name)}</span>
-        <span class="item-type">${result.type}</span>
-        <span class="item-distance">${result.distance}m ${result.direction}</span>
-      `;
-      item.addEventListener('click', () => this.selectResult(index));
-      this.dropdown.appendChild(item);
-    });
-  }
-
-  _updateArrow(result) {
-    if (!result) {
-      this.arrow.style.display = 'none';
-      return;
-    }
-    
-    this.arrow.style.display = 'flex';
-    const info = this.arrow.querySelector('.arrow-info');
-    if (info) {
-      info.textContent = `${result.name} — ${result.distance}m ${result.direction}`;
-    }
-    
-    // Rotate arrow based on direction
-    const rotations = {
-      'N': 0, 'NE': 45, 'E': 90, 'SE': 135,
-      'S': 180, 'SW': 225, 'W': 270, 'NW': 315
-    };
-    const arrowIcon = this.arrow.querySelector('.arrow-icon');
-    if (arrowIcon) {
-      arrowIcon.style.transform = `rotate(${rotations[result.direction] || 0}deg)`;
-    }
-  }
-
-  _escapeHtml(str) {
-    const div = document.createElement('div');
-    div.textContent = str;
-    return div.innerHTML;
-  }
-
-  // ─── Public API ────────────────────────────────────────
-
-  open() {
-    this.isOpen = true;
-    this.container.style.display = 'flex';
-    this.input.focus();
-    this.input.value = '';
-    this.results = [];
-    this._renderResults();
-  }
-
-  close() {
-    this.isOpen = false;
-    this.container.style.display = 'none';
-    this.input.blur();
-    this.selectedIndex = -1;
-    this._updateArrow(null);
-  }
-
-  toggle() {
-    if (this.isOpen) {
-      this.close();
-    } else {
-      this.open();
-    }
-  }
-
-  getStatus() {
-    return {
-      entityCount: this.entities.size,
-      isOpen: this.isOpen,
-      resultCount: this.results.length,
-      selectedIndex: this.selectedIndex
-    };
-  }
-}
-
-// Export for module systems
-if (typeof module !== 'undefined' && module.exports) {
-  module.exports = SpatialSearch;
-}
-
-// Make available globally
-if (typeof window !== 'undefined') {
-  window.SpatialSearch = SpatialSearch;
-}

scripts/zero_touch_forge_readiness.py

@@ -0,0 +1,187 @@
+#!/usr/bin/env python3
+"""Zero-Touch Forge readiness grounding for epic #912.
+
+This does not pretend the impossible goal is solved.
+It computes which primitive building blocks already exist in the repo and which
+critical gaps still block a true zero-touch forge.
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+from typing import Any
+
+REPO_ROOT = Path(__file__).resolve().parent.parent
+SPEC_PATH = REPO_ROOT / "config" / "zero_touch_forge.json"
+
+
+def load_spec(path: Path | None = None) -> dict[str, Any]:
+    target = path or SPEC_PATH
+    return json.loads(target.read_text())
+
+
+def _file_exists_map(repo_root: Path, paths: list[str]) -> dict[str, bool]:
+    return {path: (repo_root / path).exists() for path in paths}
+
+
+def _agent_count(repo_root: Path) -> int:
+    config_path = repo_root / "config" / "fleet_agents.json"
+    if not config_path.exists():
+        return 0
+    try:
+        payload = json.loads(config_path.read_text())
+        return len(payload.get("agents") or [])
+    except Exception:
+        return 0
+
+
+def derive_signal_flags(repo_root: Path | None = None) -> dict[str, bool]:
+    root = repo_root or REPO_ROOT
+    agent_count = _agent_count(root)
+    return {
+        "has_age_seed_flow": False,
+        "has_crypto_integrity_verification": False,
+        "has_stack_start_manifest": agent_count >= 5,
+        "has_test_gate": False,
+        "has_notification_step": False,
+        "has_sla_budget": False,
+    }
+
+
+def _evidence_line(check: dict[str, Any], file_exists: dict[str, bool], signal_flags: dict[str, bool]) -> str:
+    parts = []
+    for path in check.get("required_files", []):
+        parts.append(f"{path}={'present' if file_exists.get(path) else 'missing'}")
+    for key in check.get("required_signals", []):
+        parts.append(f"{key}={'yes' if signal_flags.get(key) else 'no'}")
+    return ", ".join(parts) if parts else "no explicit evidence"
+
+
+def evaluate_readiness(
+    spec: dict[str, Any],
+    *,
+    file_exists: dict[str, bool] | None = None,
+    signal_flags: dict[str, bool] | None = None,
+) -> dict[str, Any]:
+    all_paths = []
+    for check in spec["checks"]:
+        all_paths.extend(check.get("required_files", []))
+
+    file_exists = file_exists or _file_exists_map(REPO_ROOT, sorted(set(all_paths)))
+    signal_flags = signal_flags or derive_signal_flags(REPO_ROOT)
+
+    ready_checks = []
+    blocked_checks = []
+    checks = []
+
+    for check in spec["checks"]:
+        missing_files = [path for path in check.get("required_files", []) if not file_exists.get(path, False)]
+        missing_signals = [key for key in check.get("required_signals", []) if not signal_flags.get(key, False)]
+        ready = not missing_files and not missing_signals
+        result = {
+            "id": check["id"],
+            "label": check["label"],
+            "ready": ready,
+            "missing_files": missing_files,
+            "missing_signals": missing_signals,
+            "evidence": _evidence_line(check, file_exists, signal_flags),
+        }
+        checks.append(result)
+        if ready:
+            ready_checks.append(result)
+        else:
+            blocked_checks.append(result)
+
+    return {
+        "epic_issue": spec["epic_issue"],
+        "title": spec["title"],
+        "ready_count": len(ready_checks),
+        "blocked_count": len(blocked_checks),
+        "ready_checks": ready_checks,
+        "blocked_checks": blocked_checks,
+        "checks": checks,
+        "signals": signal_flags,
+        "files": file_exists,
+    }
+
+
+def render_markdown(report: dict[str, Any]) -> str:
+    lines = [
+        "# Zero-Touch Forge Readiness",
+        "",
+        f"Epic: #{report['epic_issue']} — {report['title']}",
+        "",
+        "## Impossible Goal",
+        "",
+        "Take a raw VPS plus only a git URL and encrypted seed, then bootstrap a full Timmy Foundation fleet in under 60 minutes with no human intervention after trigger.",
+        "",
+        "This document does **not** claim the goal is solved. It grounds the epic in the current repo state.",
+        "",
+        f"Current primitive readiness: {report['ready_count']} ready / {report['blocked_count']} blocked.",
+        "",
+        "## Current Readiness Table",
+        "",
+        "| Check | Status | Evidence | Missing Pieces |",
+        "|-------|--------|----------|----------------|",
+    ]
+    for check in report["checks"]:
+        status = "READY" if check["ready"] else "BLOCKED"
+        missing = ", ".join(check["missing_files"] + check["missing_signals"]) or "—"
+        lines.append(f"| {check['label']} | {status} | {check['evidence']} | {missing} |")
+
+    lines.extend([
+        "",
+        "## Interpretation",
+        "",
+        "### What already exists",
+        "- `scripts/provision-runner.sh` proves we already automate part of bare-metal service bootstrap.",
+        "- `scripts/lazarus_checkpoint.py` proves we already have a checkpoint / restore primitive for mission state.",
+        "- `docker-compose.yml`, `fleet/fleet-routing.json`, `operations/fleet-topology.md`, and `config/fleet_agents.json` show a real fleet shape, not just a philosophical wish.",
+        "",
+        "### What is still missing",
+        "- no verified cryptographic repo-integrity gate for a cold bootstrap run",
+        "- no age-encrypted seed / recovery-bundle path in this repo",
+        "- no single stack-start manifest that can bring up Gitea, Nostr relay, Ollama, and all agents from bare metal",
+        "- no bootstrap test gate that refuses health until the full stack passes",
+        "- no explicit notify-Alexander-only-after-healthy step",
+        "- no measured 60-minute execution budget proving the impossible bar",
+        "",
+        "## Next Concrete Build Steps",
+        "",
+        "1. Add an age-based recovery bundle flow and a decrypt/distribute bootstrap primitive.",
+        "2. Add a single stack-start manifest that covers Gitea + relay + Ollama + agent services from one command.",
+        "3. Add a zero-touch health gate script that verifies the full stack before declaring success.",
+        "4. Add a post-boot notification step that only fires after the health gate is green.",
+        "5. Add a timed rehearsal harness so the 60-minute claim can be measured instead of imagined.",
+        "",
+        "## Honest Bottom Line",
+        "",
+        "The repo already contains useful bootstrap and recovery primitives, but it does **not** yet implement a true zero-touch forge. The epic remains open because the hard problems — trust bootstrapping, full-stack orchestration, and timed self-verification — are still unresolved.",
+        "",
+    ])
+    return "\n".join(lines)
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description="Evaluate repo readiness for the Zero-Touch Forge epic.")
+    parser.add_argument("--json", action="store_true", help="Emit JSON instead of markdown")
+    parser.add_argument("--out", type=Path, help="Optional output file")
+    return parser.parse_args()
+
+
+def main() -> None:
+    args = parse_args()
+    spec = load_spec()
+    report = evaluate_readiness(spec)
+    output = json.dumps(report, indent=2) if args.json else render_markdown(report)
+    if args.out:
+        args.out.parent.mkdir(parents=True, exist_ok=True)
+        args.out.write_text(output)
+    else:
+        print(output)
+
+
+if __name__ == "__main__":
+    main()

tests/test_spatial_search.js

@@ -1,99 +0,0 @@
-// Test suite for SpatialSearch module
-// Run: node --test tests/test_spatial_search.js
-
-const { describe, it, beforeEach } = require('node:test');
-const assert = require('node:assert');
-
-// Mock DOM for Node.js environment
-global.document = {
-  createElement: (tag) => ({
-    className: '',
-    style: {},
-    innerHTML: '',
-    textContent: '',
-    addEventListener: () => {},
-    appendChild: () => {},
-    querySelector: () => ({ style: {}, textContent: '' })
-  }),
-  body: { appendChild: () => {} },
-  addEventListener: () => {}
-};
-global.window = { camera: null };
-
-// Load module
-const SpatialSearch = require('../js/spatial-search.js');
-
-describe('SpatialSearch', () => {
-  let search;
-
-  beforeEach(() => {
-    search = new SpatialSearch({ maxDistance: 1000 });
-  });
-
-  it('loads correctly', () => {
-    assert.ok(SpatialSearch);
-  });
-
-  it('can be instantiated', () => {
-    assert.ok(search instanceof SpatialSearch);
-  });
-
-  it('can register entities', () => {
-    search.registerEntity('user1', {
-      name: 'Alice',
-      type: 'user',
-      position: { x: 10, y: 0, z: 5 }
-    });
-    const status = search.getStatus();
-    assert.strictEqual(status.entityCount, 1);
-  });
-
-  it('can unregister entities', () => {
-    search.registerEntity('user1', { name: 'Alice', type: 'user', position: { x: 0, y: 0, z: 0 } });
-    search.unregisterEntity('user1');
-    assert.strictEqual(search.getStatus().entityCount, 0);
-  });
-
-  it('can update entity position', () => {
-    search.registerEntity('user1', { name: 'Alice', type: 'user', position: { x: 0, y: 0, z: 0 } });
-    search.updateEntityPosition('user1', { x: 10, y: 0, z: 10 });
-    // Verify by searching with camera position
-    const results = search.searchEntities('alice', { x: 0, y: 0, z: 0 });
-    assert.strictEqual(results.length, 1);
-    assert.ok(results[0].distance > 0);
-  });
-
-  it('calculates distance correctly', () => {
-    const from = { x: 0, y: 0, z: 0 };
-    const to = { x: 3, y: 0, z: 4 };
-    const distance = search._calculateDistance(from, to);
-    assert.strictEqual(distance, 5); // 3-4-5 triangle
-  });
-
-  it('calculates direction correctly', () => {
-    const from = { x: 0, y: 0, z: 0 };
-    assert.strictEqual(search._calculateDirection(from, { x: 0, y: 0, z: 10 }), 'N');
-    assert.strictEqual(search._calculateDirection(from, { x: 10, y: 0, z: 0 }), 'E');
-    assert.strictEqual(search._calculateDirection(from, { x: 0, y: 0, z: -10 }), 'S');
-    assert.strictEqual(search._calculateDirection(from, { x: -10, y: 0, z: 0 }), 'W');
-  });
-
-  it('searches entities correctly', () => {
-    search.registerEntity('1', { name: 'Alice', type: 'user', position: { x: 5, y: 0, z: 0 } });
-    search.registerEntity('2', { name: 'Bob', type: 'user', position: { x: 10, y: 0, z: 0 } });
-    search.registerEntity('3', { name: 'Alice Shop', type: 'object', position: { x: 20, y: 0, z: 0 } });
-
-    const results = search.searchEntities('ali', { x: 0, y: 0, z: 0 });
-    assert.strictEqual(results.length, 2);
-    assert.strictEqual(results[0].name, 'Alice'); // Closer
-    assert.strictEqual(results[1].name, 'Alice Shop');
-  });
-
-  it('gets status', () => {
-    search.registerEntity('1', { name: 'Test', type: 'object', position: { x: 0, y: 0, z: 0 } });
-    const status = search.getStatus();
-    assert.strictEqual(status.entityCount, 1);
-    assert.strictEqual(status.isOpen, false);
-    assert.strictEqual(status.resultCount, 0);
-  });
-});

tests/test_zero_touch_forge_readiness.py

@@ -0,0 +1,67 @@
+from pathlib import Path
+import sys
+
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+
+from scripts.zero_touch_forge_readiness import evaluate_readiness, load_spec
+
+
+DOC = Path("docs/zero-touch-forge-readiness.md")
+
+
+def test_load_spec_contains_all_impossible_bar_checks():
+    spec = load_spec()
+    check_ids = [item["id"] for item in spec["checks"]]
+    assert check_ids == [
+        "os_bootstrap",
+        "integrity_validation",
+        "secret_distribution",
+        "stack_startup",
+        "test_gate",
+        "checkpoint_restore",
+        "post_boot_notification",
+        "sixty_minute_sla",
+    ]
+
+
+def test_evaluate_readiness_marks_missing_components_as_blockers():
+    spec = load_spec()
+    result = evaluate_readiness(
+        spec,
+        file_exists={
+            "scripts/provision-runner.sh": True,
+            "scripts/lazarus_checkpoint.py": True,
+            "operations/fleet-topology.md": True,
+            "docker-compose.yml": False,
+            "fleet/fleet-routing.json": False,
+            "tests/test_bootstrap_contract.py": False,
+        },
+        signal_flags={
+            "has_age_seed_flow": False,
+            "has_crypto_integrity_verification": False,
+            "has_stack_start_manifest": False,
+            "has_test_gate": False,
+            "has_notification_step": False,
+            "has_sla_budget": False,
+        },
+    )
+
+    assert result["ready_count"] == 2
+    blocked = {item["id"] for item in result["blocked_checks"]}
+    assert blocked == {
+        "integrity_validation",
+        "secret_distribution",
+        "stack_startup",
+        "test_gate",
+        "post_boot_notification",
+        "sixty_minute_sla",
+    }
+
+
+def test_document_exists_with_required_sections():
+    assert DOC.exists(), "expected zero-touch forge readiness doc to exist"
+    content = DOC.read_text()
+    assert "# Zero-Touch Forge Readiness" in content
+    assert "## Impossible Goal" in content
+    assert "## Current Readiness Table" in content
+    assert "## Next Concrete Build Steps" in content