devloom 1.0.0 → 1.2.0

package/dist/worktree.js

@@ -0,0 +1,272 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync } from "node:fs";
+import { join, dirname } from "node:path";
+const WORKTREE_DIR = ".devloom-worktrees";
+const REGISTRY_PATH = join(WORKTREE_DIR, ".registry.json");
+const GIT_TIMEOUT = 30_000;
+const GIT_MAX_BUFFER = 10 * 1024 * 1024;
+function git(rootDir, args, opts = {}) {
+    const timeout = opts.timeout ?? GIT_TIMEOUT;
+    try {
+        const out = execFileSync("git", args, {
+            cwd: rootDir,
+            encoding: "utf8",
+            timeout,
+            maxBuffer: GIT_MAX_BUFFER,
+            stdio: opts.stdio ?? ["pipe", "pipe", "pipe"],
+        });
+        return String(out).trim();
+    }
+    catch (err) {
+        if (opts.throwOnError !== false) {
+            const stderr = err.stderr ? String(err.stderr).trim() : "";
+            throw new Error(`git ${args[0] || ""} failed: ${err.message}${stderr ? " | " + stderr : ""}`);
+        }
+        return "";
+    }
+}
+function gitOk(rootDir, args) {
+    try {
+        execFileSync("git", args, { cwd: rootDir, encoding: "utf8", timeout: GIT_TIMEOUT, maxBuffer: GIT_MAX_BUFFER, stdio: ["pipe", "pipe", "pipe"] });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readJson(path, fallback) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return fallback;
+    }
+}
+function writeJson(path, data) {
+    const dir = dirname(path);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(path, JSON.stringify(data, null, 2) + "\n");
+}
+function isGitRepo(rootDir) {
+    return gitOk(rootDir, ["rev-parse", "--is-inside-work-tree"]);
+}
+export function getCurrentBranch(rootDir) {
+    return git(rootDir, ["rev-parse", "--abbrev-ref", "HEAD"]);
+}
+export function isClean(rootDir) {
+    const status = git(rootDir, ["status", "--porcelain"]);
+    return status.length === 0;
+}
+function commitAll(rootDir, message) {
+    git(rootDir, ["add", "-A"]);
+    if (isClean(rootDir))
+        return null;
+    git(rootDir, ["commit", "-m", message]);
+    return git(rootDir, ["rev-parse", "HEAD"]);
+}
+function branchSlug(branchName) {
+    return branchName.replace(/[^a-zA-Z0-9_-]/g, "-");
+}
+function worktreePath(rootDir, branchName) {
+    return join(rootDir, WORKTREE_DIR, branchSlug(branchName));
+}
+function readRegistry(rootDir) {
+    return readJson(join(rootDir, REGISTRY_PATH), { worktrees: [] });
+}
+function writeRegistry(rootDir, registry) {
+    writeJson(join(rootDir, REGISTRY_PATH), registry);
+}
+function addToRegistry(rootDir, entry) {
+    const reg = readRegistry(rootDir);
+    const idx = reg.worktrees.findIndex((w) => w.branch === entry.branch);
+    if (idx >= 0)
+        reg.worktrees[idx] = entry;
+    else
+        reg.worktrees.push(entry);
+    writeRegistry(rootDir, reg);
+}
+function removeFromRegistry(rootDir, branchName) {
+    const reg = readRegistry(rootDir);
+    reg.worktrees = reg.worktrees.filter((w) => w.branch !== branchName);
+    writeRegistry(rootDir, reg);
+}
+export function createWorktree(rootDir, branchName, baseRef) {
+    if (!isGitRepo(rootDir))
+        throw new Error("not a git repository");
+    const ref = baseRef || getCurrentBranch(rootDir);
+    const wtPath = worktreePath(rootDir, branchName);
+    if (existsSync(wtPath)) {
+        gitOk(rootDir, ["worktree", "remove", "--force", wtPath]);
+        rmSync(wtPath, { recursive: true, force: true });
+    }
+    // Exact match: a substring test makes a sibling branch (`feat/x-old`) look
+    // like a collision with `feat/x`, and the resulting `branch -D` then throws.
+    const existing = git(rootDir, ["branch", "--list", "--format=%(refname:short)"], { throwOnError: false })
+        .split("\n")
+        .map((b) => b.trim());
+    if (existing.includes(branchName)) {
+        git(rootDir, ["branch", "-D", branchName]);
+    }
+    ensureGitignore(rootDir);
+    if (!isClean(rootDir)) {
+        commitAll(rootDir, `devloom: auto-commit before worktree ${branchName}`);
+    }
+    git(rootDir, ["worktree", "add", "-b", branchName, wtPath, ref]);
+    const parts = branchName.split("/");
+    const entry = {
+        branch: branchName,
+        path: wtPath,
+        baseRef: ref,
+        createdAt: new Date().toISOString(),
+        ticket: parts[1] || branchName,
+        agent: parts[2] || "unknown",
+    };
+    addToRegistry(rootDir, entry);
+    return entry;
+}
+function ensureGitignore(rootDir) {
+    const gitignorePath = join(rootDir, ".gitignore");
+    const entry = ".devloom-worktrees/";
+    try {
+        const content = readFileSync(gitignorePath, "utf8");
+        if (!content.includes(entry)) {
+            writeFileSync(gitignorePath, content + (content.endsWith("\n") ? "" : "\n") + entry + "\n");
+        }
+    }
+    catch {
+        writeFileSync(gitignorePath, entry + "\n");
+    }
+}
+export function mergeWorktree(rootDir, branchName) {
+    if (!isGitRepo(rootDir))
+        throw new Error("not a git repository");
+    const wtPath = worktreePath(rootDir, branchName);
+    if (!existsSync(wtPath))
+        throw new Error(`worktree not found: ${branchName}`);
+    if (!isClean(wtPath)) {
+        commitAll(wtPath, `devloom: auto-commit in worktree ${branchName} before merge`);
+    }
+    const currentBranch = getCurrentBranch(rootDir);
+    if (!isClean(rootDir)) {
+        commitAll(rootDir, `devloom: auto-commit before merge of ${branchName}`);
+    }
+    const mergeOut = git(rootDir, ["merge", "--no-ff", branchName, "-m", `devloom: merge ${branchName}`], { throwOnError: false });
+    const hasMergeHead = gitOk(rootDir, ["rev-parse", "-q", "--verify", "MERGE_HEAD"]);
+    if (hasMergeHead) {
+        const conflictFiles = git(rootDir, ["diff", "--name-only", "--diff-filter=U"], { throwOnError: false });
+        const conflicts = conflictFiles ? conflictFiles.split("\n").filter(Boolean) : [];
+        if (conflicts.length > 0 || mergeOut.includes("CONFLICT") || mergeOut.includes("Automatic merge failed")) {
+            git(rootDir, ["merge", "--abort"]);
+            return {
+                success: false,
+                conflicts,
+                message: `merge conflict in ${conflicts.length} file(s): ${conflicts.join(", ")}`,
+                branch: branchName,
+                worktreePath: wtPath,
+            };
+        }
+        git(rootDir, ["merge", "--abort"]);
+        return {
+            success: false,
+            conflicts: [],
+            message: "merge conflict detected (auto-aborted)",
+            branch: branchName,
+            worktreePath: wtPath,
+        };
+    }
+    git(rootDir, ["worktree", "remove", wtPath]);
+    git(rootDir, ["branch", "-d", branchName], { throwOnError: false });
+    rmSync(wtPath, { recursive: true, force: true });
+    removeFromRegistry(rootDir, branchName);
+    return {
+        success: true,
+        conflicts: [],
+        message: `merged ${branchName} into ${currentBranch}`,
+        branch: branchName,
+        mergedInto: currentBranch,
+    };
+}
+export function removeWorktree(rootDir, branchName, force = false) {
+    if (!isGitRepo(rootDir))
+        throw new Error("not a git repository");
+    const wtPath = worktreePath(rootDir, branchName);
+    if (!existsSync(wtPath)) {
+        removeFromRegistry(rootDir, branchName);
+        return { removed: false, message: `worktree not found: ${branchName}` };
+    }
+    if (!force && !isClean(wtPath)) {
+        const status = git(wtPath, ["status", "--porcelain"]);
+        throw new Error(`worktree ${branchName} has uncommitted changes. Use --force to discard.\nUncommitted:\n${status}`);
+    }
+    git(rootDir, ["worktree", "remove", "--force", wtPath]);
+    git(rootDir, ["branch", "-D", branchName], { throwOnError: false });
+    rmSync(wtPath, { recursive: true, force: true });
+    removeFromRegistry(rootDir, branchName);
+    return { removed: true, message: `removed worktree ${branchName}` };
+}
+export function listWorktrees(rootDir) {
+    if (!isGitRepo(rootDir))
+        return [];
+    const reg = readRegistry(rootDir);
+    return reg.worktrees.filter((w) => existsSync(w.path));
+}
+export function worktreeStatus(rootDir, branchName) {
+    if (!isGitRepo(rootDir))
+        throw new Error("not a git repository");
+    const reg = readRegistry(rootDir);
+    const entry = reg.worktrees.find((w) => w.branch === branchName);
+    if (!entry || !existsSync(entry.path)) {
+        return { branch: branchName, exists: false, clean: false, ahead: 0, behind: 0 };
+    }
+    const clean = isClean(entry.path);
+    const aheadStr = git(rootDir, ["rev-list", "--count", `${entry.baseRef}..${branchName}`], { throwOnError: false });
+    const behindStr = git(rootDir, ["rev-list", "--count", `${branchName}..${entry.baseRef}`], { throwOnError: false });
+    return {
+        branch: branchName,
+        exists: true,
+        path: entry.path,
+        clean,
+        ahead: parseInt(aheadStr) || 0,
+        behind: parseInt(behindStr) || 0,
+        createdAt: entry.createdAt,
+        ticket: entry.ticket,
+        agent: entry.agent,
+    };
+}
+export function cleanWorktrees(rootDir, force = false) {
+    if (!isGitRepo(rootDir))
+        return [];
+    const reg = readRegistry(rootDir);
+    const results = [];
+    for (const w of reg.worktrees) {
+        try {
+            const aheadStr = git(rootDir, ["rev-list", "--count", `${w.baseRef}..${w.branch}`], { throwOnError: false });
+            const ahead = parseInt(aheadStr) || 0;
+            // `ahead > 0` is deliberate: a 0-commit worktree is one an agent is still
+            // working in, and reclaiming it would discard uncommitted work.
+            const isMerged = ahead > 0 && gitOk(rootDir, ["merge-base", "--is-ancestor", w.branch, "HEAD"]);
+            if (isMerged || force) {
+                removeWorktree(rootDir, w.branch, true);
+                results.push({ branch: w.branch, removed: true });
+            }
+            else {
+                results.push({ branch: w.branch, removed: false, reason: "unmerged (use --force)" });
+            }
+        }
+        catch (err) {
+            results.push({ branch: w.branch, removed: false, reason: err.message });
+        }
+    }
+    return results;
+}
+export function readWorktreeSummary(rootDir) {
+    const worktrees = listWorktrees(rootDir);
+    if (worktrees.length === 0)
+        return "worktrees=0";
+    const statuses = worktrees.map((w) => worktreeStatus(rootDir, w.branch));
+    const dirty = statuses.filter((s) => !s.clean).length;
+    const total = statuses.length;
+    return `worktrees=${total} dirty=${dirty}`;
+}
+//# sourceMappingURL=worktree.js.map

