fix(#666 ): make single-repo genome analyzer use canonical template

scripts/genome_analyzer.py now loads templates/GENOME-template.md and populates all {{PLACEHOLDERS}} with auto-discovered repository data: - REPO_NAME, DATE, SHORT_DESCRIPTION from README - OVERVIEW from README with file statistics - ARCHITECTURE_DIAGRAM from directory tree (mermaid) - ENTRY_POINTS from candidate files + scripts/ + src/ - DATA_FLOW, ABSTRACTIONS, API_SURFACE, COVERAGE_GAPS, CRITICAL_PATHS, SECURITY, DESIGN_DECISIONS populated with actionable guidance placeholders for manual analysis The analyzer remains lightweight (single-repo, no external deps) and now produces GENOME.md conformant to the canonical template. Closes #666.
2026-04-29 23:57:35 -04:00
9 changed files with 217 additions and 1097 deletions
--- a/luna/README.md
+++ b/luna/README.md
@@ -1,48 +0,0 @@
-# LUNA-1: Pink Unicorn Game — Project Scaffolding
-
-Starter project for Mackenzie's Pink Unicorn Game built with **p5.js 1.9.0**.
-
-## Quick Start
-
-```bash
-cd luna
-python3 -m http.server 8080
-# Visit http://localhost:8080
-```
-
-Or simply open `luna/index.html` directly in a browser.
-
-## Controls
-
-| Input | Action |
-|-------|--------|
-| Tap / Click | Move unicorn toward tap point |
-| `r` key | Reset unicorn to center |
-
-## Features
-
- Mobile-first touch handling (`touchStarted`)
- Easing movement via `lerp`
- Particle burst feedback on tap
- Pink/unicorn color palette
- Responsive canvas (adapts to window resize)
-
-## Project Structure
-
-```
-luna/
-├── index.html   # p5.js CDN import + canvas container
-├── sketch.js    # Main game logic and rendering
-├── style.css    # Pink/unicorn theme, responsive layout
-└── README.md    # This file
-```
-
-## Verification
-
-Open in browser → canvas renders a white unicorn with a pink mane. Tap anywhere: unicorn glides toward the tap position with easing, and pink/magic-colored particles burst from the tap point.
-
-## Technical Notes
-
- p5.js loaded from CDN (no build step)
- `colorMode(RGB, 255)`; palette defined in code
- Particles are simple fading circles; removed when `life <= 0`
--- a/luna/index.html
+++ b/luna/index.html
@@ -1,18 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>LUNA-3: Simple World — Floating Islands</title>
-  <script src="https://cdnjs.cloudflare.com/ajax/libs/p5.js/1.9.0/p5.min.js"></script>
-  <link rel="stylesheet" href="style.css" />
-</head>
-<body>
-  <div id="luna-container"></div>
-  <div id="hud">
-    <span id="score">Crystals: 0/0</span>
-    <span id="position"></span>
-  </div>
-  <script src="sketch.js"></script>
-</body>
-</html>
--- a/luna/sketch.js
+++ b/luna/sketch.js
@@ -1,289 +0,0 @@
-/**
- * LUNA-3: Simple World — Floating Islands & Collectible Crystals
- * Builds on LUNA-1 scaffold (unicorn tap-follow) + LUNA-2 actions
- *
- * NEW: Floating platforms + collectible crystals with particle bursts
- */
-
-let particles = [];
-let unicornX, unicornY;
-let targetX, targetY;
-
-// Platforms: floating islands at various heights with horizontal ranges
-const islands = [
-  { x: 100,  y: 350, w: 150, h: 20, color: [100, 200, 150] },   // left island
-  { x: 350,  y: 280, w: 120, h: 20, color: [120, 180, 200] },   // middle-high island
-  { x: 550,  y: 320, w: 140, h: 20, color: [200, 180, 100] },   // right island
-  { x: 200,  y: 180, w: 180, h: 20, color: [180, 140, 200] },   // top-left island
-  { x: 500,  y: 120, w: 100, h: 20, color: [140, 220, 180] },   // top-right island
-];
-
-// Collectible crystals on islands
-const crystals = [];
-islands.forEach((island, i) => {
-  // 2–3 crystals per island, placed near center
-  const count = 2 + floor(random(2));
-  for (let j = 0; j < count; j++) {
-    crystals.push({
-      x: island.x + 30 + random(island.w - 60),
-      y: island.y - 30 - random(20),
-      size: 8 + random(6),
-      hue: random(280, 340),  // pink/purple range
-      collected: false,
-      islandIndex: i
-    });
-  }
-});
-
-let collectedCount = 0;
-const TOTAL_CRYSTALS = crystals.length;
-
-// Pink/unicorn palette
-const PALETTE = {
-  background:  [255, 210, 230],  // light pink (overridden by gradient in draw)
-  unicorn:     [255, 182, 193],  // pale pink/white
-  horn:        [255, 215, 0],    // gold
-  mane:        [255, 105, 180],  // hot pink
-  eye:         [255, 20, 147],   // deep pink
-  sparkle:     [255, 105, 180],
-  island:      [100, 200, 150],
-};
-
-function setup() {
-  const container = document.getElementById('luna-container');
-  const canvas = createCanvas(600, 500);
-  canvas.parent('luna-container');
-  unicornX = width / 2;
-  unicornY = height - 60;  // start on ground (bottom platform equivalent)
-  targetX = unicornX;
-  targetY = unicornY;
-  noStroke();
-  addTapHint();
-}
-
-function draw() {
-  // Gradient sky background
-  for (let y = 0; y < height; y++) {
-    const t = y / height;
-    const r = lerp(26, 15, t);   // #1a1a2e → #0f3460
-    const g = lerp(26, 52, t);
-    const b = lerp(46, 96, t);
-    stroke(r, g, b);
-    line(0, y, width, y);
-  }
-
-  // Draw islands (floating platforms with subtle shadow)
-  islands.forEach(island => {
-    push();
-    // Shadow
-    fill(0, 0, 0, 40);
-    ellipse(island.x + island.w/2 + 5, island.y + 5, island.w + 10, island.h + 6);
-    // Island body
-    fill(island.color[0], island.color[1], island.color[2]);
-    ellipse(island.x + island.w/2, island.y, island.w, island.h);
-    // Top highlight
-    fill(255, 255, 255, 60);
-    ellipse(island.x + island.w/2, island.y - island.h/3, island.w * 0.6, island.h * 0.3);
-    pop();
-  });
-
-  // Draw crystals (glowing collectibles)
-  crystals.forEach(c => {
-    if (c.collected) return;
-    push();
-    translate(c.x, c.y);
-    // Glow aura
-    const glow = color(`hsla(${c.hue}, 80%, 70%, 0.4)`);
-    noStroke();
-    fill(glow);
-    ellipse(0, 0, c.size * 2.2, c.size * 2.2);
-    // Crystal body (diamond shape)
-    const ccol = color(`hsl(${c.hue}, 90%, 75%)`);
-    fill(ccol);
-    beginShape();
-    vertex(0, -c.size);
-    vertex(c.size * 0.6, 0);
-    vertex(0, c.size);
-    vertex(-c.size * 0.6, 0);
-    endShape(CLOSE);
-    // Inner sparkle
-    fill(255, 255, 255, 180);
-    ellipse(0, 0, c.size * 0.5, c.size * 0.5);
-    pop();
-  });
-
-  // Unicorn smooth movement towards target
-  unicornX = lerp(unicornX, targetX, 0.08);
-  unicornY = lerp(unicornY, targetY, 0.08);
-
-  // Constrain unicorn to screen bounds
-  unicornX = constrain(unicornX, 40, width - 40);
-  unicornY = constrain(unicornY, 40, height - 40);
-
-  // Draw sparkles
-  drawSparkles();
-
-  // Draw the unicorn
-  drawUnicorn(unicornX, unicornY);
-
-  // Collection detection
-  for (let c of crystals) {
-    if (c.collected) continue;
-    const d = dist(unicornX, unicornY, c.x, c.y);
-    if (d < 35) {
-      c.collected = true;
-      collectedCount++;
-      createCollectionBurst(c.x, c.y, c.hue);
-    }
-  }
-
-  // Update particles
-  updateParticles();
-
-  // Update HUD
-  document.getElementById('score').textContent = `Crystals: ${collectedCount}/${TOTAL_CRYSTALS}`;
-  document.getElementById('position').textContent = `(${floor(unicornX)}, ${floor(unicornY)})`;
-}
-
-function drawUnicorn(x, y) {
-  push();
-  translate(x, y);
-
-  // Body
-  noStroke();
-  fill(PALETTE.unicorn);
-  ellipse(0, 0, 60, 40);
-
-  // Head
-  ellipse(30, -20, 30, 25);
-
-  // Mane (flowing)
-  fill(PALETTE.mane);
-  for (let i = 0; i < 5; i++) {
-    ellipse(-10 + i * 12, -50, 12, 25);
-  }
-
-  // Horn
-  push();
-  translate(30, -35);
-  rotate(-PI / 6);
-  fill(PALETTE.horn);
-  triangle(0, 0, -8, -35, 8, -35);
-  pop();
-
-  // Eye
-  fill(PALETTE.eye);
-  ellipse(38, -22, 8, 8);
-
-  // Legs
-  stroke(PALETTE.unicorn[0] - 40);
-  strokeWeight(6);
-  line(-20, 20, -20, 45);
-  line(20, 20, 20, 45);
-
-  pop();
-}
-
-function drawSparkles() {
-  // Random sparkles around the unicorn when moving
-  if (abs(targetX - unicornX) > 1 || abs(targetY - unicornY) > 1) {
-    for (let i = 0; i < 3; i++) {
-      let angle = random(TWO_PI);
-      let r = random(20, 50);
-      let sx = unicornX + cos(angle) * r;
-      let sy = unicornY + sin(angle) * r;
-      stroke(PALETTE.sparkle[0], PALETTE.sparkle[1], PALETTE.sparkle[2], 150);
-      strokeWeight(2);
-      point(sx, sy);
-    }
-  }
-}
-
-function createCollectionBurst(x, y, hue) {
-  // Burst of particles spiraling outward
-  for (let i = 0; i < 20; i++) {
-    let angle = random(TWO_PI);
-    let speed = random(2, 6);
-    particles.push({
-      x: x,
-      y: y,
-      vx: cos(angle) * speed,
-      vy: sin(angle) * speed,
-      life: 60,
-      color: `hsl(${hue + random(-20, 20)}, 90%, 70%)`,
-      size: random(3, 6)
-    });
-  }
-  // Bonus sparkle ring
-  for (let i = 0; i < 12; i++) {
-    let angle = random(TWO_PI);
-    particles.push({
-      x: x,
-      y: y,
-      vx: cos(angle) * 4,
-      vy: sin(angle) * 4,
-      life: 40,
-      color: 'rgba(255, 215, 0, 0.9)',
-      size: 4
-    });
-  }
-}
-
-function updateParticles() {
-  for (let i = particles.length - 1; i >= 0; i--) {
-    let p = particles[i];
-    p.x += p.vx;
-    p.y += p.vy;
-    p.vy += 0.1;  // gravity
-    p.life--;
-    p.vx *= 0.95;
-    p.vy *= 0.95;
-    if (p.life <= 0) {
-      particles.splice(i, 1);
-      continue;
-    }
-    push();
-    stroke(p.color);
-    strokeWeight(p.size);
-    point(p.x, p.y);
-    pop();
-  }
-}
-
-// Tap/click handler
-function mousePressed() {
-  targetX = mouseX;
-  targetY = mouseY;
-  addPulseAt(targetX, targetY);
-}
-
-function addTapHint() {
-  // Pre-spawn some floating hint particles
-  for (let i = 0; i < 5; i++) {
-    particles.push({
-      x: random(width),
-      y: random(height),
-      vx: random(-0.5, 0.5),
-      vy: random(-0.5, 0.5),
-      life: 200,
-      color: 'rgba(233, 69, 96, 0.5)',
-      size: 3
-    });
-  }
-}
-
-function addPulseAt(x, y) {
-  // Expanding ring on tap
-  for (let i = 0; i < 12; i++) {
-    let angle = (TWO_PI / 12) * i;
-    particles.push({
-      x: x,
-      y: y,
-      vx: cos(angle) * 3,
-      vy: sin(angle) * 3,
-      life: 30,
-      color: 'rgba(233, 69, 96, 0.7)',
-      size: 3
-    });
-  }
-}
--- a/luna/style.css
+++ b/luna/style.css
@@ -1,32 +0,0 @@
-body {
-  margin: 0;
-  overflow: hidden;
-  background: linear-gradient(to bottom, #1a1a2e, #16213e, #0f3460);
-  font-family: 'Courier New', monospace;
-  color: #e94560;
-}
-
-#luna-container {
-  position: fixed;
-  top: 0;
-  left: 0;
-  width: 100vw;
-  height: 100vh;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-}
-
-#hud {
-  position: fixed;
-  top: 10px;
-  left: 10px;
-  background: rgba(0, 0, 0, 0.6);
-  padding: 8px 12px;
-  border-radius: 4px;
-  font-size: 14px;
-  z-index: 100;
-  border: 1px solid #e94560;
-}
-
-#score { font-weight: bold; }
--- a/scripts/genome_analyzer.py
+++ b/scripts/genome_analyzer.py
@@ -1,20 +1,12 @@
 #!/usr/bin/env python3
 """
-genome_analyzer.py — Generate a GENOME.md from a codebase.
+genome_analyzer.py — Generate a GENOME.md from a codebase using the canonical template.

-Scans a repository and produces a structured codebase genome with:
- File counts by type
- Architecture overview (directory structure)
- Entry points
- Test coverage summary
+Scans a repository and fills in templates/GENOME-template.md with discovered
+structure, entry points, and test coverage. Manual analysis sections are
+preserved with "(To be completed...)" placeholders.

-Usage:
-    python3 scripts/genome_analyzer.py /path/to/repo
-    python3 scripts/genome_analyzer.py /path/to/repo --output GENOME.md
-    python3 scripts/genome_analyzer.py /path/to/repo --dry-run
-
-Part of #666: GENOME.md Template + Single-Repo Analyzer.
-"""
+Part of #666: GENOME.md Template + Single-Repo Analyzer."""

 import argparse
 import sys
