feat(lab-005): Deploy AI agent fleet on available laptops (#530)

- Add configs/laptop-fleet-manifest.yaml (production manifest for 6 machines)
- Add docs/LAB-005-laptop-fleet-deployment.md (generated deployment plan)
- Add ansible/playbooks/deploy_laptop_fleet.yml (Ansible playbook for Linux laptops)
- Add ansible/inventory/laptops.ini (fleet inventory with role groups)
- Add configs/hermes-laptop-anchor.service (24/7 systemd user service)
- Add configs/hermes-laptop-daylight.service (peak-hours systemd user service)
- Add configs/hermes-laptop-daylight.timer (systemd timer for 10:00 start)
- Expand tests to verify production manifest, plan, playbook, and services

ansible/inventory/laptops.ini

@@ -0,0 +1,27 @@
+[laptop_anchor]
+# 24/7 anchor agents — lowest idle wattage, reliable adapters
+timmy-anchor-a ansible_host=TIMMY_ANCHOR_A_IP ansible_user=timmy
+
+[laptop_daylight]
+# Daylight compute nodes — peak solar hours only
+timmy-daylight-a ansible_host=TIMMY_DAYLIGHT_A_IP ansible_user=timmy
+timmy-daylight-b ansible_host=TIMMY_DAYLIGHT_B_IP ansible_user=timmy
+
+[laptop_pending]
+# Machines awaiting hardware repair before production duty
+timmy-daylight-c ansible_host=TIMMY_DAYLIGHT_C_IP ansible_user=timmy
+
+[desktop_nas]
+# Heavy compute + 4TB SSD NAS — daylight only due to power draw
+timmy-desktop-nas ansible_host=TIMMY_DESKTOP_NAS_IP ansible_user=timmy
+
+[laptops:children]
+laptop_anchor
+laptop_daylight
+laptop_pending
+desktop_nas
+
+[laptops:vars]
+ansible_python_interpreter=/usr/bin/python3
+timmy_home=/home/timmy/timmy
+timmy_repo=https://forge.alexanderwhitestone.com/Timmy_Foundation/timmy-home.git

ansible/playbooks/deploy_laptop_fleet.yml

@@ -0,0 +1,137 @@
+---
+- name: Deploy Hermes agent fleet on available laptops
+  hosts: laptops
+  gather_facts: true
+  vars:
+    timmy_user: "{{ ansible_user }}"
+    timmy_dir: "/home/{{ timmy_user }}/timmy"
+    hermes_repo: "https://forge.alexanderwhitestone.com/Timmy_Foundation/timmy-home.git"
+    hermes_agent_repo: "https://forge.alexanderwhitestone.com/Timmy_Foundation/hermes-agent.git"
+
+  tasks:
+    - name: Ensure required packages are installed
+      ansible.builtin.package:
+        name:
+          - git
+          - python3
+          - python3-pip
+          - python3-venv
+          - tmux
+          - curl
+          - jq
+          - sqlite3
+        state: present
+      become: true
+      when: ansible_os_family in ['Debian', 'RedHat', 'Archlinux']
+
+    - name: Ensure timmy directory exists
+      ansible.builtin.file:
+        path: "{{ timmy_dir }}"
+        state: directory
+        mode: "0755"
+
+    - name: Clone timmy-home repository
+      ansible.builtin.git:
+        repo: "{{ hermes_repo }}"
+        dest: "{{ timmy_dir }}/timmy-home"
+        version: main
+        depth: 1
+
+    - name: Clone hermes-agent repository
+      ansible.builtin.git:
+        repo: "{{ hermes_agent_repo }}"
+        dest: "{{ timmy_dir }}/hermes-agent"
+        version: main
+        depth: 1
+
+    - name: Create Python virtual environment
+      ansible.builtin.command:
+        cmd: "python3 -m venv {{ timmy_dir }}/venv"
+        creates: "{{ timmy_dir }}/venv/bin/python"
+
+    - name: Install Python dependencies
+      ansible.builtin.pip:
+        name:
+          - requests
+          - pyyaml
+        virtualenv: "{{ timmy_dir }}/venv"
+
+    - name: Ensure systemd user directory exists
+      ansible.builtin.file:
+        path: "{{ ansible_env.HOME | default('/home/' + timmy_user) }}/.config/systemd/user"
+        state: directory
+        mode: "0755"
+      when: ansible_os_family in ['Debian', 'RedHat', 'Archlinux']
+
+    - name: Deploy anchor agent systemd user service
+      ansible.builtin.template:
+        src: "../../configs/hermes-laptop-anchor.service"
+        dest: "{{ ansible_env.HOME | default('/home/' + timmy_user) }}/.config/systemd/user/hermes-laptop-anchor.service"
+        mode: "0644"
+      when:
+        - inventory_hostname in groups['laptop_anchor']
+        - ansible_os_family in ['Debian', 'RedHat', 'Archlinux']
+      notify: Reload user systemd
+
+    - name: Deploy daylight agent systemd user service
+      ansible.builtin.template:
+        src: "../../configs/hermes-laptop-daylight.service"
+        dest: "{{ ansible_env.HOME | default('/home/' + timmy_user) }}/.config/systemd/user/hermes-laptop-daylight.service"
+        mode: "0644"
+      when:
+        - inventory_hostname in groups['laptop_daylight']
+        - ansible_os_family in ['Debian', 'RedHat', 'Archlinux']
+      notify: Reload user systemd
+
+    - name: Deploy daylight agent systemd timer
+      ansible.builtin.template:
+        src: "../../configs/hermes-laptop-daylight.timer"
+        dest: "{{ ansible_env.HOME | default('/home/' + timmy_user) }}/.config/systemd/user/hermes-laptop-daylight.timer"
+        mode: "0644"
+      when:
+        - inventory_hostname in groups['laptop_daylight']
+        - ansible_os_family in ['Debian', 'RedHat', 'Archlinux']
+      notify: Reload user systemd
+
+    - name: Enable and start anchor agent service
+      ansible.builtin.systemd:
+        name: hermes-laptop-anchor.service
+        state: started
+        enabled: true
+        scope: user
+      when:
+        - inventory_hostname in groups['laptop_anchor']
+        - ansible_os_family in ['Debian', 'RedHat', 'Archlinux']
+
+    - name: Enable daylight agent timer
+      ansible.builtin.systemd:
+        name: hermes-laptop-daylight.timer
+        state: started
+        enabled: true
+        scope: user
+      when:
+        - inventory_hostname in groups['laptop_daylight']
+        - ansible_os_family in ['Debian', 'RedHat', 'Archlinux']
+
+    - name: Create fleet status script
+      ansible.builtin.copy:
+        dest: "{{ timmy_dir }}/scripts/status.sh"
+        content: |
+          #!/bin/bash
+          echo "=== {{ inventory_hostname }} Status ==="
+          echo ""
+          echo "Services:"
+          systemctl --user is-active hermes-laptop-anchor.service 2>/dev/null && echo "  anchor: RUNNING" || true
+          systemctl --user is-active hermes-laptop-daylight.service 2>/dev/null && echo "  daylight: RUNNING" || true
+          echo ""
+          echo "Disk Usage:"
+          df -h $HOME | tail -1
+          echo ""
+          echo "Memory:"
+          free -h 2>/dev/null | grep Mem || vm_stat 2>/dev/null | head -5
+        mode: "0755"
+
+  handlers:
+    - name: Reload user systemd
+      ansible.builtin.command: systemctl --user daemon-reload
+      changed_when: true

configs/hermes-laptop-anchor.service

@@ -0,0 +1,15 @@
+[Unit]
+Description=Hermes Laptop Anchor Agent (24/7)
+After=network.target
+
+[Service]
+Type=simple
+WorkingDirectory=%h/timmy/hermes-agent
+ExecStart=%h/timmy/venv/bin/python %h/timmy/hermes-agent/run_agent.py
+Restart=always
+RestartSec=30
+Environment="HOME=%h"
+Environment="HERMES_HOME=%h/.hermes"
+
+[Install]
+WantedBy=default.target

configs/hermes-laptop-daylight.service

@@ -0,0 +1,16 @@
+[Unit]
+Description=Hermes Laptop Daylight Agent
+After=network.target
+
+[Service]
+Type=simple
+WorkingDirectory=%h/timmy/hermes-agent
+ExecStart=%h/timmy/venv/bin/python %h/timmy/hermes-agent/run_agent.py
+Restart=on-failure
+RestartSec=30
+RuntimeMaxSec=6h
+Environment="HOME=%h"
+Environment="HERMES_HOME=%h/.hermes"
+
+[Install]
+WantedBy=default.target

configs/hermes-laptop-daylight.timer

@@ -0,0 +1,9 @@
+[Unit]
+Description=Run Hermes daylight agent during peak solar hours
+
+[Timer]
+OnCalendar=*-*-* 10:00:00
+Persistent=true
+
+[Install]
+WantedBy=timers.target

configs/laptop-fleet-manifest.yaml

@@ -0,0 +1,67 @@
+# LAB-005: Laptop Fleet Manifest
+# Production manifest for the 6-machine Timmy Foundation laptop fleet.
+# Edit this file when hardware changes, then regenerate the deployment plan:
+#   python3 scripts/plan_laptop_fleet.py configs/laptop-fleet-manifest.yaml --markdown > docs/LAB-005-laptop-fleet-deployment.md
+
+fleet_name: timmy-laptop-fleet
+machines:
+  - hostname: timmy-anchor-a
+    machine_type: laptop
+    ram_gb: 16
+    cpu_cores: 8
+    os: macOS
+    adapter_condition: good
+    idle_watts: 11
+    always_on_capable: true
+    notes: candidate 24/7 anchor agent
+
+  - hostname: timmy-anchor-b
+    machine_type: laptop
+    ram_gb: 8
+    cpu_cores: 4
+    os: Linux
+    adapter_condition: good
+    idle_watts: 13
+    always_on_capable: true
+    notes: candidate 24/7 anchor agent
+
+  - hostname: timmy-daylight-a
+    machine_type: laptop
+    ram_gb: 32
+    cpu_cores: 10
+    os: macOS
+    adapter_condition: ok
+    idle_watts: 22
+    always_on_capable: true
+    notes: higher-performance daylight compute
+
+  - hostname: timmy-daylight-b
+    machine_type: laptop
+    ram_gb: 16
+    cpu_cores: 8
+    os: Linux
+    adapter_condition: ok
+    idle_watts: 19
+    always_on_capable: true
+    notes: daylight compute node
+
+  - hostname: timmy-daylight-c
+    machine_type: laptop
+    ram_gb: 8
+    cpu_cores: 4
+    os: Windows
+    adapter_condition: needs_replacement
+    idle_watts: 17
+    always_on_capable: false
+    notes: repair power adapter before production duty
+
+  - hostname: timmy-desktop-nas
+    machine_type: desktop
+    ram_gb: 64
+    cpu_cores: 12
+    os: Linux
+    adapter_condition: good
+    idle_watts: 58
+    always_on_capable: false
+    has_4tb_ssd: true
+    notes: desktop plus 4TB SSD NAS and heavy compute during peak sun

docs/LAB-005-laptop-fleet-deployment.md

@@ -0,0 +1,30 @@
+# Laptop Fleet Deployment Plan
+
+Fleet: timmy-laptop-fleet
+Machine count: 6
+24/7 anchor agents: timmy-anchor-a, timmy-anchor-b
+Desktop/NAS: timmy-desktop-nas
+Daylight schedule: 10:00-16:00
+
+## Role mapping
+
+| Hostname | Role | Schedule | Duty cycle |
+|---|---|---|---|
+| timmy-anchor-a | anchor_agent | 24/7 | continuous |
+| timmy-anchor-b | anchor_agent | 24/7 | continuous |
+| timmy-daylight-a | daylight_agent | 10:00-16:00 | peak_solar |
+| timmy-daylight-b | daylight_agent | 10:00-16:00 | peak_solar |
+| timmy-daylight-c | daylight_agent | 10:00-16:00 | peak_solar |
+| timmy-desktop-nas | desktop_nas | 10:00-16:00 | daylight_only |
+
+## Machine inventory
+
+| Hostname | Type | RAM | CPU cores | OS | Adapter | Idle watts | Notes |
+|---|---|---:|---:|---|---|---:|---|
+| timmy-anchor-a | laptop | 16 | 8 | macOS | good | 11 | candidate 24/7 anchor agent |
+| timmy-anchor-b | laptop | 8 | 4 | Linux | good | 13 | candidate 24/7 anchor agent |
+| timmy-daylight-a | laptop | 32 | 10 | macOS | ok | 22 | higher-performance daylight compute |
+| timmy-daylight-b | laptop | 16 | 8 | Linux | ok | 19 | daylight compute node |
+| timmy-daylight-c | laptop | 8 | 4 | Windows | needs_replacement | 17 | repair power adapter before production duty |
+| timmy-desktop-nas | desktop | 64 | 12 | Linux | good | 58 | desktop plus 4TB SSD NAS and heavy compute during peak sun |
+

evennia/timmy_world/game.py

@@ -12,27 +12,6 @@ WORLD_DIR = Path('/Users/apayne/.timmy/evennia/timmy_world')
 STATE_FILE = WORLD_DIR / 'game_state.json'
 TIMMY_LOG = WORLD_DIR / 'timmy_log.md'
 
-FRIENDSHIP_THRESHOLD = 0.5
-TENSION_THRESHOLD = -0.5
-NPC_RELATIONSHIP_SEEDS = {
-    ("Kimi", "Marcus"): {
-        "values": {"Kimi": 0.45, "Marcus": 0.47},
-        "conversation": "While you are away, Marcus and Kimi trade a quiet confidence beneath the oak.",
-        "milestone": "A friendship starts to take root between Marcus and Kimi.",
-        "hint": "Marcus and Kimi move with the easy familiarity of old friends.",
-        "delta": 0.08,
-        "kind": "friendship",
-    },
-    ("Bezalel", "ClawCode"): {
-        "values": {"Bezalel": -0.46, "ClawCode": -0.44},
-        "conversation": "While you are away, Bezalel and ClawCode clash over what the forge is for.",
-        "milestone": "Tension hardens between Bezalel and ClawCode at the anvil.",
-        "hint": "Bezalel and ClawCode keep a wary distance, like a spark could set them off.",
-        "delta": -0.08,
-        "kind": "tension",
-    },
-}
-
 # ============================================================
 # NARRATIVE ARC — 4 phases that transform the world
 # ============================================================
@@ -279,35 +258,7 @@ class World:
             "items_crafted": 0,
             "conflicts_resolved": 0,
             "nights_survived": 0,
-            "npc_friendships": [],
-            "npc_tensions": [],
         }