package/dist/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../src/worktree.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,35 +1,72 @@
 {
   "name": "devloom",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "DevLoom – Autonomous Development Weaver for OpenCode. Transforms a single prompt into fully tested, documented software.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./server": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./tui": {
+      "import": "./dist/tui.js",
+      "types": "./dist/tui.d.ts"
+    }
+  },
+  "dependencies": {
+    "@opentui/solid": "0.4.5",
+    "solid-js": "1.9.12"
+  },
   "files": [
+    ".ai",
+    ".opencode/themes",
     "dist",
     "agents",
     "commands",
+    "skills",
+    "protocol",
+    "patterns",
+    "project",
+    "scripts",
     "postinstall.mjs",
     "README.md",
-    "GUIDE.md"
+    "GUIDE.md",
+    "SECURITY.md"
   ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "postinstall": "node postinstall.mjs"
+    "postinstall": "node postinstall.mjs",
+    "prepublishOnly": "npm run build && npm test",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "test:coverage": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage",
+    "test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch",
+    "visual-benchmark": "node scripts/visual-benchmark.mjs"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=9.0.0"
   },
   "peerDependencies": {
-    "@opencode-ai/plugin": ">=0.6.0"
+    "@opencode-ai/plugin": ">=0.6.0 <2.0.0"
   },