@@ -23,25 +15,32 @@ from datetime import datetime, timezone
 from pathlib import Path
 from typing import Dict, List, Tuple

-SKIP_DIRS = {".git", "__pycache__", ".venv", "venv", "node_modules", ".tox", ".pytest_cache", ".DS_Store"}
+SKIP_DIRS = {".git", "__pycache__", ".venv", "venv", "node_modules",
+             ".tox", ".pytest_cache", ".DS_Store", "dist", "build", "coverage"}
+
+
+def _is_source(p: Path) -> bool:
+    return p.suffix in {".py", ".js", ".ts", ".mjs", ".cjs", ".jsx",
+                        ".tsx", ".sh"} and not p.name.startswith("test_")


 def count_files(repo_path: Path) -> Dict[str, int]:
    counts = defaultdict(int)
+    skipped = 0
    for f in repo_path.rglob("*"):
-        if any(part in SKIP_DIRS for part in f.parts):
-            continue
        if f.is_file():
+            if any(part in SKIP_DIRS for part in f.parts):
+                continue
            ext = f.suffix or "(no ext)"
            counts[ext] += 1
    return dict(sorted(counts.items(), key=lambda x: -x[1]))


 def find_entry_points(repo_path: Path) -> List[str]:
-    entry_points = []
+    entry_points: List[str] = []
    candidates = [
        "main.py", "app.py", "server.py", "cli.py", "manage.py",
-        "index.html", "index.js", "index.ts",
+        "__main__.py", "index.html", "index.js", "index.ts",
        "Makefile", "Dockerfile", "docker-compose.yml",
        "README.md", "deploy.sh", "setup.py", "pyproject.toml",
    ]