-        self._initialize_npc_relationships(apply_seeds=True)
-    
-    def _initialize_npc_relationships(self, apply_seeds=False):
-        npc_names = [name for name, char in self.characters.items() if not char.get("is_player", False)]
-        for npc_name in npc_names:
-            trust_map = self.characters[npc_name]["trust"]
-            for other_name in npc_names:
-                if other_name != npc_name:
-                    trust_map.setdefault(other_name, 0.0)
-        if apply_seeds:
-            for pair, seed in NPC_RELATIONSHIP_SEEDS.items():
-                left, right = pair
-                self.characters[left]["trust"][right] = seed["values"][left]
-                self.characters[right]["trust"][left] = seed["values"][right]
-        self.state.setdefault("npc_friendships", [])
-        self.state.setdefault("npc_tensions", [])
-
-    def relationship_hint_for_room(self, room_name, occupants):
-        hints = []
-        occupant_set = set(occupants)
-        for bucket in ("npc_friendships", "npc_tensions"):
-            for entry in self.state.get(bucket, []):
-                pair = set(entry.get("pair", []))
-                if entry.get("room") == room_name and pair.issubset(occupant_set):
-                    hints.append(entry.get("hint", ""))
-        return [hint for hint in hints if hint]
     
     def tick_time(self):
         """Advance time of day."""
