Files

Alexander Whitestone 8d1f9ed375

Smoke Test / smoke (pull_request) Failing after 20s

Details

feat(#667 ): codebase_genome.py — test stub generator for uncovered functions

AST-based tool that scans Python files, extracts function/method signatures,
and generates pytest test stubs for functions without existing tests.

Usage:
  python3 codebase_genome.py /path/to/repo
  python3 codebase_genome.py /path/to/repo -o tests/test_genome_generated.py

Features:
- AST parsing (no imports required, handles syntax errors gracefully)
- Extracts: function name, args, return type, decorators, class context
- Detects existing tests to avoid duplicates
- Generates: basic test + edge case test per function
- Skips private/dunder methods
- Configurable limit (--limit N)

Generated 30 test stubs for timmy-home as proof of concept.

2026-04-14 23:39:13 -04:00

5.4 KiB

Raw Blame History

Emacs Sovereign Control Plane

Real-time, programmable orchestration hub for the Timmy Foundation fleet.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    Emacs Control Plane                       │
│                                                             │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐        │
│  │  dispatch.org│  │  shared     │  │  org-babel  │        │
│  │  (Task Queue)│  │  buffers    │  │  notebooks   │        │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘        │
│         │                │                │                │
│         └────────────────┼────────────────┘                │
│                          │                                  │
│                    ┌─────▼─────┐                           │
│                    │  Emacs    │                           │
│                    │  Daemon   │                           │
│                    │  (bezalel)│                           │
│                    └─────┬─────┘                           │
└──────────────────────────┼──────────────────────────────────┘
                           │
        ┌──────────────────┼──────────────────┐
        │                  │                  │
   ┌────▼────┐       ┌────▼────┐       ┌────▼────┐
   │  Ezra   │       │ Allegro │       │  Timmy  │
   │  (VPS)  │       │  (VPS)  │       │  (Mac)  │
   └─────────┘       └─────────┘       └─────────┘

Infrastructure

Component	Location	Details
Daemon Host	Bezalel (`159.203.146.185`)	Shared Emacs daemon
Socket Path	`/root/.emacs.d/server/bezalel`	emacsclient socket
Dispatch Hub	`/srv/fleet/workspace/dispatch.org`	Central task queue
Wrapper	`/usr/local/bin/fleet-append`	Quick message append

Quick Start

From Local Machine (Timmy)

# Append a message to the fleet log
scripts/fleet_dispatch.sh append "Status: all systems nominal"

# Check for pending tasks assigned to Timmy
scripts/fleet_dispatch.sh poll timmy

# Claim a task
scripts/fleet_dispatch.sh claim 42 timmy

# Report task completion
scripts/emacs_fleet_bridge.py complete 42 "PR merged: #123"

From Other VPS Agents (Ezra, Allegro, etc.)

# Direct emacsclient via SSH
ssh root@bezalel 'emacsclient -s /root/.emacs.d/server/bezalel -e "(your-elisp-here)"'

# Or use the wrapper
ssh root@bezalel '/usr/local/bin/fleet-append "Ezra: task #42 complete"'

dispatch.org Structure

The central dispatch hub uses Org mode format:

* TODO [timmy] Review PR #123 from gitea
  SCHEDULED: <2026-04-13 Sun>
  :PROPERTIES:
  :PRIORITY: A
  :ASSIGNEE: timmy
  :GITEA_PR: https://forge.alexanderwhitestone.com/...
  :END:

* IN_PROGRESS [ezra] Deploy monitoring to VPS
  SCHEDULED: <2026-04-13 Sun>
  :PROPERTIES:
  :PRIORITY: B
  :ASSIGNEE: ezra
  :STARTED: 2026-04-13T15:30:00Z
  :END:

* DONE [allegro] Fix cron reliability
  CLOSED: [2026-04-13 Sun 14:00]
  :PROPERTIES:
  :ASSIGNEE: allegro
  :RESULT: PR #456 merged
  :END:

Status Keywords

TODO — Available for claiming
IN_PROGRESS — Being worked on
WAITING — Blocked on external dependency
DONE — Completed
CANCELLED — No longer needed

Priority Levels

[#A] — Critical / P0
[#B] — Important / P1
[#C] — Normal / P2

Agent Workflow

Poll: Check dispatch.org for TODO items matching your agent name
Claim: Update status from TODO to IN_PROGRESS, add :STARTED: timestamp
Execute: Do the work (implement, deploy, test, etc.)
Report: Update status to DONE, add :RESULT: property with outcome

Integration with Existing Systems

Gitea Issues

dispatch.org tasks can reference Gitea issues via :GITEA_PR: or :GITEA_ISSUE: properties
Completion can auto-close Gitea issues via API

Hermes Cron

Hermes cron jobs can check dispatch.org before running
Tasks in dispatch.org take priority over ambient issue burning

Nostr Protocol

Heartbeats still go through Nostr (kind 1)
dispatch.org is for tactical coordination, Nostr is for strategic announcements

Files

infrastructure/emacs-control-plane/
├── README.md                   # This file
├── dispatch.org.template       # Template dispatch file
└── fleet_bridge.el             # Emacs Lisp helpers

scripts/
├── fleet_dispatch.sh           # Shell wrapper for fleet operations
├── emacs_fleet_bridge.py       # Python bridge for Emacs daemon
└── emacs_task_poller.py        # Poll for tasks assigned to an agent

5.4 KiB Raw Blame History