-
   "devDependencies": {
     "@opencode-ai/plugin": "^1.15.7",
+    "@types/jest": "^30.0.0",
     "@types/node": "^25.9.1",
+    "jest": "^30.4.2",
+    "ts-jest": "^29.4.11",
     "typescript": "^5.4.0"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/nsrau/devloom.git"
+    "url": "git+https://github.com/nsrau/devloom.git"
   },
   "bugs": {
     "url": "https://github.com/nsrau/devloom/issues"
@@ -44,5 +81,8 @@
     "weaver",
     "code-generation"
   ],
+  "overrides": {
+    "js-yaml": "4.2.0"
+  },
   "license": "MIT"
 }

package/patterns/changelog-drafter.md

@@ -0,0 +1,38 @@
+---
+id: changelog-drafter
+cadence: "0 8 * * *"
+level: L1
+agents: [documenter]
+cost: 30000
+description: "Draft release notes from recent commits"
+---
+# Changelog Drafter Pattern
+
+## Purpose
+Scan recent commits and draft release notes. Read-only (L1). Do not edit source code.
+
+## State Schema
+```json
+{
+  "changelog": {
+    "since": "ISO string",
+    "until": "ISO string",
+    "commits": number,
+    "categories": {
+      "features": string[],
+      "fixes": string[],
+      "chores": string[]
+    },
+    "draftPath": string
+  }
+}
+```
+
+## Agent Chain
+1. documenter — read git log since last release, categorize commits, write draft
+
+## Prompt Template
+"Review commits from {since} to {until}. Categorize into features, fixes, and chores. Draft a changelog entry. L1: do not edit any source code."
+
+## Token Cost Estimate
+~30K tokens per tick.