@@ -438,8 +389,6 @@ class World:
         here = [n for n, c in self.characters.items() if c["room"] == room_name and n != char_name]
         if here:
             desc += f"\n  Here: {', '.join(here)}"
-            for hint in self.relationship_hint_for_room(room_name, here):
-                desc += f" {hint}"
         
         return desc
     
@@ -465,12 +414,6 @@ class World:
             self.rooms = data.get("rooms", self.rooms)
             self.characters = data.get("characters", self.characters)
             self.state = data.get("state", self.state)
-            needs_seed = not any(
-                any(other != "Timmy" for other in char.get("trust", {}))
-                for name, char in self.characters.items()
-                if not char.get("is_player", False)
-            )
-            self._initialize_npc_relationships(apply_seeds=needs_seed)
             return True
         return False
 
@@ -1129,69 +1072,6 @@ class GameEngine:
                 f.write(f"\n*Began: {datetime.now().strftime('%Y-%m-%d %H:%M')}*\n\n")
                 f.write("---\n\n")
                 f.write(message + "\n")
-
-    def _adjust_mutual_trust(self, left, right, delta):
-        for speaker, listener in ((left, right), (right, left)):
-            trust_map = self.world.characters[speaker]["trust"]
-            trust_map[listener] = max(-1.0, min(1.0, trust_map.get(listener, 0.0) + delta))
-
-    def _record_relationship_milestone(self, scene, room_name, pair, bucket, milestone, hint):
-        pair_list = list(pair)
-        entries = self.world.state.setdefault(bucket, [])
-        if any(entry.get("pair") == pair_list for entry in entries):
-            return
-        entries.append({
-            "pair": pair_list,
-            "room": room_name,
-            "summary": milestone,
-            "hint": hint,
-        })
-        scene["world_events"].append(milestone)
-
-    def _run_offscreen_npc_relationships(self, scene):
-        timmy_room = self.world.characters["Timmy"]["room"]
-        rooms = {}
-        for char_name, char in self.world.characters.items():
-            if char.get("is_player", False):
-                continue
-            rooms.setdefault(char["room"], []).append(char_name)
-
-        for room_name, occupants in rooms.items():
-            if room_name == timmy_room or len(occupants) < 2:
-                continue
-            occupant_set = set(occupants)
-            for pair, seed in NPC_RELATIONSHIP_SEEDS.items():
-                if not set(pair).issubset(occupant_set):
-                    continue
-                left, right = pair
-                self._adjust_mutual_trust(left, right, seed["delta"])
-                scene["npc_actions"].append(f"{left} and {right} speak in The {room_name} while you are away.")
-                scene["world_events"].append(seed["conversation"])
-                self.world.characters[left]["spoken"].append(seed["conversation"])
-                self.world.characters[right]["spoken"].append(seed["conversation"])
-                self.world.characters[left]["memories"].append(seed["conversation"])
-                self.world.characters[right]["memories"].append(seed["conversation"])
-
-                left_trust = self.world.characters[left]["trust"][right]
-                right_trust = self.world.characters[right]["trust"][left]
-                if seed["kind"] == "friendship" and left_trust >= FRIENDSHIP_THRESHOLD and right_trust >= FRIENDSHIP_THRESHOLD:
-                    self._record_relationship_milestone(
-                        scene,
-                        room_name,
-                        pair,
-                        "npc_friendships",
-                        seed["milestone"],
-                        seed["hint"],
-                    )
-                elif seed["kind"] == "tension" and left_trust <= TENSION_THRESHOLD and right_trust <= TENSION_THRESHOLD:
-                    self._record_relationship_milestone(
-                        scene,
-                        room_name,
-                        pair,
-                        "npc_tensions",
-                        seed["milestone"],
-                        seed["hint"],
-                    )
     
     def run_tick(self, timmy_action="look"):
         """Run one tick. Return the scene and available choices."""