@@ -53,27 +52,46 @@ def find_entry_points(repo_path: Path) -> List[str]:
        for f in sorted(scripts_dir.iterdir()):
            if f.suffix in (".py", ".sh") and not f.name.startswith("test_"):
                entry_points.append(f"scripts/{f.name}")
-    return entry_points[:15]
+    src_dir = repo_path / "src"
+    if src_dir.is_dir():
+        for f in sorted(src_dir.iterdir()):
+            if f.is_file() and f.suffix == ".py" and not f.name.startswith("test_"):
+                entry_points.append(f"src/{f.name}")
+    top_py = [f.name for f in repo_path.iterdir()
+              if f.is_file() and f.suffix == ".py" and _is_source(f)]
+    entry_points.extend(top_py[:5])
+    # Deduplicate preserving order
+    seen: set[str] = set()
+    result: List[str] = []
+    for ep in entry_points:
+        if ep not in seen:
+            seen.add(ep)
+            result.append(ep)
+    return result[:20]


 def find_tests(repo_path: Path) -> Tuple[List[str], int]:
-    test_files = []
+    test_files: List[str] = []
    for f in repo_path.rglob("*"):
-        if any(part in SKIP_DIRS for part in f.parts):
-            continue
-        if f.is_file() and (f.name.startswith("test_") or f.name.endswith("_test.py") or f.name.endswith("_test.js")):
-            test_files.append(str(f.relative_to(repo_path)))
+        if f.is_file():
+            if any(part in SKIP_DIRS for part in f.parts):
+                continue
+            name = f.name
+            if name.startswith("test_") or name.endswith("_test.py") or name.endswith(".test.js"):
+                test_files.append(str(f.relative_to(repo_path)))
    return sorted(test_files), len(test_files)


 def find_directories(repo_path: Path, max_depth: int = 2) -> List[str]:
-    dirs = []
+    dirs: List[str] = []
    for d in sorted(repo_path.rglob("*")):
-        if d.is_dir() and len(d.relative_to(repo_path).parts) <= max_depth:
-            if not any(part in SKIP_DIRS for part in d.parts):
-                rel = str(d.relative_to(repo_path))
-                if rel != ".":
-                    dirs.append(rel)
+        if d.is_dir():
+            depth = len(d.relative_to(repo_path).parts)
+            if depth <= max_depth:
+                if not any(part in SKIP_DIRS for part in d.parts):
+                    rel = str(d.relative_to(repo_path))
+                    if rel != "." and rel not in dirs:
+                        dirs.append(rel)
    return dirs[:30]


@@ -81,88 +99,198 @@ def read_readme(repo_path: Path) -> str:
    for name in ["README.md", "README.rst", "README.txt", "README"]:
        readme = repo_path / name
        if readme.exists():
-            lines = readme.read_text(encoding="utf-8", errors="replace").split("\n")
-            para = []
-            started = False
-            for line in lines:
-                if line.startswith("#") and not started:
+            text = readme.read_text(encoding="utf-8", errors="replace")
+            paras: List[str] = []
+            for line in text.splitlines():
+                stripped = line.strip()
+                if stripped.startswith("#"):
                    continue
-                if line.strip():
-                    started = True
-                    para.append(line.strip())
-                elif started:
+                if stripped:
+                    paras.append(stripped)
+                elif paras:
                    break