package/patterns/ci-sweeper.md

@@ -0,0 +1,40 @@
+---
+id: ci-sweeper
+cadence: "*/10 * * * *"
+level: L2
+agents: [developer, qa]
+cost: 300000
+description: "Detect and fix CI failures"
+---
+# CI Sweeper Pattern
+
+## Purpose
+Monitor CI pipeline results and automatically fix common failures. Operates in a worktree to contain changes.
+
+## State Schema
+```json
+{
+  "ci": {
+    "lastRunId": string,
+    "status": "passing" | "failing" | "running",
+    "failureCount": number,
+    "failures": [
+      {
+        "job": string,
+        "type": "test" | "lint" | "build" | "typecheck",
+        "message": string,
+        "attempts": number
+      }
+    ]
+  }
+}
+```
+
+## Agent Chain
+1. developer — inspect CI failure, create fix in worktree
+2. qa — run tests, verify the fix doesn't break other things
+
+## Safety
+- L2: fix only in worktree, never on main branch directly
+- Max 2 attempts per failure type per tick
+- If fix is complex (>3 files), create a ticket instead

package/patterns/daily-triage.md

@@ -0,0 +1,37 @@
+---
+id: daily-triage
+cadence: "0 6 * * *"
+level: L1
+agents: [verifier, documenter]
+cost: 50000
+description: "Report repo health every morning"
+---
+# Daily Triage Pattern
+
+## Purpose
+Generate a daily health report for the repository. Read-only (L1). Do not edit source code.
+
+## State Schema
+```json
+{
+  "report": {
+    "date": "ISO string",
+    "openPRs": number,
+    "failingCI": boolean,
+    "staleBranches": number,
+    "unmergedWorktrees": number,
+    "tokenUsage": number,
+    "recommendations": string[]
+  }
+}
+```
+
+## Agent Chain
+1. verifier (scope=explore) — check repo health, PR count, CI status, stale branches
+2. documenter — write report to .opencode/devloom/reports/daily-YYYY-MM-DD.md
+
+## Prompt Template
+"Run daily triage on this repo. Check: (1) open PRs and their ages, (2) CI status from recent commits, (3) stale branches older than 7 days, (4) unmerged worktrees. Report findings. L1: do not edit any source code."
+
+## Token Cost Estimate
+~50K tokens per tick (verifier explore + documenter write).