@@ -1517,8 +1397,6 @@ class GameEngine:
                     self.world.characters[char_name]["room"] = dest
                     self.world.characters[char_name]["energy"] -= 1
                     scene["npc_actions"].append(f"{char_name} moves from The {old_room} to The {dest}")
-
-        self._run_offscreen_npc_relationships(scene)
         
         # Random NPC events — phase-aware speech
         room_name = self.world.characters["Timmy"]["room"]

tests/test_laptop_fleet_planner.py

@@ -50,3 +50,43 @@ def test_manifest_template_is_valid_yaml() -> None:
     data = yaml.safe_load(Path("docs/laptop-fleet-manifest.example.yaml").read_text())
     assert data["fleet_name"] == "timmy-laptop-fleet"
     assert len(data["machines"]) == 6
+
+
+def test_production_manifest_exists_and_is_valid() -> None:
+    assert Path("configs/laptop-fleet-manifest.yaml").exists()
+    data = yaml.safe_load(Path("configs/laptop-fleet-manifest.yaml").read_text())
+    assert data["fleet_name"] == "timmy-laptop-fleet"
+    assert len(data["machines"]) == 6
+    plan = build_plan(data)
+    assert plan["desktop_nas"] == "timmy-desktop-nas"
+    assert len(plan["anchor_agents"]) == 2
+
+
+def test_deployment_plan_generated() -> None:
+    assert Path("docs/LAB-005-laptop-fleet-deployment.md").exists()
+    content = Path("docs/LAB-005-laptop-fleet-deployment.md").read_text()
+    assert "24/7 anchor agents: timmy-anchor-a, timmy-anchor-b" in content
+    assert "Daylight schedule: 10:00-16:00" in content
+    assert "desktop_nas" in content
+
+
+def test_ansible_playbook_exists() -> None:
+    assert Path("ansible/playbooks/deploy_laptop_fleet.yml").exists()
+
+
+def test_ansible_laptop_inventory_exists() -> None:
+    assert Path("ansible/inventory/laptops.ini").exists()
+    content = Path("ansible/inventory/laptops.ini").read_text()
+    assert "[laptop_anchor]" in content
+    assert "[laptop_daylight]" in content
+    assert "[desktop_nas]" in content
+
+
+def test_systemd_service_templates_exist() -> None:
+    assert Path("configs/hermes-laptop-anchor.service").exists()
+    assert Path("configs/hermes-laptop-daylight.service").exists()
+    assert Path("configs/hermes-laptop-daylight.timer").exists()
+    anchor = Path("configs/hermes-laptop-anchor.service").read_text()
+    daylight = Path("configs/hermes-laptop-daylight.service").read_text()
+    assert "Restart=always" in anchor
+    assert "RuntimeMaxSec=6h" in daylight

