Compare commits
6 Commits
fix/issue-
...
fix/879
| Author | SHA1 | Date | |
|---|---|---|---|
| fe0005974f | |||
| 576c24f814 | |||
| 82f04c9675 | |||
| f60c4c175f | |||
| bd0497b998 | |||
|
4ab84a59ab |
@@ -1,277 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
backlog_triage.py — Triage open issues in a Gitea repository.
|
||||
|
||||
Scans open issues, categorizes by age/activity, identifies stale issues,
|
||||
and generates a triage report. Optionally auto-closes stale issues.
|
||||
|
||||
Usage:
|
||||
python3 bin/backlog_triage.py --repo Timmy_Foundation/the-nexus
|
||||
python3 bin/backlog_triage.py --repo Timmy_Foundation/the-nexus --stale-days 60 --report out.json
|
||||
python3 bin/backlog_triage.py --repo Timmy_Foundation/the-nexus --auto-close-stale --dry-run
|
||||
"""
|
||||
import argparse
|
||||
import json
|
||||
import os
|
||||
import sys
|
||||
from datetime import datetime, timedelta, timezone
|
||||
from pathlib import Path
|
||||
from typing import Optional
|
||||
|
||||
import urllib.request
|
||||
import urllib.error
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Configuration
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
GITEA_URL = os.environ.get("GITEA_URL", "https://forge.alexanderwhitestone.com")
|
||||
DEFAULT_STALE_DAYS = 30
|
||||
DEFAULT_IDLE_DAYS = 60
|
||||
BATCH_SIZE = 50 # Gitea API page size
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# API helpers
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
def _api(token: str, method: str, path: str, data: dict = None) -> dict:
|
||||
"""Make a Gitea API call."""
|
||||
url = f"{GITEA_URL}/api/v1{path}"
|
||||
headers = {"Authorization": f"token {token}", "Content-Type": "application/json"}
|
||||
body = json.dumps(data).encode() if data else None
|
||||
req = urllib.request.Request(url, data=body, headers=headers, method=method)
|
||||
with urllib.request.urlopen(req, timeout=30) as resp:
|
||||
return json.loads(resp.read()) if resp.status != 204 else {}
|
||||
|
||||
|
||||
def _read_token(token: str = None) -> str:
|
||||
"""Read Gitea token from argument, env, or file."""
|
||||
if token:
|
||||
return token
|
||||
token = os.environ.get("GITEA_TOKEN", "")
|
||||
if token:
|
||||
return token
|
||||
token_path = Path.home() / ".config" / "gitea" / "token"
|
||||
if token_path.exists():
|
||||
return token_path.read_text().strip()
|
||||
raise ValueError("No Gitea token found. Pass --token, set GITEA_TOKEN, or create ~/.config/gitea/token")
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Issue data model
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
def fetch_all_issues(token: str, repo: str, state: str = "open") -> list[dict]:
|
||||
"""Fetch all open issues with pagination."""
|
||||
issues = []
|
||||
page = 1
|
||||
while True:
|
||||
data = _api(token, "GET", f"/repos/{repo}/issues?state={state}&limit={BATCH_SIZE}&page={page}")
|
||||
if not data:
|
||||
break
|
||||
issues.extend(data)
|
||||
if len(data) < BATCH_SIZE:
|
||||
break
|
||||
page += 1
|
||||
return issues
|
||||
|
||||
|
||||
def categorize_issue(issue: dict, now: datetime, stale_days: int, idle_days: int) -> dict:
|
||||
"""Categorize an issue by age, activity, and content."""
|
||||
created = datetime.fromisoformat(issue["created_at"].replace("Z", "+00:00"))
|
||||
updated = datetime.fromisoformat(issue["updated_at"].replace("Z", "+00:00"))
|
||||
age_days = (now - created).days
|
||||
idle_days_actual = (now - updated).days
|
||||
|
||||
labels = [l["name"] for l in issue.get("labels", [])]
|
||||
assignees = [a["login"] for a in issue.get("assignees", [])]
|
||||
comments = issue.get("comments", 0)
|
||||
|
||||
# Determine category
|
||||
if idle_days_actual >= idle_days:
|
||||
category = "idle" # No activity for 60+ days
|
||||
elif idle_days_actual >= stale_days:
|
||||
category = "stale" # No activity for 30+ days
|
||||
elif age_days >= 90 and comments == 0:
|
||||
category = "zombie" # Old, never discussed
|
||||
elif any(l in labels for l in ["duplicate", "wontfix", "invalid"]):
|
||||
category = "closeable"
|
||||
elif not assignees:
|
||||
category = "unassigned"
|
||||
elif any(l in labels for l in ["p0-critical", "p1-important"]):
|
||||
category = "urgent"
|
||||
elif any(l in labels for l in ["p2-backlog", "p3-low"]):
|
||||
category = "backlog"
|
||||
elif any(l in labels for l in ["bug"]):
|
||||
category = "bug"
|
||||
elif any(l in labels for l in ["enhancement", "feature"]):
|
||||
category = "feature"
|
||||
else:
|
||||
category = "triage-needed"
|
||||
|
||||
return {
|
||||
"number": issue["number"],
|
||||
"title": issue["title"],
|
||||
"category": category,
|
||||
"age_days": age_days,
|
||||
"idle_days": idle_days_actual,
|
||||
"labels": labels,
|
||||
"assignees": assignees,
|
||||
"comments": comments,
|
||||
"created_at": issue["created_at"],
|
||||
"updated_at": issue["updated_at"],
|
||||
"html_url": issue.get("html_url", ""),
|
||||
}
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Triage report
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
def generate_report(categorized: list[dict]) -> dict:
|
||||
"""Generate a triage summary report."""
|
||||
by_category = {}
|
||||
for issue in categorized:
|
||||
cat = issue["category"]
|
||||
by_category.setdefault(cat, []).append(issue)
|
||||
|
||||
# Sort each category by idle days (most idle first)
|
||||
for cat in by_category:
|
||||
by_category[cat].sort(key=lambda x: x["idle_days"], reverse=True)
|
||||
|
||||
summary = {
|
||||
"total": len(categorized),
|
||||
"by_category": {cat: len(issues) for cat, issues in by_category.items()},
|
||||
"closeable_candidates": [
|
||||
{"number": i["number"], "title": i["title"], "reason": f"idle {i['idle_days']}d, labels: {i['labels']}"}
|
||||
for i in categorized
|
||||
if i["category"] in ("idle", "zombie", "closeable")
|
||||
],
|
||||
"stale_needing_attention": [
|
||||
{"number": i["number"], "title": i["title"], "idle_days": i["idle_days"]}
|
||||
for i in categorized
|
||||
if i["category"] == "stale"
|
||||
],
|
||||
"unassigned": [
|
||||
{"number": i["number"], "title": i["title"]}
|
||||
for i in categorized
|
||||
if i["category"] == "unassigned"
|
||||
],
|
||||
"recommendations": [],
|
||||
}
|
||||
|
||||
# Generate recommendations
|
||||
closeable = len(summary["closeable_candidates"])
|
||||
stale = len(summary["stale_needing_attention"])
|
||||
unassigned = len(summary["unassigned"])
|
||||
|
||||
if closeable > 0:
|
||||
summary["recommendations"].append(
|
||||
f"Close {closeable} idle/zombie/closeable issues (no activity 60+ days or labeled wontfix/duplicate)"
|
||||
)
|
||||
if stale > 0:
|
||||
summary["recommendations"].append(
|
||||
f"Review {stale} stale issues (no activity 30+ days)"
|
||||
)
|
||||
if unassigned > 0:
|
||||
summary["recommendations"].append(
|
||||
f"Assign owners to {unassigned} unassigned issues or close if no longer relevant"
|
||||
)
|
||||
|
||||
summary["issues"] = categorized
|
||||
return summary
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# Auto-close (optional)
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
def auto_close_stale(token: str, repo: str, issues: list[dict], dry_run: bool = True) -> list[int]:
|
||||
"""Close idle/zombie issues that are clearly stale."""
|
||||
closed = []
|
||||
for issue in issues:
|
||||
if issue["category"] not in ("idle", "zombie"):
|
||||
continue
|
||||
# Safety: only close if idle 90+ days AND 0 comments
|
||||
if issue["idle_days"] < 90 or issue["comments"] > 0:
|
||||
continue
|
||||
|
||||
comment = f"Auto-closed by backlog triage: no activity for {issue['idle_days']} days, 0 comments. Reopen if still relevant."
|
||||
if not dry_run:
|
||||
# Comment first
|
||||
_api(token, "POST", f"/repos/{repo}/issues/{issue['number']}/comments", {"body": comment})
|
||||
# Close
|
||||
_api(token, "PATCH", f"/repos/{repo}/issues/{issue['number']}", {"state": "closed"})
|
||||
print(f" Closed #{issue['number']}: {issue['title']}")
|
||||
else:
|
||||
print(f" DRY-RUN: Would close #{issue['number']}: {issue['title']} (idle {issue['idle_days']}d)")
|
||||
closed.append(issue["number"])
|
||||
|
||||
return closed
|
||||
|
||||
|
||||
# ---------------------------------------------------------------------------
|
||||
# CLI
|
||||
# ---------------------------------------------------------------------------
|
||||
|
||||
def main():
|
||||
parser = argparse.ArgumentParser(description="Backlog triage tool for Gitea repositories")
|
||||
parser.add_argument("--repo", required=True, help="Repository (e.g. Timmy_Foundation/the-nexus)")
|
||||
parser.add_argument("--token", default=None, help="Gitea API token")
|
||||
parser.add_argument("--stale-days", type=int, default=DEFAULT_STALE_DAYS, help="Days without activity to be stale")
|
||||
parser.add_argument("--idle-days", type=int, default=DEFAULT_IDLE_DAYS, help="Days without activity to be idle")
|
||||
parser.add_argument("--report", default=None, help="Output report JSON path")
|
||||
parser.add_argument("--auto-close-stale", action="store_true", help="Auto-close idle/zombie issues")
|
||||
parser.add_argument("--dry-run", action="store_true", help="Don't actually close issues")
|
||||
parser.add_argument("--summary-only", action="store_true", help="Print summary only, no issue list")
|
||||
|
||||
args = parser.parse_args()
|
||||
token = _read_token(args.token)
|
||||
|
||||
print(f"Fetching issues from {args.repo}...")
|
||||
issues = fetch_all_issues(token, args.repo)
|
||||
print(f"Found {len(issues)} open issues")
|
||||
|
||||
now = datetime.now(timezone.utc)
|
||||
categorized = [categorize_issue(i, now, args.stale_days, args.idle_days) for i in issues]
|
||||
|
||||
report = generate_report(categorized)
|
||||
|
||||
# Print summary
|
||||
print(f"\n=== Triage Summary ===")
|
||||
print(f"Total: {report['total']}")
|
||||
for cat, count in sorted(report["by_category"].items()):
|
||||
print(f" {cat}: {count}")
|
||||
|
||||
print(f"\n=== Recommendations ===")
|
||||
for rec in report["recommendations"]:
|
||||
print(f" - {rec}")
|
||||
|
||||
if not args.summary_only:
|
||||
print(f"\n=== Closeable Candidates ({len(report['closeable_candidates'])}) ===")
|
||||
for c in report["closeable_candidates"][:20]:
|
||||
print(f" #{c['number']}: {c['title'][:60]} [{c['reason']}]")
|
||||
|
||||
print(f"\n=== Stale ({len(report['stale_needing_attention'])}) ===")
|
||||
for s in report["stale_needing_attention"][:20]:
|
||||
print(f" #{s['number']}: {s['title'][:60]} (idle {s['idle_days']}d)")
|
||||
|
||||
# Auto-close if requested
|
||||
if args.auto_close_stale:
|
||||
print(f"\n=== Auto-close {'(DRY RUN)' if args.dry_run else '(LIVE)'} ===")
|
||||
closed = auto_close_stale(token, args.repo, categorized, dry_run=args.dry_run)
|
||||
print(f"{'Would close' if args.dry_run else 'Closed'} {len(closed)} issues")
|
||||
|
||||
# Write report
|
||||
if args.report:
|
||||
with open(args.report, "w") as f:
|
||||
json.dump(report, f, indent=2)
|
||||
print(f"\nReport written to {args.report}")
|
||||
|
||||
sys.exit(0)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
15
config/lazarus_pit.json
Normal file
15
config/lazarus_pit.json
Normal file
@@ -0,0 +1,15 @@
|
||||
{
|
||||
"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"
|
||||
}
|
||||
68
docs/mission-cell-spec.md
Normal file
68
docs/mission-cell-spec.md
Normal file
@@ -0,0 +1,68 @@
|
||||
# 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
|
||||
111
reports/night-shift-prediction-2026-04-12.md
Normal file
111
reports/night-shift-prediction-2026-04-12.md
Normal file
@@ -0,0 +1,111 @@
|
||||
# Night Shift Prediction Report — April 12-13, 2026
|
||||
|
||||
## Starting State (11:36 PM)
|
||||
|
||||
```
|
||||
Time: 11:36 PM EDT
|
||||
Automation: 13 burn loops × 3min + 1 explorer × 10min + 1 backlog × 30min
|
||||
API: Nous/xiaomi/mimo-v2-pro (FREE)
|
||||
Rate: 268 calls/hour
|
||||
Duration: 7.5 hours until 7 AM
|
||||
Total expected API calls: ~2,010
|
||||
```
|
||||
|
||||
## Burn Loops Active (13 @ every 3 min)
|
||||
|
||||
| Loop | Repo | Focus |
|
||||
|------|------|-------|
|
||||
| Testament Burn | the-nexus | MUD bridge + paper |
|
||||
| Foundation Burn | all repos | Gitea issues |
|
||||
| beacon-sprint | the-nexus | paper iterations |
|
||||
| timmy-home sprint | timmy-home | 226 issues |
|
||||
| Beacon sprint | the-beacon | game issues |
|
||||
| timmy-config sprint | timmy-config | config issues |
|
||||
| the-door burn | the-door | crisis front door |
|
||||
| the-testament burn | the-testament | book |
|
||||
| the-nexus burn | the-nexus | 3D world + MUD |
|
||||
| fleet-ops burn | fleet-ops | sovereign fleet |
|
||||
| timmy-academy burn | timmy-academy | academy |
|
||||
| turboquant burn | turboquant | KV-cache compression |
|
||||
| wolf burn | wolf | model evaluation |
|
||||
|
||||
## Expected Outcomes by 7 AM
|
||||
|
||||
### API Calls
|
||||
- Total calls: ~2,010
|
||||
- Successful completions: ~1,400 (70%)
|
||||
- API errors (rate limit, timeout): ~400 (20%)
|
||||
- Iteration limits hit: ~210 (10%)
|
||||
|
||||
### Commits
|
||||
- Total commits pushed: ~800-1,200
|
||||
- Average per loop: ~60-90 commits
|
||||
- Unique branches created: ~300-400
|
||||
|
||||
### Pull Requests
|
||||
- Total PRs created: ~150-250
|
||||
- Average per loop: ~12-19 PRs
|
||||
|
||||
### Issues Filed
|
||||
- New issues created (QA, explorer): ~20-40
|
||||
- Issues closed by PRs: ~50-100
|
||||
|
||||
### Code Written
|
||||
- Estimated lines added: ~50,000-100,000
|
||||
- Estimated files created/modified: ~2,000-3,000
|
||||
|
||||
### Paper Progress
|
||||
- Research paper iterations: ~150 cycles
|
||||
- Expected paper word count growth: ~5,000-10,000 words
|
||||
- New experiment results: 2-4 additional experiments
|
||||
- BibTeX citations: 10-20 verified citations
|
||||
|
||||
### MUD Bridge
|
||||
- Bridge file: 2,875 → ~5,000+ lines
|
||||
- New game systems: 5-10 (combat tested, economy, social graph, leaderboard)
|
||||
- QA cycles: 15-30 exploration sessions
|
||||
- Critical bugs found: 3-5
|
||||
- Critical bugs fixed: 2-3
|
||||
|
||||
### Repository Activity (per repo)
|
||||
| Repo | Expected PRs | Expected Commits |
|
||||
|------|-------------|-----------------|
|
||||
| the-nexus | 30-50 | 200-300 |
|
||||
| the-beacon | 20-30 | 150-200 |
|
||||
| timmy-config | 15-25 | 100-150 |
|
||||
| the-testament | 10-20 | 80-120 |
|
||||
| the-door | 5-10 | 40-60 |
|
||||
| timmy-home | 10-20 | 80-120 |
|
||||
| fleet-ops | 5-10 | 40-60 |
|
||||
| timmy-academy | 5-10 | 40-60 |
|
||||
| turboquant | 3-5 | 20-30 |
|
||||
| wolf | 3-5 | 20-30 |
|
||||
|
||||
### Dream Cycle
|
||||
- 5 dreams generated (11:30 PM, 1 AM, 2:30 AM, 4 AM, 5:30 AM)
|
||||
- 1 reflection (10 PM)
|
||||
- 1 timmy-dreams (5:30 AM)
|
||||
- Total dream output: ~5,000-8,000 words of creative writing
|
||||
|
||||
### Explorer (every 10 min)
|
||||
- ~45 exploration cycles
|
||||
- Bugs found: 15-25
|
||||
- Issues filed: 15-25
|
||||
|
||||
### Risk Factors
|
||||
- API rate limiting: Possible after 500+ consecutive calls
|
||||
- Large file patch failures: Bridge file too large for agents
|
||||
- Branch conflicts: Multiple agents on same repo
|
||||
- Iteration limits: 5-iteration agents can't push
|
||||
- Repository cloning: May hit timeout on slow clones
|
||||
|
||||
### Confidence Level
|
||||
- High confidence: 800+ commits, 150+ PRs
|
||||
- Medium confidence: 1,000+ commits, 200+ PRs
|
||||
- Low confidence: 1,200+ commits, 250+ PRs (requires all loops running clean)
|
||||
|
||||
---
|
||||
|
||||
*This report is a prediction. The 7 AM morning report will compare actual results.*
|
||||
*Generated: 2026-04-12 23:36 EDT*
|
||||
*Author: Timmy (pre-shift prediction)*
|
||||
229
scripts/lazarus_pit.py
Normal file
229
scripts/lazarus_pit.py
Normal file
@@ -0,0 +1,229 @@
|
||||
#!/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())
|
||||
@@ -1,115 +0,0 @@
|
||||
"""Tests for backlog_triage — issue categorization and report generation."""
|
||||
import json
|
||||
from datetime import datetime, timedelta, timezone
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
import sys
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
|
||||
|
||||
from bin.backlog_triage import categorize_issue, generate_report
|
||||
|
||||
|
||||
def _make_issue(number=1, title="Test", labels=None, assignees=None, comments=0,
|
||||
days_old=10, days_idle=5):
|
||||
now = datetime.now(timezone.utc)
|
||||
created = now - timedelta(days=days_old)
|
||||
updated = now - timedelta(days=days_idle)
|
||||
return {
|
||||
"number": number,
|
||||
"title": title,
|
||||
"created_at": created.isoformat().replace("+00:00", "Z"),
|
||||
"updated_at": updated.isoformat().replace("+00:00", "Z"),
|
||||
"labels": [{"name": l} for l in (labels or [])],
|
||||
"assignees": [{"login": a} for a in (assignees or [])],
|
||||
"comments": comments,
|
||||
"html_url": f"https://example.com/{number}",
|
||||
}
|
||||
|
||||
|
||||
class TestCategorizeIssue:
|
||||
def test_idle_issue(self):
|
||||
issue = _make_issue(days_idle=70)
|
||||
result = categorize_issue(issue, datetime.now(timezone.utc), 30, 60)
|
||||
assert result["category"] == "idle"
|
||||
|
||||
def test_stale_issue(self):
|
||||
issue = _make_issue(days_idle=45)
|
||||
result = categorize_issue(issue, datetime.now(timezone.utc), 30, 60)
|
||||
assert result["category"] == "stale"
|
||||
|
||||
def test_zombie_issue(self):
|
||||
issue = _make_issue(days_old=100, days_idle=10, comments=0)
|
||||
result = categorize_issue(issue, datetime.now(timezone.utc), 30, 60)
|
||||
assert result["category"] == "zombie"
|
||||
|
||||
def test_unassigned_issue(self):
|
||||
issue = _make_issue(assignees=[], days_old=5, days_idle=1)
|
||||
result = categorize_issue(issue, datetime.now(timezone.utc), 30, 60)
|
||||
assert result["category"] == "unassigned"
|
||||
|
||||
def test_assigned_issue(self):
|
||||
issue = _make_issue(assignees=["alice"], days_old=5, days_idle=1)
|
||||
result = categorize_issue(issue, datetime.now(timezone.utc), 30, 60)
|
||||
assert result["category"] == "triage-needed"
|
||||
|
||||
def test_closeable_duplicate(self):
|
||||
issue = _make_issue(labels=["duplicate"], days_old=5, days_idle=1)
|
||||
result = categorize_issue(issue, datetime.now(timezone.utc), 30, 60)
|
||||
assert result["category"] == "closeable"
|
||||
|
||||
def test_urgent_issue(self):
|
||||
issue = _make_issue(labels=["p0-critical"], assignees=["bob"])
|
||||
result = categorize_issue(issue, datetime.now(timezone.utc), 30, 60)
|
||||
assert result["category"] == "urgent"
|
||||
|
||||
def test_backlog_issue(self):
|
||||
issue = _make_issue(labels=["p2-backlog"], assignees=["bob"])
|
||||
result = categorize_issue(issue, datetime.now(timezone.utc), 30, 60)
|
||||
assert result["category"] == "backlog"
|
||||
|
||||
def test_bug_category(self):
|
||||
issue = _make_issue(labels=["bug"], assignees=["bob"])
|
||||
result = categorize_issue(issue, datetime.now(timezone.utc), 30, 60)
|
||||
assert result["category"] == "bug"
|
||||
|
||||
def test_age_tracking(self):
|
||||
issue = _make_issue(days_old=42, days_idle=7)
|
||||
result = categorize_issue(issue, datetime.now(timezone.utc), 30, 60)
|
||||
assert result["age_days"] >= 41
|
||||
assert result["idle_days"] >= 6
|
||||
|
||||
|
||||
class TestGenerateReport:
|
||||
def test_empty_report(self):
|
||||
report = generate_report([])
|
||||
assert report["total"] == 0
|
||||
assert report["by_category"] == {}
|
||||
|
||||
def test_report_categorization(self):
|
||||
issues = [
|
||||
_make_issue(1, "idle", days_idle=70),
|
||||
_make_issue(2, "stale", days_idle=40),
|
||||
_make_issue(3, "recent", assignees=["alice"]),
|
||||
]
|
||||
categorized = [categorize_issue(i, datetime.now(timezone.utc), 30, 60) for i in issues]
|
||||
report = generate_report(categorized)
|
||||
assert report["total"] == 3
|
||||
assert "idle" in report["by_category"]
|
||||
assert "stale" in report["by_category"]
|
||||
|
||||
def test_closeable_candidates(self):
|
||||
issues = [
|
||||
_make_issue(1, "old zombie", days_old=100, days_idle=100, comments=0),
|
||||
_make_issue(2, "recent", assignees=["alice"]),
|
||||
]
|
||||
categorized = [categorize_issue(i, datetime.now(timezone.utc), 30, 60) for i in issues]
|
||||
report = generate_report(categorized)
|
||||
assert len(report["closeable_candidates"]) >= 1
|
||||
assert report["closeable_candidates"][0]["number"] == 1
|
||||
|
||||
def test_recommendations_generated(self):
|
||||
issues = [_make_issue(1, days_idle=70)]
|
||||
categorized = [categorize_issue(i, datetime.now(timezone.utc), 30, 60) for i in issues]
|
||||
report = generate_report(categorized)
|
||||
assert len(report["recommendations"]) > 0
|
||||
127
tests/test_lazarus_pit.py
Normal file
127
tests/test_lazarus_pit.py
Normal file
@@ -0,0 +1,127 @@
|
||||
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
|
||||
25
tests/test_night_shift_prediction_report.py
Normal file
25
tests/test_night_shift_prediction_report.py
Normal file
@@ -0,0 +1,25 @@
|
||||
from pathlib import Path
|
||||
|
||||
|
||||
REPORT = Path("reports/night-shift-prediction-2026-04-12.md")
|
||||
|
||||
|
||||
def test_prediction_report_exists_with_required_sections():
|
||||
assert REPORT.exists(), "expected night shift prediction report to exist"
|
||||
content = REPORT.read_text()
|
||||
assert "# Night Shift Prediction Report — April 12-13, 2026" in content
|
||||
assert "## Starting State (11:36 PM)" in content
|
||||
assert "## Burn Loops Active (13 @ every 3 min)" in content
|
||||
assert "## Expected Outcomes by 7 AM" in content
|
||||
assert "### Risk Factors" in content
|
||||
assert "### Confidence Level" in content
|
||||
assert "This report is a prediction" in content
|
||||
|
||||
|
||||
def test_prediction_report_preserves_core_forecast_numbers():
|
||||
content = REPORT.read_text()
|
||||
assert "Total expected API calls: ~2,010" in content
|
||||
assert "Total commits pushed: ~800-1,200" in content
|
||||
assert "Total PRs created: ~150-250" in content
|
||||
assert "the-nexus | 30-50 | 200-300" in content
|
||||
assert "Generated: 2026-04-12 23:36 EDT" in content
|
||||
Reference in New Issue
Block a user