package/patterns/dependency-sweeper.md

@@ -0,0 +1,40 @@
+---
+id: dependency-sweeper
+cadence: "0 */6 * * *"
+level: L2
+agents: [verifier, developer]
+cost: 100000
+description: "Patch-only dependency updates"
+---
+# Dependency Sweeper Pattern
+
+## Purpose
+Check for outdated dependencies and apply patch-level updates only. Minor and major updates are reported but not auto-applied.
+
+## State Schema
+```json
+{
+  "deps": {
+    "checked": "ISO string",
+    "updates": [
+      {
+        "name": string,
+        "current": string,
+        "latest": string,
+        "type": "patch" | "minor" | "major",
+        "autoApplied": boolean
+      }
+    ],
+    "vulnerabilities": number
+  }
+}
+```
+
+## Agent Chain
+1. verifier — scan package.json, check for outdated deps (npm outdated), check Snyk/GHSA for vulnerabilities
+2. developer — apply patch updates only, run tests after each update
+
+## Safety
+- L2: patch-only (1.x.x → 1.x.y), never minor/major
+- Run `npm test` after each update batch
+- Log all changes to run-log.json

package/patterns/design-audit.md

@@ -0,0 +1,63 @@
+---
+id: design-audit
+cadence: "on-demand"
+level: L1
+agents: [verifier]
+cost: 200000
+description: "Comprehensive UI/UX + functional audit with automated fix loop — covers visual inconsistencies, broken actions, missing actions, dead-end flows, API mismatches"
+---
+# Design Audit Pattern
+
+## Purpose
+Run exhaustive UI/UX + FUNCTIONAL audits across target pages. Two modes: AUDIT (L1, report-only) catalogs both visual and functional issues; FIX (L2, worktree+verifier) applies unified design system + functional fixes, looping until all items verified.
+
+## State Schema
+```json
+{
+  "audit": {
+    "urls": ["https://..."],
+    "reportPath": ".opencode/devloom/reports/design-audit-YYYY-MM-DD.md",
+    "issueCount": number,
+    "categories": { "ui": N, "functional": N, "missing-action": N, "broken-action": N, "api": N, "state": N },
+    "designSystemSpecPath": ".opencode/devloom/reports/design-system-spec.md"
+  },
+  "fix": {
+    "progress": {
+      "items": [{ "id": "...", "status": "...", "category": "ui|functional|missing-action|broken-action|api|state", "severity": "critical|high|medium|low" }],
+      "completionCondition": "All items verified against design system + functional contract",
+      "total": number, "done": number, "verified": number
+    }
+  }
+}
+```
+
+## Modes
+
+### AUDIT (L1 — report only)
+Analyze every page exhaustively. Catalog BOTH:
+- **UI**: buttons, modals, forms, tables, tabs, colors, spacing, typography, icons, loading/error/empty states, navigation, layout, responsiveness
+- **Functional**: broken buttons, broken links, missing CRUD, missing validations, missing feedback, dead-end flows, API errors, state issues
+
+Produce unified design system spec + functional contract. Tag each issue with category + severity. No source code edits.
+
+### FIX (L2 — worktree + verifier, run-until-done)
+Apply unified design system + functional fixes item-by-item in worktrees. Priority: critical → high → medium → low. Loop until all items verified.
+
+## Agent Chain
+- **AUDIT**: verifier (crawl + catalog + report)
+- **FIX**: developer (implement per-item in worktree) → verifier (verify item matches spec + functional contract)
+
+## Safety
+- L1: no source files modified, no code edits
+- L2: all changes in worktrees, each item verified before proceeding
+- Max retries per item: 3
+- Budget exhaustion → pause, logs partial progress
+
+## Prompt Template (AUDIT)
+"Run design-audit in audit mode. Analyze all pages at {URLs}. For each page: (1) catalog every UI element — buttons, links, inputs, modals, forms, tables, tabs, navigation, colors, spacing, typography, icons, loading/error/empty states; (2) test every functional action — click each button, submit each form, follow each link, switch each tab, verify each API call has error handling, check for missing CRUD/validations/feedback, find dead-end flows and state issues. Tag each issue with category (ui|functional|missing-action|broken-action|api|state) and severity (critical|high|medium|low). Write audit report to .opencode/devloom/reports/design-audit-{DATE}.md and unified spec to .opencode/devloom/reports/design-system-spec.md. L1: do not edit any source code."
+
+## Prompt Template (FIX)
+"Run design-audit in fix mode. Read progress from .opencode/devloom/loop/progress.json. Pick next un-verified item (ordered by severity). Apply the design system spec + functional contract from .opencode/devloom/reports/design-system-spec.md in a worktree (branch: devloom/design-audit/{PAGE}). Fix both UI inconsistencies and functional issues (broken actions, missing handlers, missing validations, dead-end flows, API errors, state problems). Verify the item matches spec + functional contract. If verified, mark progress. Repeat until all items verified or budget exhausted."
+
+## Token Cost Estimate
+~200K tokens per tick (verifier for audit; developer+verifier for fix).