-            return " ".join(para[:5])
+            return " ".join(paras[:3]) if paras else "(README exists but is mostly empty)"
    return "(no README found)"


-def generate_genome(repo_path: Path, repo_name: str = "") -> str:
-    if not repo_name:
-        repo_name = repo_path.name
-    date = datetime.now(timezone.utc).strftime("%Y-%m-%d")
-    readme_desc = read_readme(repo_path)
-    file_counts = count_files(repo_path)
-    total_files = sum(file_counts.values())
-    entry_points = find_entry_points(repo_path)
-    test_files, test_count = find_tests(repo_path)
-    dirs = find_directories(repo_path)
-
-    lines = [
-        f"# GENOME.md — {repo_name}", "",
-        f"> Codebase analysis generated {date}. {readme_desc[:100]}.", "",
-        "## Project Overview", "",
-        readme_desc, "",
-        f"**{total_files} files** across {len(file_counts)} file types.", "",
-        "## Architecture", "",
-        "```",
-    ]
-    for d in dirs[:20]:
-        lines.append(f"  {d}/")
-    lines.append("```")
-    lines += ["", "### File Types", "", "| Type | Count |", "|------|-------|"]
-    for ext, count in list(file_counts.items())[:15]:
-        lines.append(f"| {ext} | {count} |")
-    lines += ["", "## Entry Points", ""]
-    for ep in entry_points:
-        lines.append(f"- `{ep}`")
-    lines += ["", "## Test Coverage", "", f"**{test_count} test files** found.", ""]
-    if test_files:
-        for tf in test_files[:10]:
-            lines.append(f"- `{tf}`")
-        if len(test_files) > 10:
-            lines.append(f"- ... and {len(test_files) - 10} more")
-    else:
-        lines.append("No test files found.")
-    lines += ["", "## Security Considerations", "", "(To be filled during analysis)", ""]
-    lines += ["## Design Decisions", "", "(To be filled during analysis)", ""]
+def _mermaid_diagram(repo_name: str, dirs: List[str], entry_points: List[str]) -> str:
+    lines = ["graph TD", f'  root["{repo_name} (repo root)"]']
+    for d in dirs[:15]:
+        safe = d.replace("/", "_").replace("-", "_")
+        lines.append(f'  root --> {safe}["{d}/"]')
+    lines.append("")
+    lines.append("  %% Entry points (leaf nodes)")
+    for ep in entry_points[:10]:
+        safe_ep = ep.replace("/", "_").replace(".", "_").replace("-", "_")
+        parent = ep.split("/")[0] if "/" in ep else "root"
+        parent_safe = parent.replace("/", "_").replace("-", "_")
+        lines.append(f'  {parent_safe} --> {safe_ep}["{ep}"]')
    return "\n".join(lines)


-def main():
-    parser = argparse.ArgumentParser(description="Generate GENOME.md from a codebase")
-    parser.add_argument("repo_path", help="Path to repository")
-    parser.add_argument("--output", default="", help="Output file (default: stdout)")
-    parser.add_argument("--name", default="", help="Repository name")
-    parser.add_argument("--dry-run", action="store_true", help="Print stats only")
+def _bullet_list(items: List[str]) -> str:
+    if not items:
+        return "(none discovered)"
+    return "\n".join(f"- `{item}`" for item in items[:20])
+
+
+def _comma_list(items: List[str]) -> str:
+    return ", ".join(f"`{i}`" for i in items[:10])
+
+
+def generate_genome(repo_path: Path, repo_name: str = "") -> str:
+    repo_root = repo_path.resolve()
+    if not repo_name:
+        repo_name = repo_path.name
+
+    date = datetime.now(timezone.utc).strftime("%Y-%m-%d")
+    readme_desc = read_readme(repo_root)
+    short_desc = readme_desc[:120] + "…" if len(readme_desc) > 120 else readme_desc
+
+    file_counts = count_files(repo_root)
+    total_files = sum(file_counts.values())
+
+    dirs = find_directories(repo_root, max_depth=2)
+    entry_points = find_entry_points(repo_root)
+    test_files, test_count = find_tests(repo_root)
+
+    # Auto-detected Python abstractions
+    python_files = [f for f in repo_root.rglob("*.py")
+                    if f.is_file() and not any(p in SKIP_DIRS for p in f.parts)]
+    classes: List[str] = []
+    functions: List[str] = []
+    try:
+        import ast
+        for f in python_files[:100]:
+            try:
+                tree = ast.parse(f.read_text(encoding="utf-8", errors="replace"))
+                for node in ast.walk(tree):
+                    if isinstance(node, ast.ClassDef):
+                        classes.append(f"{f.relative_to(repo_root)}::{node.name}")
+                    elif isinstance(node, ast.FunctionDef) and not node.name.startswith("_"):
+                        qual = f"{f.relative_to(repo_root)}::{node.name}"
+                        functions.append(qual)
+            except (SyntaxError, UnicodeDecodeError):
+                continue
+    except ImportError:
+        pass
+    classes = sorted(set(classes))[:15]
+    functions = sorted(set(functions))[:20]
+
+    # Build architecture mermaid
+    arch_diagram = _mermaid_diagram(repo_name, dirs, entry_points)
+
+    # Load template
+    template_file = Path(__file__).resolve().parent.parent / "templates" / "GENOME-template.md"
+
+    if template_file.exists():
+        template_text = template_file.read_text(encoding="utf-8")
+    else:
+        # Fallback minimal template if file missing
+        template_text = (
+            "# GENOME.md — {REPO_NAME}\n\n"
+            "> Codebase analysis generated {DATE}. {SHORT_DESCRIPTION}.\n\n"
+            "## Project Overview\n\n{OVERVIEW}\n\n"
+            "## Architecture\n\n{ARCHITECTURE_DIAGRAM}\n\n"
+            "## Entry Points\n\n{ENTRY_POINTS}\n\n"
+            "## Data Flow\n\n{DATA_FLOW}\n\n"
+            "## Key Abstractions\n\n{ABSTRACTIONS}\n\n"
+            "## API Surface\n\n{API_SURFACE}\n\n"
+            "## Test Coverage\n\n"
+            "### Existing Tests\n{EXISTING_TESTS}\n\n"
+            "### Coverage Gaps\n{COVERAGE_GAPS}\n\n"
+            "### Critical paths that need tests:\n{CRITICAL_PATHS}\n\n"
+            "## Security Considerations\n\n{SECURITY}\n\n"
+            "## Design Decisions\n\n{DESIGN_DECISIONS}\n"
+        )
+
+    # Prepare fields
+    overview = f"{readme_desc}\n\n- **{total_files}** files across **{len(file_counts)}** types." + (
+        f"\n- Primary languages: {_comma_list([f'{k}:{v}' for k,v in list(file_counts.items())[:5]])}."
+    )
+
+    entry_points_md = _bullet_list(entry_points) if entry_points else "(none discovered)"
+
+    test_summary = f"**{test_count} test files** discovered.\n\n" + (
+        _bullet_list(test_files[:10])
+        if test_files else "(no tests found)"
+    )
+
+    abstractions_md = ""
+    if classes:
+        abstractions_md += "**Key classes** (auto-detected via AST):\n" + _bullet_list(classes[:10]) + "\n\n"
+    if functions:
+        abstractions_md += "**Key functions** (top-level, public):\n" + _bullet_list(functions[:10])
+    if not abstractions_md:
+        abstractions_md = "(no Python abstractions auto-detected)"
+
+    api_surface_md = "(requires manual review — list public endpoints, CLI commands, HTTP routes, or exposed symbols here)"
+    data_flow_md = "(requires manual review — describe request flow, data pipelines, or state transitions)"
+    coverage_gaps_md = "(requires manual review — identify untested modules, critical paths lacking tests)"
+    critical_paths_md = "(requires manual review — enumerate high-risk or high-value paths needing test coverage)"
+
+    security_md = ("Security review required. Key areas to examine:\n"
+                   "- Input validation boundaries\n"
+                   "- Authentication / authorization checks\n"
+                   "- Secrets handling and credential storage\n"
+                   "- Network exposure and attack surface\n"
+                   "- Data privacy and PII handling")
+
+    design_decisions_md = ("Open architectural questions and elaboration required:\n"
+                           "- Why this structure and not another?\n"
+                           "- What constraints shaped current abstractions?\n"
+                           "- What trade-offs were accepted and why?\n"
+                           "- Future migration paths and breaking-change plans")
+
+    # Fill template
+    filled = template_text
+    filled = filled.replace("{{REPO_NAME}}", repo_name)
+    filled = filled.replace("{{DATE}}", date)
+    filled = filled.replace("{{SHORT_DESCRIPTION}}", short_desc)
+    filled = filled.replace("{{OVERVIEW}}", overview)
+    filled = filled.replace("{{ARCHITECTURE_DIAGRAM}}", arch_diagram)
+    filled = filled.replace("{{ENTRY_POINTS}}", entry_points_md)
+    filled = filled.replace("{{DATA_FLOW}}", data_flow_md)
+    filled = filled.replace("{{ABSTRACTIONS}}", abstractions_md)
+    filled = filled.replace("{{API_SURFACE}}", api_surface_md)
+    filled = filled.replace("{{EXISTING_TESTS}}", test_summary)
+    filled = filled.replace("{{COVERAGE_GAPS}}", coverage_gaps_md)
+    filled = filled.replace("{{CRITICAL_PATHS}}", critical_paths_md)
+    filled = filled.replace("{{SECURITY}}", security_md)
+    filled = filled.replace("{{DESIGN_DECISIONS}}", design_decisions_md)
+    return filled
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Generate GENOME.md from a codebase using the canonical template")
+    parser.add_argument("repo_path", help="Path to repository root")
+    parser.add_argument("--output", "-o", default="", help="Write GENOME.md to this path (default: stdout)")
+    parser.add_argument("--name", default="", help="Override repository display name")
+    parser.add_argument("--dry-run", action="store_true", help="Print discovered stats without generating file")
    args = parser.parse_args()