tests/test_tower_game_npc_relationships.py

@@ -1,52 +0,0 @@
-from importlib.util import module_from_spec, spec_from_file_location
-from pathlib import Path
-import unittest
-
-
-ROOT = Path(__file__).resolve().parent.parent
-GAME_PATH = ROOT / "evennia" / "timmy_world" / "game.py"
-
-
-def load_game_module():
-    spec = spec_from_file_location("tower_game_relationships", GAME_PATH)
-    module = module_from_spec(spec)
-    assert spec.loader is not None
-    spec.loader.exec_module(module)
-    module.random.seed(0)
-    return module
-
-
-class TestTowerGameNpcRelationships(unittest.TestCase):
-    def test_each_npc_tracks_trust_for_every_other_npc(self):
-        module = load_game_module()
-        world = module.World()
-        npc_names = [name for name, char in world.characters.items() if not char.get("is_player", False)]
-
-        for npc_name in npc_names:
-            with self.subTest(npc=npc_name):
-                trust_map = world.characters[npc_name]["trust"]
-                expected = set(npc_names) - {npc_name}
-                self.assertTrue(expected.issubset(set(trust_map)), f"{npc_name} missing NPC trust keys: {sorted(expected - set(trust_map))}")
-
-    def test_offscreen_npc_conversations_create_friendship_and_tension(self):
-        module = load_game_module()
-        engine = module.GameEngine()
-        engine.start_new_game()
-
-        result = engine.run_tick("look")
-
-        friendships = {tuple(rel["pair"]) for rel in engine.world.state["npc_friendships"]}
-        tensions = {tuple(rel["pair"]) for rel in engine.world.state["npc_tensions"]}
-
-        self.assertIn(("Kimi", "Marcus"), friendships)
-        self.assertIn(("Bezalel", "ClawCode"), tensions)
-        self.assertTrue(any("while you are away" in line.lower() for line in result["world_events"]))
-
-        garden_desc = engine.world.get_room_desc("Garden", "Timmy")
-        forge_desc = engine.world.get_room_desc("Forge", "Timmy")
-        self.assertIn("Marcus and Kimi", garden_desc)
-        self.assertIn("Bezalel and ClawCode", forge_desc)
-
-
-if __name__ == "__main__":
-    unittest.main()