package/patterns/issue-triage.md

@@ -0,0 +1,37 @@
+---
+id: issue-triage
+cadence: "0 */2 * * *"
+level: L1
+agents: [planner]
+cost: 60000
+description: "Propose labels and priorities for new issues"
+---
+# Issue Triage Pattern
+
+## Purpose
+Scan for new GitHub Issues and propose labels, priorities, and assignment suggestions. Read-only (L1).
+
+## State Schema
+```json
+{
+  "issues": [
+    {
+      "number": number,
+      "title": string,
+      "type": "bug" | "feature" | "question" | "docs",
+      "suggestedPriority": "high" | "medium" | "low",
+      "suggestedLabels": string[],
+      "suggestedAgent": string
+    }
+  ]
+}
+```
+
+## Agent Chain
+1. planner — read open issues without labels, classify each, write triage report
+
+## Prompt Template
+"Review open issues without labels. For each: classify as bug/feature/question/docs, suggest priority (high/medium/low), and propose labels. Output to .opencode/devloom/reports/triage-YYYY-MM-DD.md. L1: do not edit any source code."
+
+## Token Cost Estimate
+~60K tokens per tick.

package/patterns/post-merge-cleanup.md

@@ -0,0 +1,34 @@
+---
+id: post-merge-cleanup
+cadence: "0 3 * * *"
+level: L1
+agents: [developer, qa]
+cost: 40000
+description: "Clean up stale branches and worktrees"
+---
+# Post-Merge Cleanup Pattern
+
+## Purpose
+Clean up stale branches and worktrees that have already been merged or are no longer needed. L1: reports only, no destructive actions without confirmation.
+
+## State Schema
+```json
+{
+  "cleanup": {
+    "checked": "ISO string",
+    "staleBranches": number,
+    "mergedWorktrees": number,
+    "orphanedWorktrees": number,
+    "recommendedActions": string[]
+  }
+}
+```
+
+## Agent Chain
+1. developer — list all worktrees, check merge status of each branch
+2. qa — verify branches are safe to remove, report findings
+
+## Safety
+- L1: report-only, no automatic deletion
+- Flag branches merged >7 days ago as cleanup candidates
+- Never delete unmerged branches