+
    repo_path = Path(args.repo_path).resolve()
    if not repo_path.is_dir():
        print(f"ERROR: {repo_path} is not a directory", file=sys.stderr)
        sys.exit(1)
+
    repo_name = args.name or repo_path.name
+
    if args.dry_run:
        counts = count_files(repo_path)
        _, test_count = find_tests(repo_path)
        print(f"Repo: {repo_name}")
-        print(f"Total files: {sum(counts.values())}")
+        print(f"Total files (text): {sum(counts.values())}")
        print(f"Test files: {test_count}")
        print(f"Top types: {', '.join(f'{k}={v}' for k,v in list(counts.items())[:5])}")
        sys.exit(0)
+
    genome = generate_genome(repo_path, repo_name)
+
    if args.output:
-        with open(args.output, "w") as f:
-            f.write(genome)
-        print(f"Written: {args.output}")
+        out = Path(args.output)
+        out.write_text(genome, encoding="utf-8")
+        print(f"GENOME.md written: {out}")
    else:
        print(genome)

--- a/specs/fleet-operator-incentives.md
+++ b/specs/fleet-operator-incentives.md
@@ -1,104 +0,0 @@
-# Fleet Operator Incentives Specification
-
-## Overview
-
-This document defines the incentive structures for fleet operators within the Timmy Home ecosystem. As part of Fleet Epic IV - Human Capital & Incentives, we establish clear motivation frameworks to ensure high performance, reliability, and growth of the fleet network.
-
-## 1. Incentive Tiers
-
-### Tier 1: Bronze Operator
- **Eligibility**: New operators, < 3 months tenure
- **Base Rate**: $0.15/task
- **Monthly Cap**: $500
- **Bonuses**:
-  - First 100 tasks completed: +$100
-  - 95%+ completion rate: +$50
-
-### Tier 2: Silver Operator
- **Eligibility**: 3-12 months tenure, >500 tasks completed
- **Base Rate**: $0.22/task
- **Monthly Cap**: $1,200
- **Bonuses**:
-  - 98%+ completion rate: +$150
-  - Peak-hour availability (6-9 AM,YPES$150
-
-### Tier 3: Gold Operator
- **Eligibility**: >12 months tenure, >2000 tasks completed
- **Base Rate**: $0.30/task
- **Monthly Cap**: $2,500
- **Bonuses**:
-  - 99%+ completion rate: +$300
-  - Training 2+ new operators: +$200/operator
-  - Weekend availability: +$200
-
-### Tier 4: Platinum Operator
- **Eligibility**: >24 months tenure, >5000 tasks completed, peer nomination
- **Base Rate**: $0.40/task
- **Monthly Cap**: Unlimited
- **Bonuses**:
-  - Perfect attendance month: +$500
-  - Regional spot bonus: $100-$1000 (discretionary)
-  - Profit-sharing pool access (5% of net profits)
-
-## 2. Performance Metrics
-
-| Metric | Target | Measurement |
-|--------|--------|-------------|
-| Task Completion Rate | ≥98% | Daily rolling average |
-| Response Time | ≤5 min | 95th percentile |
-| Customer Rating | ≥4.8/5.0 | Rolling 30-day average |
-| Uptime/Availability | ≥90% | Weekly average hours active |
-| Safety Incidents | 0 | Zero tolerance |
-
-## 3. Bonus Structures
-
-### Quarterly Performance Bonus
- Gold+ operators eligible
- Tiered payouts based on combined metrics:
-  - Meets targets: $1,000
-  - Exceeds targets: $2,500
-  - Exceptional: $5,000
-
-### Referral Program
- Refer new operator: $250 after their 50th task
- Refer new partner business: $500 after first contract signed
- Multi-tier: additional $100 for each referral that becomes Gold within 12 months
-
-### Fleet Growth Bonus
- Operators who expand their own fleet (add ≥3 additional verified operators under their mentorship):
-  - $1,000 per new operator added after 6-month probation
-  - Access to Platinum-tier benefits for 6 months
-
-## 4. Penalties & Adjustments
-
- **Late task completion**: -$0.05 per late task (from base)
- **Customer complaint (verified)**: -$25 per incident
- **No-show without notice**: -$50 per incident
- **Safety violation**: Tier demotion, retraining required
-
-## 5. Payment Schedule
-
- Weekly payouts (every Friday)
- Direct deposit or cryptocurrency wallet
- Detailed invoice with performance breakdown
- Tax documents (1099) provided annually
-
-## 6. Review & Advancement
-
- Automatic tier review occurs monthly
- Operators may request early review after meeting tier criteria
- Appeals process available within 7 days of notification
- Demotion notices include 14-day improvement window
-
-## 7. Partner Program Integration
-
-Operators in Gold+ tiers are eligible for Partner Program benefits:
- Access to premium client contracts
- Co-marketing opportunities
- Equipment leasing at preferred rates
- Revenue share on referred business
-
---
-
-*Last Updated: 2026-03-29*
-*Next Review: Quarterly*
--- a/specs/fleet-ops-runbook.md
+++ b/specs/fleet-ops-runbook.md
@@ -1,149 +0,0 @@
-# Fleet Operations Runbook
-
-## Purpose
-
-This runbook provides fleet operators with standard operating procedures (SOPs), escalation paths, and daily operational guidance for managing fleet tasks within the Timmy Home platform.
-
-## Table of Contents
-
-1. [Daily Startup](#daily-startup)
-2. [Task Management](#task-management)
-3. [Communication Protocols](#communication-protocols)
-4. [Incident Response](#incident-response)
-5. [Vehicle & Equipment Checks](#vehicle--equipment-checks)
-6. [End-of-Day Procedures](#end-of-day-procedures)
-7. [Escalation Matrix](#escalation-matrix)
-8. [Contact Directory](#contact-directory)
-
---
-
-## Daily Startup
-
-### Morning Briefing (5:45 AM - 6:00 AM)
- [ ] Log into operator dashboard
- [ ] Review daily task assignments
- [ ] Check weather and traffic conditions
- [ ] Confirm vehicle status (fuel, battery, maintenance)
- [ ] Update availability status to "Active"
-
-### Equipment Checklist
- [ ] Mobile device charged (>80%)
- [ ] Scanner/tablet functional
- [ ] Connectivity tested (Wi-Fi & cellular)
- [ ] PPE available (if required for task type)
- [ ] First aid kit present in vehicle
-
-## Task Management
-
-### Task Acceptance
-1. Review task details: location, time window, requirements
-2. Confirm capacity to accept
-3. Acknowledge task within 2 minutes
-4. Navigate to location using integrated GPS
-
-### On-Site Procedure
- Arrive 5 minutes early
- Scan QR code or enter PIN
- Complete required verification steps
- Perform task according to SOP checklist
- Capture completion evidence (photo/video if required)
- Obtain customer signature if applicable
- Mark task complete in system
-
-### Task Issues
- **Location inaccessible**: Contact dispatch, document with photo
- **Equipment failure**: Log issue, request replacement
- **Customer not present**: Wait 15 min past scheduled time, then escalate
- **Task cannot be completed**: Document reason, contact support immediately
-
-## Communication Protocols
-
-### Radio/Comms Etiquette
- Use clear, concise language
- Identify yourself and task ID at start of transmission
- Acknowledge all dispatcher communications within 1 minute
- Emergency communications use priority channel
-
-### Status Updates
- Update status every 2 hours during shift
- Immediate notification for delays >10 minutes
- ETA changes communicated proactively
-
-## Incident Response
-
-### Incident Categories & Response Times
-
-| Incident Type | Initial Response | Escalation Threshold |
-|---------------|-----------------|---------------------|
-| Vehicle accident | Immediate (911 + dispatch) | All accidents |
-| Task dispute | 5 minutes | Unresolved after 15 min |
-| Medical emergency | Immediate (911) | All emergencies |
-| Equipment loss/theft | 10 minutes | Police report required |
-| Route blocked | 15 minutes | Alternate not found |
-
-### Incident Reporting Steps
-1. Secure safety (self and others)
-2. Contact appropriate emergency services if needed
-3. Notify dispatch/supervisor
-4. Document with photos/videos
-5. Complete incident form within 1 hour
-6. Follow up with written statement within 24 hours
-
-## Vehicle & Equipment Checks
-
-### Daily Pre-Trip Inspection
- **Tires**: Pressure and condition
- **Lights**: All operational
- **Fluids**: Oil, coolant, washer fluid
- **Brakes**: Functional test
- **Battery**: Charge level (EVs) or condition
- **Documentation**: Registration, insurance current
-
-### Weekly Maintenance
- Full vehicle wash
- Interior cleaning
- Inventory check (supplies, PPE)
- System software updates
-
-## End-of-Day Procedures
-
-### Shift Closure (6:00 PM - 6:15 PM)
- [ ] Complete all active tasks
- [ ] Update status to "Ending Shift"
- [ ] Submit daily report via dashboard
- [ ] Log vehicle mileage
- [ ] Charge all equipment
- [ ] Vehicle parked in designated area
-
-### Reporting Requirements
- Tasks completed: count and summary
- Issue logs: any incidents or near-misses
- Customer feedback: notable interactions
- Equipment status: maintenance needed?
- Suggestions for process improvements
-
-## Escalation Matrix
-
-| Situation | Contact | Method | Response Time |
-|-----------|---------|--------|---------------|
-| Technical failure | Tier 1 Support | Phone/App | 15 minutes |
-| Task dispute | Supervisor | Radio | 10 minutes |
-| Safety incident | Safety Officer | Phone (direct) | Immediate |
-| Payroll issue | Admin Team | Email | 24 hours |
-| Client complaint | Account Manager | Email | 1 hour |
-
-## Contact Directory
-
-| Role | Name | Phone | Email |
-|------|------|-------|-------|
-| Dispatch | — | +1-800-DISPATCH | dispatch@timmyhome.io |
-| Tier 1 Support | — | +1-800-SUPPORT | support@timmyhome.io |
-| Safety Hotline | — | +1-800-SAFETY | safety@timmyhome.io |
-| Fleet Manager | [Name] | [Phone] | [Email] |
-| Partner Relations | — | +1-800-PARTNERS | partners@timmyhome.io |
-
---
-
-*Runbook Version: 1.0*
-*Effective Date: 2026-03-29*
-*Next Review: Quarterly*
--- a/specs/templates/operator-application.md
+++ b/specs/templates/operator-application.md
@@ -1,146 +0,0 @@
-# Fleet Operator Application Template
-
-## Personal Information
-
-**Full Legal Name**: _______________________________
-**Date of Birth**: _______________
-**SSN / Tax ID**: _______________
-**Contact Phone**: _______________
-**Email Address**: _______________
-**Physical Address**: _______________________________
-
-## Employment Eligibility
-
- [ ] I am legally authorized to work in the United States
- [ ] I am at least 21 years of age
- [ ] I possess a valid driver's license (Class: ______, State: ______)
-
-## Driving & Vehicle Information
-
-### Driver's License
- License Number: _______________
- State: _______________
- Expiration: _______________
- Have you had any moving violations in the past 3 years? (Y/N): ______
-  - If yes, please explain: _______________________________
-
-### Vehicle Information
- **Vehicle Year/Make/Model**: __________________________________
- **Vehicle VIN**: ___________________________________________
- **License Plate**: _________________________________________
- **Vehicle Color**: _________________________________________
- **Vehicle used for**: [ ] Personal [ ] Commercial [ ] Leased
- **Insurance Provider**: _____________________________________
- **Policy Number**: _________________________________________
- **Coverage Limits**: $______ bodily injury / $______ property damage
-
-## Background Check Authorization
-
-I authorize Timmy Home and its affiliated entities to conduct a background check, including:
-
- [ ] Criminal history (7-year lookback)
- [ ] Motor vehicle records
- [ ] Employment verification
- [ ] Education verification
- [ ] Credit check (if required)
-
-**Signature**: _______________________________ **Date**: _______________
-
-## Equipment & Technology
-
-### Required Equipment (check all that you possess)
- [ ] Smartphone (iOS/Android) with data plan
- [ ] Portable charger / power bank
- [ ] Mount for phone in vehicle
- [ ] Scanner/tablet (if applicable)
- [ ] Other: _______________________________________________
-
-### Technical Proficiency
-Please rate your comfort level with the following (1-5):
- Mobile applications: _____
- GPS navigation: _____
- Digital forms & documentation: _____
- Photography for documentation: _____
-
-## Availability & Scheduling
-
-### Preferred Working Hours
- [ ] Morning (5:00 AM - 12:00 PM)
- [ ] Afternoon (12:00 PM - 8:00 PM)
- [ ] Evening (8:00 PM - 12:00 AM)
- [ ] Overnight (12:00 AM - 5:00 AM)
- [ ] Weekends
-
-### Weekly Availability
- Monday: _____ hours
- Tuesday: _____ hours
- Wednesday: _____ hours
- Thursday: _____ hours
- Friday: _____ hours
- Saturday: _____ hours
- Sunday: _____ hours
-
-**Total weekly availability**: _____ hours
-
-## Experience & Training
-
-### Previous Relevant Experience
-**Company**: ___________________________________________
-**Role**: _______________________________________________
-**Duration**: ___________________________________________
-**Key Responsibilities**: _______________________________
-
-**Company**: ___________________________________________
-**Role**: _______________________________________________
-**Duration**: ___________________________________________
-**Key Responsibilities**: _______________________________
-
-### Specialized Training
- [ ] Commercial Driver's License (CDL)
- [ ] Defensive Driving Course
- [ ] First Aid / CPR Certified
- [ ] OSHA Safety Training
- [ ] Other: _____________________________________________
-
-## Incentive Program Preferences
-
-Which incentive components are most important to you? (Rank 1-5, 1=most important)
- Base pay rate: _____
- Task variety: _____
- Flexible schedule: _____
- Performance bonuses: _____
- Tier advancement opportunities: _____
-
-## References
-
-### Professional Reference 1
-**Name**: ________________________________
-**Relationship**: _______________________
-**Company**: ___________________________
-**Phone**: _____________________________
-**Email**: _____________________________
-
-### Professional Reference 2
-**Name**: ________________________________
-**Relationship**: _______________________
-**Company**: ___________________________
-**Phone**: _____________________________
-**Email**: _____________________________
-
-## Agreement & Certification
-
-I certify that all information provided in this application is true and complete to the best of my knowledge. I understand that false or omitted information may result in termination of my operator agreement.
-
-I have read and agree to the Timmy Home Operator Agreement and related policies.
-
-**Applicant Signature**: _______________________________
-**Printed Name**: _____________________________________
-**Date**: _______________
-
---
-
-*Application ID*: [Auto-generated]
-*Submission Date*: [Auto-filled]
-*Review Status*: Pending
-
-*Please email completed application to operators@timmyhome.io or submit via the operator portal.*
--- a/specs/templates/partner-report.md
+++ b/specs/templates/partner-report.md
@@ -1,222 +0,0 @@
-# Partner Performance Report Template
-
-## Report Period
-
-**From**: _______________ **To**: _______________
-**Report Generated**: _______________
-**Report Owner**: _________________________________________
-
---
-
-## Executive Summary
-
-### Period Highlights
- Total tasks completed: _______________
- Revenue generated: $_______________
- Net promoter score (NPS): _______________
- Completion rate: ______________%
- Key achievements: _____________________________________________
- Areas for improvement: _________________________________________
-
---
-
-## Partner Details
-
-**Partner Name**: _______________________________________________
-**Partner ID**: _______________
-**Partner Tier**: [ ] Bronze [ ] Silver [ ] Gold [ ] Platinum
-**Contract Start Date**: _______________
-**Account Manager**: _______________________________________________
-
---
-
-## Volume Metrics
-
-| Metric | Current Period | Previous Period | Variance | Annual Target |
-|--------|----------------|-----------------|----------|---------------|
-| Tasks Assigned | ________ | ________ | ____% | ________ |
-| Tasks Completed | ________ | ________ | ____% | ________ |
-| Tasks Cancelled | ________ | ________ | ____% | ________ |
-| Avg. Tasks/Day | ________ | ________ | ____% | ________ |
-| Peak Day (tasks) | ________ | ________ | ________ | ________ |
-
---
-
-## Financial Summary
-
-| Category | Current Period | Previous Period | Variance | YTD Total |
-|----------|----------------|-----------------|----------|-----------|
-| Gross Revenue | $__________ | $__________ | ____% | $__________ |
-| Incentives Paid | $__________ | $__________ | ____% | $__________ |
-| Bonuses Awarded | $__________ | $__________ | ____% | $__________ |
-| Net Revenue* | $__________ | $__________ | ____% | $__________ |
-
-*Net Revenue = Gross Revenue - Incentives Paid - Bonuses Awarded
-
-### Revenue Breakdown by Service Type
- Standard Delivery: $__________ (____%)
- Express Delivery: $__________ (____%)
- White-Glove Service: $__________ (____%)
- Other: $__________ (____%)
-
---
-
-## Performance Quality Metrics
-
-### Completion & Timeliness
- **On-time Completion Rate**: ________% (Target: ≥95%)
- **Average Completion Time**: ______ minutes (Target: ≤45 min)
- **Tasks Completed Early**: ________ (____%)
- **Tasks Completed Late**: ________ (____%)
-
-### Quality Assurance
- **Customer Satisfaction Score**: ______ / 5.0
- **5-Star Rating Percentage**: ______%
- **Complaints Received**: ________
- **Complaints Escalated**: ________
- **Quality Audit Pass Rate**: ______%
-
-### Operational Reliability
- **Vehicle/Availability Uptime**: ______%
- **System/App Uptime**: ______%
- **Missed Tasks due to Equipment**: ________
- **Route Adherence Score**: ______%
-
---
-
-## Operator Team Performance
-
-### Team Composition
-| Tier | Count | Change from prev. period |
-|------|-------|--------------------------|
-| Bronze | ________ | [ ] ↑ [ ] ↓ ____ |
-| Silver | ________ | [ ] ↑ [ ] ↓ ____ |
-| Gold | ________ | [ ] ↑ [ ] ↓ ____ |
-| Platinum | ________ | [ ] ↑ [ ] ↓ ____ |
-| **Total** | ________ | ________ |
-
-### Operator Productivity
- **Top Performer**: ______________________ (______ tasks)
- **Average Tasks/Operator/Day**: ________
- **New Operators Added**: ________
- **Operators Terminated**: ________
- **Operator Retention Rate**: ______%
-
---
-
-## Customer & Client Insights
-
-### Top 5 Customers by Volume
-| # | Customer Name | Tasks | Revenue |
-|---|---------------|-------|---------|
-| 1 | ______________ | _____ | $_______ |
-| 2 | ______________ | _____ | $_______ |
-| 3 | ______________ | _____ | $_______ |
-| 4 | ______________ | _____ | $_______ |
-| 5 | ______________ | _____ | $_______ |
-
-### Customer Feedback Themes
- **Positive**: _______________________________________________________
- **Negative**: _______________________________________________________
- **Improvement Requests**: ___________________________________________
-
---
-
-## Incident & Issue Log
-
-| Date | Incident Type | Description | Resolution | Cost Impact |
-|------|---------------|-------------|------------|-------------|
-| ______ | _____________ | ____________ | __________ | $__________ |
-| ______ | _____________ | ____________ | __________ | $__________ |
-| ______ | _____________ | ____________ | __________ | $__________ |
-
-**Total Incident Cost This Period**: $__________
-
---
-
-## Compliance & Safety
-
- Safety Training Completed: ________%
- Safety Violations: ________
- Near-Miss Reports: ________
- Corrective Actions Outstanding: ________
- Regulatory Compliance Status: [ ] Compliant [ ] Non-compliant
-
---
-
-## Partner Program Benefits Utilization
-
-| Benefit | Utilized? | Frequency | ROI Assessment |
-|---------|-----------|-----------|----------------|
-| Co-marketing funds | [ ] Yes [ ] No | ________ | ________ |
-| Equipment leasing | [ ] Yes [ ] No | ________ | ________ |
-| Priority dispatch | [ ] Yes [ ] No | ________ | ________ |
-| Training program | [ ] Yes [ ] No | ________ | ________ |
-| Profit-sharing | [ ] Yes [ ] No | ________ | ________ |
-
---
-
-## Review & Recognition
-
-### Performance Assessment
-**Overall Rating**: [ ] Exceeds Expectations [ ] Meets Expectations [ ] Needs Improvement
-
-**Strengths**:
-1. ___________________________________________
-2. ___________________________________________
-3. ___________________________________________
-
-**Areas for Development**:
-1. ___________________________________________
-2. ___________________________________________
-
-### Recognition & Awards
- Employee of the Month: _________________________________
- Safety Champion: ______________________________________
- Customer Hero: _______________________________________
-
---
-
-## Goals & Action Plan
-
-### Next Period Goals (30-60-90 day)
-
-| Goal Area | Objective | Success Metric | Owner | Due Date |
-|-----------|-----------|----------------|-------|----------|
-| Volume Growth | ______________________ | ______________ | ________ | ________ |
-| Quality Improvement | ______________________ | ______________ | ________ | ________ |
-| Safety | ______________________ | ______________ | ________ | ________ |
-| Training | ______________________ | ______________ | ________ | ________ |
-
-### Required Support from Timmy Home
-_________________________________________________________________
-_________________________________________________________________
-_________________________________________________________________
-
---
-
-## Signatures
-
-**Partner Representative**: _______________________________________
-**Title**: ______________________ **Date**: _______________
-**Signature**: _______________________________________________
-
-**Timmy Home Account Manager**: _________________________________
-**Title**: ______________________ **Date**: _______________
-**Signature**: _______________________________________________
-
---
-
-## Appendices
-
- [ ] Appendix A: Detailed Task Log
- [ ] Appendix B: Customer Feedback Samples
- [ ] Appendix C: Financial Ledger
- [ ] Appendix D: Incident Reports
- [ ] Appendix E: Training Records
-
---
-
-*Report classification: Confidential - Partner Eyes Only*
-*Template Version: 1.0*
-*Next review due: _______________*