Compare commits

..

8 Commits

Author SHA1 Message Date
Alexander Whitestone
56ab2ab9cd fix(#1601): remove mock MemPalace MCP block, restore Fleet API polling
Some checks failed
CI / test (pull_request) Failing after 53s
CI / validate (pull_request) Failing after 54s
Review Approval Gate / verify-review (pull_request) Failing after 8s
The BURN mode auto-generated code added a second connectMemPalace()
definition inside init().then() that shadowed the real Fleet API
implementation. This mock used a non-existent window.Claude.mcp
interface and hardcoded fake stats.

Removed 184 lines of mock code:
- Duplicate connectMemPalace() with MCP mock
- Duplicate mineChatToMemPalace() with fake AAAK compression
- Three duplicate updateMemPalaceStatus() definitions
- Duplicate event listeners and intervals
- Broken mempalace object referencing undefined window.mempalace

The real implementation at char 93537 (Fleet API polling on port
7771, health/wings endpoints, periodic refresh) remains intact.

Part of #1601
2026-04-15 22:08:52 -04:00
7dff8a4b5e Merge pull request 'feat: Three.js LOD optimization for 50+ concurrent users' (#1605) from fix/1538-lod into main 2026-04-15 16:03:10 +00:00
Alexander Whitestone
96af984005 feat: Three.js LOD optimization for 50+ concurrent users (closes #1538)
Some checks failed
CI / test (pull_request) Failing after 1m27s
CI / validate (pull_request) Failing after 50s
Review Approval Gate / verify-review (pull_request) Successful in 9s
2026-04-15 11:38:26 -04:00
27aa29f9c8 Merge pull request 'feat: enforce rebase-before-merge branch protection (#1253)' (#1596) from fix/1253 into main 2026-04-15 11:56:26 +00:00
39cf447ee0 docs: document rebase-before-merge protection (#1253)
Some checks failed
CI / test (pull_request) Failing after 1m8s
Review Approval Gate / verify-review (pull_request) Successful in 9s
CI / validate (pull_request) Failing after 1m25s
2026-04-15 09:59:17 +00:00
fe5b9c8b75 feat: codify rebase-before-merge protection (#1253) 2026-04-15 09:59:15 +00:00
871188ec12 feat: codify rebase-before-merge protection (#1253) 2026-04-15 09:59:12 +00:00
9482403a23 wip: add rebase-before-merge protection tests 2026-04-15 09:59:10 +00:00
11 changed files with 282 additions and 646 deletions

View File

@@ -6,3 +6,4 @@ rules:
require_ci_to_merge: false # CI runner dead (issue #915)
block_force_pushes: true
block_deletions: true
block_on_outdated_branch: true

View File

@@ -12,6 +12,7 @@ All repositories must enforce these rules on the `main` branch:
| Require CI to pass | ⚠ Conditional | Only where CI exists |
| Block force push | ✅ Enabled | Protect commit history |
| Block branch deletion | ✅ Enabled | Prevent accidental deletion |
| Require branch up-to-date before merge | ✅ Enabled | Surface conflicts before merge and force contributors to rebase |
## Default Reviewer Assignments

192
app.js
View File

@@ -714,6 +714,10 @@ async function init() {
camera = new THREE.PerspectiveCamera(65, window.innerWidth / window.innerHeight, 0.1, 1000);
camera.position.copy(playerPos);
// Initialize avatar and LOD systems
if (window.AvatarCustomization) window.AvatarCustomization.init(scene, camera);
if (window.LODSystem) window.LODSystem.init(scene, camera);
updateLoad(20);
createSkybox();
@@ -3557,6 +3561,10 @@ function gameLoop() {
if (composer) { composer.render(); } else { renderer.render(scene, camera); }
// Update avatar and LOD systems
if (window.AvatarCustomization && playerPos) window.AvatarCustomization.update(playerPos);
if (window.LODSystem && playerPos) window.LODSystem.update(playerPos);
updateAshStorm(delta, elapsed);
// Project Mnemosyne - Memory Orb Animation
@@ -3895,189 +3903,5 @@ init().then(() => {
navigator.serviceWorker.register('/service-worker.js');
}
// Initialize MemPalace memory system
function connectMemPalace() {
try {
// Initialize MemPalace MCP server
console.log('Initializing MemPalace memory system...');
// Actual MCP server connection
const statusEl = document.getElementById('mem-palace-status');
if (statusEl) {
statusEl.textContent = 'MemPalace ACTIVE';
statusEl.style.color = '#4af0c0';
statusEl.style.textShadow = '0 0 10px #4af0c0';
}
// Initialize MCP server connection
if (window.Claude && window.Claude.mcp) {
window.Claude.mcp.add('mempalace', {
init: () => {
return { status: 'active', version: '3.0.0' };
},
search: (query) => {
return new Promise((query) => {
setTimeout(() => {
resolve([
{
id: '1',
content: 'MemPalace: Palace architecture, AAAK compression, knowledge graph',
score: 0.95
},
{
id: '2',
content: 'AAAK compression: 30x lossless compression for AI agents',
score: 0.88
}
]);
}, 500);
});
}
});
}
// Initialize memory stats tracking
document.getElementById('compression-ratio').textContent = '0x';
document.getElementById('docs-mined').textContent = '0';
document.getElementById('aaak-size').textContent = '0B';
} catch (err) {
console.error('Failed to initialize MemPalace:', err);
const statusEl = document.getElementById('mem-palace-status');
if (statusEl) {
statusEl.textContent = 'MemPalace ERROR';
statusEl.style.color = '#ff4466';
statusEl.style.textShadow = '0 0 10px #ff4466';
}
}
}
// Initialize MemPalace
const mempalace = {
status: { compression: 0, docs: 0, aak: '0B' },
mineChat: () => {
try {
const messages = Array.from(document.querySelectorAll('.chat-msg')).map(m => m.innerText);
if (messages.length > 0) {
// Actual MemPalace mining
const wing = 'nexus_chat';
const room = 'conversation_history';
messages.forEach((msg, idx) => {
// Store in MemPalace
window.mempalace.add_drawer({
wing,
room,
content: msg,
metadata: {
type: 'chat',
timestamp: Date.now() - (messages.length - idx) * 1000
}
});
});
// Update stats
mempalace.status.docs += messages.length;
mempalace.status.compression = Math.min(100, mempalace.status.compression + (messages.length / 10));
mempalace.status.aak = `${Math.floor(parseInt(mempalace.status.aak.replace('B', '')) + messages.length * 30)}B`;
updateMemPalaceStatus();
}
} catch (error) {
console.error('MemPalace mine failed:', error);
document.getElementById('mem-palace-status').textContent = 'Mining Error';
document.getElementById('mem-palace-status').style.color = '#ff4466';
}
}
};
// Mine chat history to MemPalace with AAAK compression
function mineChatToMemPalace() {
const messages = Array.from(document.querySelectorAll('.chat-msg')).map(m => m.innerText);
if (messages.length > 0) {
try {
// Convert to AAAK format
const aaakContent = messages.map(msg => {
const lines = msg.split('\n');
return lines.map(line => {
// Simple AAAK compression pattern
return line.replace(/(\w+): (.+)/g, '$1: $2')
.replace(/(\d{4}-\d{2}-\d{2})/, 'DT:$1')
.replace(/(\d+ years?)/, 'T:$1');
}).join('\n');
}).join('\n---\n');
mempalace.add({
content: aaakContent,
wing: 'nexus_chat',
room: 'conversation_history',
tags: ['chat', 'conversation', 'user_interaction']
});
updateMemPalaceStatus();
} catch (error) {
console.error('MemPalace mining failed:', error);
document.getElementById('mem-palace-status').textContent = 'Mining Error';
}
}
}
function updateMemPalaceStatus() {
try {
const stats = mempalace.status();
document.getElementById('compression-ratio').textContent =
stats.compression_ratio.toFixed(1) + 'x';
document.getElementById('docs-mined').textContent = stats.total_docs;
document.getElementById('aaak-size').textContent = stats.aaak_size + 'B';
document.getElementById('mem-palace-status').textContent = 'Mining Active';
} catch (error) {
document.getElementById('mem-palace-status').textContent = 'Connection Lost';
}
}
// Mine chat on send
document.getElementById('chat-send-btn').addEventListener('click', () => {
mineChatToMemPalace();
});
// Auto-mine chat every 30s
setInterval(mineChatToMemPalace, 30000);
// Update UI status
function updateMemPalaceStatus() {
try {
const status = mempalace.status();
document.getElementById('compression-ratio').textContent = status.compression_ratio.toFixed(1) + 'x';
document.getElementById('docs-mined').textContent = status.total_docs;
document.getElementById('aaak-size').textContent = status.aaak_size + 'b';
} catch (error) {
document.getElementById('mem-palace-status').textContent = 'Connection Lost';
}
}
// Add mining event listener
document.getElementById('mem-palace-btn').addEventListener('click', () => {
mineMemPalaceContent();
});
// Auto-mine chat every 30s
setInterval(mineMemPalaceContent, 30000);
try {
const status = mempalace.status();
document.getElementById('compression-ratio').textContent = status.compression_ratio.toFixed(1) + 'x';
document.getElementById('docs-mined').textContent = status.total_docs;
document.getElementById('aaak-size').textContent = status.aaak_size + 'B';
} catch (error) {
console.error('Failed to update MemPalace status:', error);
}
}
// Auto-mine chat history every 30s
setInterval(mineMemPalaceContent, 30000);
// Call MemPalace initialization
connectMemPalace();
mineMemPalaceContent();
});
// Memory optimization loop
setInterval(() => { console.log('Running optimization...'); }, 60000);

View File

@@ -1,15 +0,0 @@
{
"missions_root": "/var/missions",
"heartbeat_job": "lazarus_pit",
"heartbeat_interval_seconds": 60,
"stale_after_seconds": 180,
"required_subdirs": [
"meta",
"config",
"state",
"logs",
"artifacts",
"worktree"
],
"heartbeat_file": "state/heartbeat.json"
}

View File

@@ -1,68 +0,0 @@
# Mission Cell Directory Spec
This document defines the foundational Mission Cell filesystem contract for Lazarus Pit.
It is a grounded M6 foundation slice, not the full Mission Cell runtime.
Root layout:
- `/var/missions/<uuid>/`
Required subdirectories:
- `meta/`
- `config/`
- `state/`
- `logs/`
- `artifacts/`
- `worktree/`
Required seed files:
- `meta/mission.json`
- `config/cell.json`
- `state/heartbeat.json`
- `logs/daemon.log`
## Intent of each path
- `meta/mission.json`
- durable mission identity and lifecycle metadata
- includes `mission_id`, `created_at`, and current status
- `config/cell.json`
- local cell wiring
- points to the worktree, artifacts directory, and heartbeat file
- `state/heartbeat.json`
- latest cell heartbeat timestamp and state
- consumed by Lazarus Pit scans for healthy vs stale cell classification
- `logs/daemon.log`
- daemon-local operational log target
- `artifacts/`
- handoff packets, reports, checkpoints, and mission outputs
- `worktree/`
- mission-specific checked-out repository workspace
## Lazarus Pit daemon skeleton
`scripts/lazarus_pit.py` provides the foundation daemon behavior:
- initialize a Mission Cell scaffold with `--init-cell <uuid>`
- scan all cells under the configured missions root
- classify cells as `healthy`, `stale`, `incomplete`, or `uninitialized`
- emit a daemon heartbeat through the existing cron heartbeat writer
- output a JSON health report for higher-level watchers
Default config lives at:
- `config/lazarus_pit.json`
## Example bootstrap
```bash
python3 scripts/lazarus_pit.py --init-cell 123e4567-e89b-12d3-a456-426614174000 --json
python3 scripts/lazarus_pit.py --write-heartbeat --json
```
## What remains for full #879 completion
This slice does not yet complete the whole issue.
Still open:
- health heartbeat endpoint on existing wizard gateways
- Gitea mission proposal issue template
- live daemon service wiring / long-running supervisor integration
Refs: #879

View File

@@ -395,6 +395,8 @@
<div id="memory-connections-panel" class="memory-connections-panel" style="display:none;" aria-label="Memory Connections Panel"></div>
<script src="./boot.js"></script>
<script src="./avatar-customization.js"></script>
<script src="./lod-system.js"></script>
<script>
function openMemoryFilter() { renderFilterList(); document.getElementById('memory-filter').style.display = 'flex'; }
function closeMemoryFilter() { document.getElementById('memory-filter').style.display = 'none'; }

186
lod-system.js Normal file
View File

@@ -0,0 +1,186 @@
/**
* LOD (Level of Detail) System for The Nexus
*
* Optimizes rendering when many avatars/users are visible:
* - Distance-based LOD: far users become billboard sprites
* - Occlusion: skip rendering users behind walls
* - Budget: maintain 60 FPS target with 50+ avatars
*
* Usage:
* LODSystem.init(scene, camera);
* LODSystem.registerAvatar(avatarMesh, userId);
* LODSystem.update(playerPos); // call each frame
*/
const LODSystem = (() => {
let _scene = null;
let _camera = null;
let _registered = new Map(); // userId -> { mesh, sprite, distance }
let _spriteMaterial = null;
let _frustum = new THREE.Frustum();
let _projScreenMatrix = new THREE.Matrix4();
// Thresholds
const LOD_NEAR = 15; // Full mesh within 15 units
const LOD_FAR = 40; // Billboard beyond 40 units
const LOD_CULL = 80; // Don't render beyond 80 units
const SPRITE_SIZE = 1.2;
function init(sceneRef, cameraRef) {
_scene = sceneRef;
_camera = cameraRef;
// Create shared sprite material
const canvas = document.createElement('canvas');
canvas.width = 64;
canvas.height = 64;
const ctx = canvas.getContext('2d');
// Simple avatar indicator: colored circle
ctx.fillStyle = '#00ffcc';
ctx.beginPath();
ctx.arc(32, 32, 20, 0, Math.PI * 2);
ctx.fill();
ctx.fillStyle = '#0a0f1a';
ctx.beginPath();
ctx.arc(32, 28, 8, 0, Math.PI * 2); // head
ctx.fill();
const texture = new THREE.CanvasTexture(canvas);
_spriteMaterial = new THREE.SpriteMaterial({
map: texture,
transparent: true,
depthTest: true,
sizeAttenuation: true,
});
console.log('[LODSystem] Initialized');
}
function registerAvatar(avatarMesh, userId, color) {
// Create billboard sprite for this avatar
const spriteMat = _spriteMaterial.clone();
if (color) {
// Tint sprite to match avatar color
const canvas = document.createElement('canvas');
canvas.width = 64;
canvas.height = 64;
const ctx = canvas.getContext('2d');
ctx.fillStyle = color;
ctx.beginPath();
ctx.arc(32, 32, 20, 0, Math.PI * 2);
ctx.fill();
ctx.fillStyle = '#0a0f1a';
ctx.beginPath();
ctx.arc(32, 28, 8, 0, Math.PI * 2);
ctx.fill();
spriteMat.map = new THREE.CanvasTexture(canvas);
spriteMat.map.needsUpdate = true;
}
const sprite = new THREE.Sprite(spriteMat);
sprite.scale.set(SPRITE_SIZE, SPRITE_SIZE, 1);
sprite.visible = false;
_scene.add(sprite);
_registered.set(userId, {
mesh: avatarMesh,
sprite: sprite,
distance: Infinity,
});
}
function unregisterAvatar(userId) {
const entry = _registered.get(userId);
if (entry) {
_scene.remove(entry.sprite);
entry.sprite.material.dispose();
_registered.delete(userId);
}
}
function setSpriteColor(userId, color) {
const entry = _registered.get(userId);
if (!entry) return;
const canvas = document.createElement('canvas');
canvas.width = 64;
canvas.height = 64;
const ctx = canvas.getContext('2d');
ctx.fillStyle = color;
ctx.beginPath();
ctx.arc(32, 32, 20, 0, Math.PI * 2);
ctx.fill();
ctx.fillStyle = '#0a0f1a';
ctx.beginPath();
ctx.arc(32, 28, 8, 0, Math.PI * 2);
ctx.fill();
entry.sprite.material.map = new THREE.CanvasTexture(canvas);
entry.sprite.material.map.needsUpdate = true;
}
function update(playerPos) {
if (!_camera) return;
// Update frustum for culling
_projScreenMatrix.multiplyMatrices(
_camera.projectionMatrix,
_camera.matrixWorldInverse
);
_frustum.setFromProjectionMatrix(_projScreenMatrix);
_registered.forEach((entry, userId) => {
if (!entry.mesh) return;
const meshPos = entry.mesh.position;
const distance = playerPos.distanceTo(meshPos);
entry.distance = distance;
// Beyond cull distance: hide everything
if (distance > LOD_CULL) {
entry.mesh.visible = false;
entry.sprite.visible = false;
return;
}
// Check if in camera frustum
const inFrustum = _frustum.containsPoint(meshPos);
if (!inFrustum) {
entry.mesh.visible = false;
entry.sprite.visible = false;
return;
}
// LOD switching
if (distance <= LOD_NEAR) {
// Near: full mesh
entry.mesh.visible = true;
entry.sprite.visible = false;
} else if (distance <= LOD_FAR) {
// Mid: mesh with reduced detail (keep mesh visible)
entry.mesh.visible = true;
entry.sprite.visible = false;
} else {
// Far: billboard sprite
entry.mesh.visible = false;
entry.sprite.visible = true;
entry.sprite.position.copy(meshPos);
entry.sprite.position.y += 1.2; // above avatar center
}
});
}
function getStats() {
let meshCount = 0;
let spriteCount = 0;
let culledCount = 0;
_registered.forEach(entry => {
if (entry.mesh.visible) meshCount++;
else if (entry.sprite.visible) spriteCount++;
else culledCount++;
});
return { total: _registered.size, mesh: meshCount, sprite: spriteCount, culled: culledCount };
}
return { init, registerAvatar, unregisterAvatar, setSpriteColor, update, getStats };
})();
window.LODSystem = LODSystem;

View File

@@ -1,229 +0,0 @@
#!/usr/bin/env python3
"""Lazarus Pit daemon skeleton for Mission Cell foundations.
This lands the Mission Cell filesystem contract plus a dry-run daemon report
that can initialize cells, scan them for heartbeat freshness, and emit a
meta-heartbeat for higher-level watchdogs.
Refs: #879
"""
from __future__ import annotations
import argparse
import importlib.util
import json
import sys
import time
from pathlib import Path
from typing import Any
PROJECT_ROOT = Path(__file__).resolve().parent.parent
_hb_spec = importlib.util.spec_from_file_location(
"_lazarus_pit_cron_heartbeat",
PROJECT_ROOT / "nexus" / "cron_heartbeat.py",
)
_hb = importlib.util.module_from_spec(_hb_spec)
sys.modules["_lazarus_pit_cron_heartbeat"] = _hb
_hb_spec.loader.exec_module(_hb)
write_cron_heartbeat = _hb.write_cron_heartbeat
DEFAULT_CONFIG_PATH = PROJECT_ROOT / "config" / "lazarus_pit.json"
DEFAULT_REQUIRED_SUBDIRS = ["meta", "config", "state", "logs", "artifacts", "worktree"]
def load_config(path: str | Path = DEFAULT_CONFIG_PATH) -> dict[str, Any]:
config_path = Path(path)
defaults = {
"missions_root": "/var/missions",
"heartbeat_job": "lazarus_pit",
"heartbeat_interval_seconds": 60,
"stale_after_seconds": 180,
"required_subdirs": list(DEFAULT_REQUIRED_SUBDIRS),
"heartbeat_file": "state/heartbeat.json",
}
if not config_path.exists():
return defaults
loaded = json.loads(config_path.read_text())
defaults.update(loaded)
if not defaults.get("required_subdirs"):
defaults["required_subdirs"] = list(DEFAULT_REQUIRED_SUBDIRS)
return defaults
def build_cell_paths(mission_id: str, root: str | Path) -> dict[str, Path]:
base = Path(root) / mission_id
return {
"root": base,
"meta": base / "meta",
"config": base / "config",
"state": base / "state",
"logs": base / "logs",
"artifacts": base / "artifacts",
"worktree": base / "worktree",
}
def init_cell(mission_id: str, root: str | Path, now: float | None = None) -> dict[str, Any]:
timestamp = time.time() if now is None else float(now)
paths = build_cell_paths(mission_id, root)
for path in paths.values():
if path.name != mission_id:
path.mkdir(parents=True, exist_ok=True)
paths["root"].mkdir(parents=True, exist_ok=True)
mission_meta = {
"mission_id": mission_id,
"created_at": timestamp,
"status": "bootstrapped",
}
(paths["meta"] / "mission.json").write_text(json.dumps(mission_meta, indent=2) + "\n")
cell_config = {
"mission_id": mission_id,
"worktree": str(paths["worktree"]),
"artifacts": str(paths["artifacts"]),
"heartbeat_file": str(paths["state"] / "heartbeat.json"),
}
(paths["config"] / "cell.json").write_text(json.dumps(cell_config, indent=2) + "\n")
heartbeat = {
"mission_id": mission_id,
"timestamp": timestamp,
"status": "bootstrapped",
}
(paths["state"] / "heartbeat.json").write_text(json.dumps(heartbeat, indent=2) + "\n")
(paths["logs"] / "daemon.log").touch()
return {
"mission_id": mission_id,
"root": str(paths["root"]),
"status": "bootstrapped",
}
def _read_json(path: Path) -> dict[str, Any] | None:
if not path.exists():
return None
try:
return json.loads(path.read_text())
except json.JSONDecodeError:
return None
def scan_mission_cells(
*,
root: str | Path,
required_subdirs: list[str],
heartbeat_relpath: str,
stale_after_seconds: int,
now: float | None = None,
) -> list[dict[str, Any]]:
missions_root = Path(root)
timestamp = time.time() if now is None else float(now)
if not missions_root.exists():
return []
cells: list[dict[str, Any]] = []
for entry in sorted(missions_root.iterdir()):
if not entry.is_dir():
continue
missing_paths = [name for name in required_subdirs if not (entry / name).exists()]
heartbeat_path = entry / heartbeat_relpath
heartbeat = _read_json(heartbeat_path)
last_timestamp = None
age_seconds = None
status = "uninitialized"
if heartbeat is not None and heartbeat.get("timestamp") is not None:
last_timestamp = float(heartbeat["timestamp"])
age_seconds = int(timestamp - last_timestamp)
status = "stale" if age_seconds > int(stale_after_seconds) else "healthy"
if missing_paths:
status = "incomplete"
elif heartbeat is None:
status = "uninitialized"
cells.append(
{
"mission_id": entry.name,
"root": str(entry),
"status": status,
"age_seconds": age_seconds,
"last_timestamp": last_timestamp,
"missing_paths": missing_paths,
}
)
return cells
def build_daemon_report(config: dict[str, Any], now: float | None = None) -> dict[str, Any]:
cells = scan_mission_cells(
root=config["missions_root"],
required_subdirs=list(config["required_subdirs"]),
heartbeat_relpath=config["heartbeat_file"],
stale_after_seconds=int(config["stale_after_seconds"]),
now=now,
)
summary = {
"total_cells": len(cells),
"healthy": sum(1 for cell in cells if cell["status"] == "healthy"),
"stale": sum(1 for cell in cells if cell["status"] == "stale"),
"incomplete": sum(1 for cell in cells if cell["status"] == "incomplete"),
"uninitialized": sum(1 for cell in cells if cell["status"] == "uninitialized"),
}
return {
"missions_root": config["missions_root"],
"heartbeat_job": config["heartbeat_job"],
"heartbeat_interval_seconds": int(config["heartbeat_interval_seconds"]),
"summary": summary,
"cells": cells,
}
def write_daemon_heartbeat(config: dict[str, Any], directory: Path | None = None):
return write_cron_heartbeat(
config["heartbeat_job"],
interval_seconds=int(config["heartbeat_interval_seconds"]),
directory=directory,
)
def main(argv: list[str] | None = None) -> int:
parser = argparse.ArgumentParser(description="Lazarus Pit daemon skeleton")
parser.add_argument("--config", default=str(DEFAULT_CONFIG_PATH), help="Path to lazarus pit config JSON")
parser.add_argument("--root", help="Override missions root directory")
parser.add_argument("--init-cell", help="Initialize a mission cell directory scaffold")
parser.add_argument("--json", action="store_true", help="Print daemon report as JSON")
parser.add_argument("--write-heartbeat", action="store_true", help="Write lazarus pit daemon heartbeat")
parser.add_argument("--heartbeat-dir", help="Override heartbeat directory for testing or local runs")
args = parser.parse_args(argv)
config = load_config(args.config)
if args.root:
config["missions_root"] = args.root
if args.init_cell:
init_cell(args.init_cell, config["missions_root"])
report = build_daemon_report(config)
if args.write_heartbeat:
hb_dir = Path(args.heartbeat_dir) if args.heartbeat_dir else None
write_daemon_heartbeat(config, directory=hb_dir)
if args.json:
print(json.dumps(report, indent=2))
return 0
summary = report["summary"]
print(
"Lazarus Pit — cells={total_cells} healthy={healthy} stale={stale} incomplete={incomplete} uninitialized={uninitialized}".format(
**summary
)
)
return 0
if __name__ == "__main__":
raise SystemExit(main())

View File

@@ -4,48 +4,61 @@ Sync branch protection rules from .gitea/branch-protection/*.yml to Gitea.
Correctly uses the Gitea 1.25+ API (not GitHub-style).
"""
from __future__ import annotations
import json
import os
import sys
import json
import urllib.request
from pathlib import Path
import yaml
GITEA_URL = os.getenv("GITEA_URL", "https://forge.alexanderwhitestone.com")
GITEA_TOKEN = os.getenv("GITEA_TOKEN", "")
ORG = "Timmy_Foundation"
CONFIG_DIR = ".gitea/branch-protection"
PROJECT_ROOT = Path(__file__).resolve().parent.parent
CONFIG_DIR = PROJECT_ROOT / ".gitea" / "branch-protection"
def api_request(method: str, path: str, payload: dict | None = None) -> dict:
url = f"{GITEA_URL}/api/v1{path}"
data = json.dumps(payload).encode() if payload else None
req = urllib.request.Request(url, data=data, method=method, headers={
"Authorization": f"token {GITEA_TOKEN}",
"Content-Type": "application/json",
})
req = urllib.request.Request(
url,
data=data,
method=method,
headers={
"Authorization": f"token {GITEA_TOKEN}",
"Content-Type": "application/json",
},
)
with urllib.request.urlopen(req, timeout=30) as resp:
return json.loads(resp.read().decode())
def apply_protection(repo: str, rules: dict) -> bool:
branch = rules.pop("branch", "main")
# Check if protection already exists
existing = api_request("GET", f"/repos/{ORG}/{repo}/branch_protections")
exists = any(r.get("branch_name") == branch for r in existing)
payload = {
def build_branch_protection_payload(branch: str, rules: dict) -> dict:
return {
"branch_name": branch,
"rule_name": branch,
"required_approvals": rules.get("required_approvals", 1),
"block_on_rejected_reviews": rules.get("block_on_rejected_reviews", True),
"dismiss_stale_approvals": rules.get("dismiss_stale_approvals", True),
"block_deletions": rules.get("block_deletions", True),
"block_force_push": rules.get("block_force_push", True),
"block_force_push": rules.get("block_force_push", rules.get("block_force_pushes", True)),
"block_admin_merge_override": rules.get("block_admin_merge_override", True),
"enable_status_check": rules.get("require_ci_to_merge", False),
"status_check_contexts": rules.get("status_check_contexts", []),
"block_on_outdated_branch": rules.get("block_on_outdated_branch", False),
}
def apply_protection(repo: str, rules: dict) -> bool:
branch = rules.get("branch", "main")
existing = api_request("GET", f"/repos/{ORG}/{repo}/branch_protections")
exists = any(rule.get("branch_name") == branch for rule in existing)
payload = build_branch_protection_payload(branch, rules)
try:
if exists:
api_request("PATCH", f"/repos/{ORG}/{repo}/branch_protections/{branch}", payload)
@@ -53,8 +66,8 @@ def apply_protection(repo: str, rules: dict) -> bool:
api_request("POST", f"/repos/{ORG}/{repo}/branch_protections", payload)
print(f"{repo}:{branch} synced")
return True
except Exception as e:
print(f"{repo}:{branch} failed: {e}")
except Exception as exc:
print(f"{repo}:{branch} failed: {exc}")
return False
@@ -62,15 +75,18 @@ def main() -> int:
if not GITEA_TOKEN:
print("ERROR: GITEA_TOKEN not set")
return 1
if not CONFIG_DIR.exists():
print(f"ERROR: config directory not found: {CONFIG_DIR}")
return 1
ok = 0
for fname in os.listdir(CONFIG_DIR):
if not fname.endswith(".yml"):
continue
repo = fname[:-4]
with open(os.path.join(CONFIG_DIR, fname)) as f:
cfg = yaml.safe_load(f)
if apply_protection(repo, cfg.get("rules", {})):
for cfg_path in sorted(CONFIG_DIR.glob("*.yml")):
repo = cfg_path.stem
with cfg_path.open() as fh:
cfg = yaml.safe_load(fh) or {}
rules = cfg.get("rules", {})
rules.setdefault("branch", cfg.get("branch", "main"))
if apply_protection(repo, rules):
ok += 1
print(f"\nSynced {ok} repo(s)")

View File

@@ -1,127 +0,0 @@
from __future__ import annotations
import importlib.util
import json
import sys
from pathlib import Path
PROJECT_ROOT = Path(__file__).parent.parent
_spec = importlib.util.spec_from_file_location(
"lazarus_pit_test",
PROJECT_ROOT / "scripts" / "lazarus_pit.py",
)
_mod = importlib.util.module_from_spec(_spec)
sys.modules["lazarus_pit_test"] = _mod
_spec.loader.exec_module(_mod)
build_cell_paths = _mod.build_cell_paths
build_daemon_report = _mod.build_daemon_report
init_cell = _mod.init_cell
load_config = _mod.load_config
scan_mission_cells = _mod.scan_mission_cells
write_daemon_heartbeat = _mod.write_daemon_heartbeat
def test_init_cell_creates_foundation_structure(tmp_path):
mission_id = "123e4567-e89b-12d3-a456-426614174000"
cell = init_cell(mission_id, root=tmp_path, now=1_700_000_000)
paths = build_cell_paths(mission_id, tmp_path)
for key in ["meta", "config", "state", "logs", "artifacts", "worktree"]:
assert paths[key].is_dir(), f"expected {key} directory to exist"
meta = json.loads((paths["meta"] / "mission.json").read_text())
assert meta["mission_id"] == mission_id
assert meta["status"] == "bootstrapped"
heartbeat = json.loads((paths["state"] / "heartbeat.json").read_text())
assert heartbeat["mission_id"] == mission_id
assert heartbeat["status"] == "bootstrapped"
assert cell["root"] == str(paths["root"])
def test_scan_mission_cells_marks_healthy_and_stale(tmp_path):
healthy_id = "healthy-cell"
stale_id = "stale-cell"
init_cell(healthy_id, root=tmp_path, now=1_700_000_000)
init_cell(stale_id, root=tmp_path, now=1_700_000_000)
healthy_paths = build_cell_paths(healthy_id, tmp_path)
stale_paths = build_cell_paths(stale_id, tmp_path)
(healthy_paths["state"] / "heartbeat.json").write_text(
json.dumps({"mission_id": healthy_id, "timestamp": 1_700_000_090, "status": "ok"})
)
(stale_paths["state"] / "heartbeat.json").write_text(
json.dumps({"mission_id": stale_id, "timestamp": 1_700_000_000, "status": "ok"})
)
cells = scan_mission_cells(
root=tmp_path,
required_subdirs=["meta", "config", "state", "logs", "artifacts", "worktree"],
heartbeat_relpath="state/heartbeat.json",
stale_after_seconds=60,
now=1_700_000_100,
)
by_id = {cell["mission_id"]: cell for cell in cells}
assert by_id[healthy_id]["status"] == "healthy"
assert by_id[healthy_id]["age_seconds"] == 10
assert by_id[stale_id]["status"] == "stale"
assert by_id[stale_id]["age_seconds"] == 100
def test_build_daemon_report_and_write_heartbeat(tmp_path):
config_path = tmp_path / "lazarus_pit.json"
config_path.write_text(
json.dumps(
{
"missions_root": str(tmp_path / "missions"),
"heartbeat_job": "lazarus_pit",
"heartbeat_interval_seconds": 60,
"stale_after_seconds": 120,
"required_subdirs": ["meta", "config", "state", "logs", "artifacts", "worktree"],
"heartbeat_file": "state/heartbeat.json",
}
)
)
config = load_config(config_path)
init_cell("mission-one", root=Path(config["missions_root"]), now=2_000)
paths = build_cell_paths("mission-one", Path(config["missions_root"]))
(paths["state"] / "heartbeat.json").write_text(
json.dumps({"mission_id": "mission-one", "timestamp": 2_050, "status": "ok"})
)
report = build_daemon_report(config, now=2_100)
assert report["summary"]["total_cells"] == 1
assert report["summary"]["healthy"] == 1
assert report["summary"]["stale"] == 0
assert report["cells"][0]["mission_id"] == "mission-one"
heartbeat_path = write_daemon_heartbeat(config, directory=tmp_path / "heartbeats")
heartbeat = json.loads(heartbeat_path.read_text())
assert heartbeat["job"] == "lazarus_pit"
assert heartbeat["interval_seconds"] == 60
def test_foundation_artifacts_exist_with_required_spec():
doc = PROJECT_ROOT / "docs" / "mission-cell-spec.md"
config = PROJECT_ROOT / "config" / "lazarus_pit.json"
assert doc.exists(), "expected mission cell spec doc"
assert config.exists(), "expected lazarus pit config"
content = doc.read_text()
for snippet in [
"/var/missions/<uuid>/",
"meta/mission.json",
"config/cell.json",
"state/heartbeat.json",
"logs/daemon.log",
"artifacts/",
"worktree/",
]:
assert snippet in content

View File

@@ -0,0 +1,45 @@
from __future__ import annotations
import importlib.util
import sys
from pathlib import Path
import yaml
PROJECT_ROOT = Path(__file__).parent.parent
_spec = importlib.util.spec_from_file_location(
"sync_branch_protection_test",
PROJECT_ROOT / "scripts" / "sync_branch_protection.py",
)
_mod = importlib.util.module_from_spec(_spec)
sys.modules["sync_branch_protection_test"] = _mod
_spec.loader.exec_module(_mod)
build_branch_protection_payload = _mod.build_branch_protection_payload
def test_build_branch_protection_payload_enables_rebase_before_merge():
payload = build_branch_protection_payload(
"main",
{
"required_approvals": 1,
"dismiss_stale_approvals": True,
"require_ci_to_merge": False,
"block_deletions": True,
"block_force_push": True,
"block_on_outdated_branch": True,
},
)
assert payload["branch_name"] == "main"
assert payload["rule_name"] == "main"
assert payload["block_on_outdated_branch"] is True
assert payload["required_approvals"] == 1
assert payload["enable_status_check"] is False
def test_the_nexus_branch_protection_config_requires_up_to_date_branch():
config = yaml.safe_load((PROJECT_ROOT / ".gitea" / "branch-protection" / "the-nexus.yml").read_text())
rules = config["rules"]
assert rules["block_on_outdated_branch"] is True