@desplega.ai/agent-swarm 1.102.0 → 1.103.0

package/templates/community/code-health-reports/report.mjs

@@ -0,0 +1,378 @@
+import fs from "node:fs";
+import path from "node:path";
+
+const [outDir, repoDir, repoName, runDate, scopePath = "src"] = process.argv.slice(2);
+if (!outDir || !repoDir || !repoName || !runDate) {
+  console.error("Usage: node report.mjs <outDir> <repoDir> <repoName> <runDate> [scopePath]");
+  process.exit(1);
+}
+
+const read = (file) => fs.existsSync(file) ? fs.readFileSync(file, "utf8") : "";
+const csvPath = (name) => path.join(outDir, `${name}.csv`);
+const esc = (value) => String(value ?? "")
+  .replaceAll("&", "&amp;")
+  .replaceAll("<", "&lt;")
+  .replaceAll(">", "&gt;")
+  .replaceAll('"', "&quot;");
+
+function parseCsvRows(text) {
+  const rows = [];
+  let row = [];
+  let cur = "";
+  let quoted = false;
+  for (let i = 0; i < text.length; i++) {
+    const ch = text[i];
+    const next = text[i + 1];
+    if (quoted) {
+      if (ch === '"' && next === '"') {
+        cur += '"';
+        i++;
+      } else if (ch === '"') {
+        quoted = false;
+      } else {
+        cur += ch;
+      }
+    } else if (ch === '"') {
+      quoted = true;
+    } else if (ch === ",") {
+      row.push(cur);
+      cur = "";
+    } else if (ch === "\n") {
+      row.push(cur);
+      rows.push(row);
+      row = [];
+      cur = "";
+    } else if (ch !== "\r") {
+      cur += ch;
+    }
+  }
+  if (cur.length || row.length) {
+    row.push(cur);
+    rows.push(row);
+  }
+  return rows.filter((r) => r.some(Boolean));
+}
+
+function parseCsv(text) {
+  const rows = parseCsvRows(text);
+  if (!rows.length) return [];
+  const headers = rows.shift().map((h) => h.trim());
+  return rows.map((row) => Object.fromEntries(headers.map((h, i) => [h, row[i] ?? ""])));
+}
+
+const num = (value) => {
+  const n = Number(String(value ?? "").replace(/[%\s,]/g, ""));
+  return Number.isFinite(n) ? n : 0;
+};
+
+const pick = (row, names, fallback = "") => {
+  for (const name of names) {
+    if (row?.[name] !== undefined && row[name] !== "") return row[name];
+  }
+  return fallback;
+};
+
+const normalize = (file) => String(file ?? "")
+  .replace(`${repoDir}/`, "")
+  .replace(/^\.?\//, "");
+
+function currentLocByFile() {
+  const files = read(path.join(outDir, "src-files.txt")).trim().split("\n").filter(Boolean);
+  const loc = new Map();
+  for (const file of files) {
+    const full = path.join(repoDir, file);
+    if (!fs.existsSync(full) || fs.statSync(full).isDirectory()) continue;
+    const text = fs.readFileSync(full, "utf8");
+    loc.set(normalize(file), text.split("\n").filter((line) => line.trim()).length);
+  }
+  return loc;
+}
+
+function complexityByFile() {
+  const rows = parseCsvRows(read(path.join(outDir, "lizard-functions.csv")));
+  const byFile = new Map();
+  for (const row of rows) {
+    const file = normalize(row[6]);
+    if (!file || !file.startsWith(`${scopePath}/`)) continue;
+    const entry = byFile.get(file) ?? { file, functions: 0, totalCcn: 0, maxCcn: 0 };
+    const ccn = num(row[1]);
+    entry.functions += 1;
+    entry.totalCcn += ccn;
+    entry.maxCcn = Math.max(entry.maxCcn, ccn);
+    byFile.set(file, entry);
+  }
+  return byFile;
+}
+
+const loc = currentLocByFile();
+const complexity = complexityByFile();
+const revisionsRows = parseCsv(read(csvPath("revisions")));
+const couplingRows = parseCsv(read(csvPath("coupling")));
+const ageRows = parseCsv(read(csvPath("age")));
+const authorsRows = parseCsv(read(csvPath("authors")));
+const ownershipRows = parseCsv(read(csvPath("main-dev")));
+const summaryRows = parseCsv(read(csvPath("summary")));
+
+const summaryStats = Object.fromEntries(summaryRows.map((row) => [pick(row, ["statistic", "name"]), num(pick(row, ["value", "n"]))]));
+const authorCountByFile = new Map();
+for (const row of authorsRows) {
+  authorCountByFile.set(normalize(pick(row, ["entity", "module", "file"])), num(pick(row, ["n-authors", "authors", "author-count", "count"])));
+}
+
+const ageByFile = new Map();
+for (const row of ageRows) {
+  ageByFile.set(normalize(pick(row, ["entity", "module", "file"])), {
+    ageMonths: num(pick(row, ["age-months", "age", "months"])),
+    lastChange: pick(row, ["last-revision", "last-modified", "date"], ""),
+  });
+}
+
+const ownershipByFile = new Map();
+for (const row of ownershipRows) {
+  const file = normalize(pick(row, ["entity", "module", "file"]));
+  ownershipByFile.set(file, {
+    mainDeveloper: pick(row, ["main-dev", "author", "developer"], "Unknown"),
+    ownershipPercent: (() => {
+      const value = num(pick(row, ["ownership", "ownership%", "contribution"]));
+      return value <= 1 && value > 0 ? Math.round(value * 1000) / 10 : Math.round(value * 10) / 10;
+    })(),
+  });
+}
+
+const files = revisionsRows.map((row) => {
+  const file = normalize(pick(row, ["entity", "module", "file"]));
+  const revs = num(pick(row, ["n-revs", "revisions", "revs"]));
+  const cx = complexity.get(file) ?? { functions: 0, totalCcn: 0, maxCcn: 0 };
+  const owned = ownershipByFile.get(file) ?? { mainDeveloper: "Unknown", ownershipPercent: 0 };
+  const age = ageByFile.get(file) ?? { ageMonths: 0, lastChange: "" };
+  const totalCcn = cx.totalCcn || cx.maxCcn || 0;
+  return {
+    file,
+    revs,
+    loc: loc.get(file) ?? 0,
+    functions: cx.functions,
+    totalCcn,
+    maxCcn: cx.maxCcn,
+    riskScore: Math.round(revs * Math.log2(totalCcn + 1) * 10) / 10,
+    mainDeveloper: owned.mainDeveloper,
+    ownershipPercent: owned.ownershipPercent,
+    authorCount: authorCountByFile.get(file) || 0,
+    ageMonths: age.ageMonths,
+    lastChange: age.lastChange,
+  };
+}).filter((row) => row.file.startsWith(`${scopePath}/`));
+
+files.sort((a, b) => b.riskScore - a.riskScore);
+const topRisk = files.slice(0, 25);
+const chartFiles = files.slice(0, 100);
+
+const coupling = couplingRows.map((row) => ({
+  a: normalize(pick(row, ["entity", "entity-1", "module", "file"])),
+  b: normalize(pick(row, ["coupled", "entity-2", "coupled-entity"])),
+  degree: num(pick(row, ["degree", "coupling", "coupling%"])),
+  sharedRevs: num(pick(row, ["average-revs", "shared-revisions", "shared-revs", "n-revs"])),
+})).filter((row) => row.a.startsWith(`${scopePath}/`) && row.b.startsWith(`${scopePath}/`))
+  .sort((a, b) => (b.degree - a.degree) || (b.sharedRevs - a.sharedRevs))
+  .slice(0, 30);
+
+const ageBuckets = [
+  { label: "0-1m", min: 0, max: 1, files: 0, loc: 0 },
+  { label: "1-3m", min: 1, max: 3, files: 0, loc: 0 },
+  { label: "3-6m", min: 3, max: 6, files: 0, loc: 0 },
+  { label: "6-12m", min: 6, max: 12, files: 0, loc: 0 },
+  { label: "12m+", min: 12, max: Infinity, files: 0, loc: 0 },
+];
+for (const file of files) {
+  const bucket = ageBuckets.find((b) => file.ageMonths >= b.min && file.ageMonths < b.max);
+  if (bucket) {
+    bucket.files += 1;
+    bucket.loc += file.loc;
+  }
+}
+
+const summary = {
+  repoName,
+  runDate,
+  scopePath,
+  generatedAt: new Date().toISOString(),
+  commit: read(path.join(outDir, "revision.txt")).trim(),
+  commitSummary: read(path.join(outDir, "revision-summary.txt")).trim(),
+  totals: {
+    commitsInScopedLog: summaryStats["number-of-commits"] || 0,
+    entities: summaryStats["number-of-entities"] || files.length,
+    trackedFiles: read(path.join(outDir, "src-files.txt")).trim().split("\n").filter(Boolean).length,
+    authors: summaryStats["number-of-authors"] || 0,
+    totalLoc: files.reduce((sum, file) => sum + file.loc, 0),
+  },
+  topRisk,
+  topCoupling: coupling,
+  ageBuckets,
+  charts: {
+    files: chartFiles,
+    ageBuckets,
+  },
+  references: {
+    d3: "https://d3js.org",
+    codeMaat: "https://github.com/adamtornhill/code-maat",
+    lizard: "https://github.com/terryyin/lizard",
+  },
+};
+
+fs.writeFileSync(path.join(outDir, "summary.json"), JSON.stringify(summary, null, 2));
+fs.writeFileSync(path.join(outDir, "latest-pointer.json"), JSON.stringify({
+  repoName,
+  runDate,
+  path: outDir,
+  latestJson: path.join(path.dirname(outDir), "latest.json"),
+  latestHtml: path.join(path.dirname(outDir), "latest.html"),
+  generatedAt: summary.generatedAt,
+}, null, 2));
+
+const dataJson = JSON.stringify(summary).replaceAll("</script", "<\\/script");
+const rows = (items, columns) => items.map((item) => `<tr>${columns.map((col) => `<td>${esc(typeof col === "function" ? col(item) : item[col])}</td>`).join("")}</tr>`).join("\n");
+
+const html = `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>Code Health Report - ${esc(repoName)}</title>
+  <style>
+    body { margin: 0; background: #f7f6f3; color: #181817; font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; line-height: 1.5; }
+    main { width: min(1180px, calc(100% - 32px)); margin: 0 auto; padding: 48px 0 80px; }
+    h1 { font-size: clamp(2rem, 5vw, 4rem); line-height: 1; margin: 0 0 12px; }
+    h2 { margin-top: 40px; }
+    p, .muted { color: #686660; }
+    .grid { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 12px; margin: 28px 0; }
+    .metric, .card { background: #fff; border: 1px solid #e4ded3; border-radius: 8px; padding: 18px; }
+    .metric span { display: block; color: #686660; font-size: 12px; font-weight: 700; text-transform: uppercase; }
+    .metric strong { display: block; margin-top: 8px; font-size: 30px; }
+    .charts { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; }
+    .chart { height: 360px; }
+    svg { width: 100%; height: 100%; display: block; }
+    table { width: 100%; border-collapse: collapse; font-size: 13px; background: #fff; border: 1px solid #e4ded3; border-radius: 8px; overflow: hidden; }
+    th, td { padding: 8px 10px; border-bottom: 1px solid #eee8dc; text-align: left; vertical-align: top; }
+    th { color: #686660; font-size: 11px; text-transform: uppercase; letter-spacing: .06em; }
+    td { max-width: 380px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+    code { background: #fff; border: 1px solid #e4ded3; padding: 1px 5px; border-radius: 4px; }
+    @media (max-width: 860px) { .grid, .charts { grid-template-columns: 1fr; } }
+  </style>
+</head>
+<body>
+<main>
+  <p class="muted">Generated ${esc(summary.generatedAt)}</p>
+  <h1>Code Health Report</h1>
+  <p><strong>${esc(repoName)}</strong> at <code>${esc(summary.commit.slice(0, 12))}</code>. Scope: <code>${esc(scopePath)}/**</code>.</p>
+
+  <section class="grid">
+    <div class="metric"><span>Scoped commits</span><strong>${esc(summary.totals.commitsInScopedLog || "n/a")}</strong></div>
+    <div class="metric"><span>Entities</span><strong>${esc(summary.totals.entities)}</strong></div>
+    <div class="metric"><span>Tracked files</span><strong>${esc(summary.totals.trackedFiles)}</strong></div>
+    <div class="metric"><span>Current LOC</span><strong>${esc(summary.totals.totalLoc)}</strong></div>
+  </section>
+
+  <section class="charts">
+    <div class="card">
+      <h2>Hotspots</h2>
+      <p>Bubble size is current LOC. Color is churn x complexity score.</p>
+      <div id="bubble" class="chart"></div>
+    </div>
+    <div class="card">
+      <h2>Change Frequency x Complexity</h2>
+      <p>X is revisions. Y is total cyclomatic complexity.</p>
+      <div id="scatter" class="chart"></div>
+    </div>
+  </section>
+
+  <h2>Top Hotspots</h2>
+  <table>
+    <thead><tr><th>File</th><th>Revs</th><th>LOC</th><th>Total CCN</th><th>Max CCN</th><th>Risk Score</th><th>Main Dev</th><th>Authors</th><th>Own %</th></tr></thead>
+    <tbody>${rows(topRisk, [
+      "file",
+      "revs",
+      "loc",
+      "totalCcn",
+      "maxCcn",
+      "riskScore",
+      "mainDeveloper",
+      "authorCount",
+      "ownershipPercent",
+    ])}</tbody>
+  </table>
+
+  <h2>Temporal Coupling</h2>
+  <table>
+    <thead><tr><th>Entity A</th><th>Entity B</th><th>Degree %</th><th>Shared Revs</th></tr></thead>
+    <tbody>${rows(coupling, ["a", "b", "degree", "sharedRevs"])}</tbody>
+  </table>
+
+  <h2>Code Age</h2>
+  <div id="age" class="chart card"></div>
+
+  <h2>References</h2>
+  <ul>
+    <li><a href="https://github.com/adamtornhill/code-maat">Code Maat</a></li>
+    <li><a href="https://d3js.org">D3.js</a></li>
+    <li><a href="https://github.com/terryyin/lizard">Lizard</a></li>
+  </ul>
+</main>
+<script>window.__CODE_MAAT_DATA__ = ${dataJson};</script>
+<script src="https://cdn.jsdelivr.net/npm/d3@7/dist/d3.min.js"></script>
+<script>
+const data = window.__CODE_MAAT_DATA__;
+const colors = d3.scaleSequential(d3.interpolateYlOrRd).domain([0, d3.max(data.charts.files, d => d.riskScore) || 1]);
+
+function drawBubble() {
+  const el = document.querySelector("#bubble");
+  const width = el.clientWidth;
+  const height = el.clientHeight;
+  const root = d3.hierarchy({ children: data.charts.files }).sum(d => d.loc || 1);
+  d3.pack().size([width, height]).padding(3)(root);
+  const svg = d3.select(el).append("svg");
+  const node = svg.selectAll("g").data(root.leaves()).join("g").attr("transform", d => \`translate(\${d.x},\${d.y})\`);
+  node.append("circle").attr("r", d => d.r).attr("fill", d => colors(d.data.riskScore)).attr("stroke", "#fff");
+  node.append("title").text(d => \`\${d.data.file}\\nrevs: \${d.data.revs}\\nccn: \${d.data.totalCcn}\\nrisk: \${d.data.riskScore}\`);
+}
+
+function drawScatter() {
+  const el = document.querySelector("#scatter");
+  const width = el.clientWidth;
+  const height = el.clientHeight;
+  const margin = { top: 20, right: 20, bottom: 38, left: 48 };
+  const svg = d3.select(el).append("svg");
+  const x = d3.scaleLinear().domain([0, d3.max(data.charts.files, d => d.revs) || 1]).nice().range([margin.left, width - margin.right]);
+  const y = d3.scaleLinear().domain([0, d3.max(data.charts.files, d => d.totalCcn) || 1]).nice().range([height - margin.bottom, margin.top]);
+  const r = d3.scaleSqrt().domain([0, d3.max(data.charts.files, d => d.loc) || 1]).range([3, 18]);
+  svg.append("g").attr("transform", \`translate(0,\${height - margin.bottom})\`).call(d3.axisBottom(x));
+  svg.append("g").attr("transform", \`translate(\${margin.left},0)\`).call(d3.axisLeft(y));
+  svg.selectAll("circle").data(data.charts.files).join("circle")
+    .attr("cx", d => x(d.revs)).attr("cy", d => y(d.totalCcn)).attr("r", d => r(d.loc))
+    .attr("fill", d => colors(d.riskScore)).attr("opacity", 0.82).append("title")
+    .text(d => \`\${d.file}\\nrevs: \${d.revs}\\nccn: \${d.totalCcn}\\nrisk: \${d.riskScore}\`);
+}
+
+function drawAge() {
+  const el = document.querySelector("#age");
+  const width = el.clientWidth;
+  const height = el.clientHeight;
+  const margin = { top: 20, right: 20, bottom: 38, left: 56 };
+  const svg = d3.select(el).append("svg");
+  const x = d3.scaleBand().domain(data.ageBuckets.map(d => d.label)).range([margin.left, width - margin.right]).padding(0.2);
+  const y = d3.scaleLinear().domain([0, d3.max(data.ageBuckets, d => d.loc) || 1]).nice().range([height - margin.bottom, margin.top]);
+  svg.append("g").attr("transform", \`translate(0,\${height - margin.bottom})\`).call(d3.axisBottom(x));
+  svg.append("g").attr("transform", \`translate(\${margin.left},0)\`).call(d3.axisLeft(y));
+  svg.selectAll("rect").data(data.ageBuckets).join("rect")
+    .attr("x", d => x(d.label)).attr("y", d => y(d.loc)).attr("width", x.bandwidth()).attr("height", d => y(0) - y(d.loc))
+    .attr("fill", "#8a5a12").append("title").text(d => \`\${d.label}: \${d.loc} LOC, \${d.files} files\`);
+}
+
+if (window.d3) {
+  drawBubble();
+  drawScatter();
+  drawAge();
+}
+</script>
+</body>
+</html>`;
+
+fs.writeFileSync(path.join(outDir, "report.html"), html);

package/templates/community/code-health-reports/run.sh

@@ -0,0 +1,143 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Code Maat + D3 recurring code-health report template.
+#
+# Lead kickoff prompt:
+#   See ./lead-prompt.md in this template. It is the canonical copy-paste prompt
+#   for asking an agent-swarm Lead to install this runner, run it once, publish a
+#   stable page, and schedule weekly refreshes.
+#
+# Default weekly cadence for the surrounding swarm schedule:
+#   cron: "0 21 * * 0"
+#   timezone: "UTC"
+# Change the cron field to adjust when the report refreshes. Keep the same page
+# ID when publishing so the report URL stays stable.
+#
+# Code Maat license note:
+#   Code Maat is GPLv3. This template does not vendor or redistribute the JAR.
+#   It downloads the upstream standalone JAR at runtime on first run.
+
+BASE_DIR="${BASE_DIR:-/workspace/code-maat}"
+REPO_NAME="${REPO_NAME:-my-repo}"
+REPO_URL="${REPO_URL:-https://github.com/OWNER/REPO.git}"
+BRANCH="${BRANCH:-main}"
+SCOPE_PATH="${SCOPE_PATH:-src}"
+LOCAL_SOURCE="${LOCAL_SOURCE:-}"
+
+REPO_DIR="$BASE_DIR/repos/$REPO_NAME"
+OUT_ROOT="$BASE_DIR/out/$REPO_NAME"
+RUN_DATE="${RUN_DATE:-$(date -u +%F)}"
+OUT_DIR="$OUT_ROOT/$RUN_DATE"
+JAR="$BASE_DIR/code-maat.jar"
+CODE_MAAT_URL="${CODE_MAAT_URL:-https://github.com/adamtornhill/code-maat/releases/download/v1.0.4/code-maat-1.0.4-standalone.jar}"
+
+mkdir -p "$BASE_DIR/repos" "$OUT_DIR"
+
+need_cmd() {
+  command -v "$1" >/dev/null 2>&1
+}
+
+ensure_java() {
+  if ! need_cmd java; then
+    sudo apt-get update
+    sudo apt-get install -y default-jre-headless
+  fi
+}
+
+ensure_node() {
+  if ! need_cmd node; then
+    sudo apt-get update
+    sudo apt-get install -y nodejs
+  fi
+}
+
+ensure_python() {
+  if ! need_cmd python3; then
+    sudo apt-get update
+    sudo apt-get install -y python3 python3-pip
+  fi
+}
+
+ensure_lizard() {
+  ensure_python
+  if ! need_cmd lizard && [ ! -x "$HOME/.local/bin/lizard" ]; then
+    python3 -m pip install --break-system-packages --user lizard
+  fi
+}
+
+ensure_code_maat() {
+  if [ ! -s "$JAR" ]; then
+    curl -fsSL -o "$JAR" "$CODE_MAAT_URL"
+  fi
+  java -jar "$JAR" --help >/dev/null
+}
+
+prepare_repo() {
+  if [ -d "$REPO_DIR/.git" ]; then
+    git -C "$REPO_DIR" remote set-url --push origin DISABLED >/dev/null 2>&1 || true
+    git -C "$REPO_DIR" fetch origin "$BRANCH" --prune
+    git -C "$REPO_DIR" checkout -q "$BRANCH" || git -C "$REPO_DIR" checkout -q -B "$BRANCH" "origin/$BRANCH"
+    git -C "$REPO_DIR" reset --hard "origin/$BRANCH" >/dev/null
+    git -C "$REPO_DIR" clean -fdx >/dev/null
+    return
+  fi
+
+  if [ -n "$LOCAL_SOURCE" ] && [ -d "$LOCAL_SOURCE/.git" ]; then
+    git clone --no-hardlinks "$LOCAL_SOURCE" "$REPO_DIR"
+    git -C "$REPO_DIR" remote set-url origin "$REPO_URL" || true
+    git -C "$REPO_DIR" remote set-url --push origin DISABLED || true
+    git -C "$REPO_DIR" fetch origin "$BRANCH" --prune
+    git -C "$REPO_DIR" checkout -q "$BRANCH" || git -C "$REPO_DIR" checkout -q -B "$BRANCH" "origin/$BRANCH"
+    git -C "$REPO_DIR" reset --hard "origin/$BRANCH" >/dev/null
+  else
+    git clone --branch "$BRANCH" "$REPO_URL" "$REPO_DIR"
+    git -C "$REPO_DIR" remote set-url --push origin DISABLED || true
+  fi
+}
+
+run_code_maat() {
+  local analysis="$1"
+  shift || true
+  java -jar "$JAR" -l "$OUT_DIR/git-src.log" -c git2 -a "$analysis" "$@" -o "$OUT_DIR/$analysis.csv"
+}
+
+ensure_java
+ensure_node
+ensure_lizard
+ensure_code_maat
+prepare_repo
+
+git -C "$REPO_DIR" log --all --numstat --date=short --pretty=format:'--%h--%ad--%aN' --no-renames -- "$SCOPE_PATH" > "$OUT_DIR/git-src.log"
+git -C "$REPO_DIR" rev-parse HEAD > "$OUT_DIR/revision.txt"
+git -C "$REPO_DIR" log -1 --format='%h %ad %an %s' --date=short > "$OUT_DIR/revision-summary.txt"
+git -C "$REPO_DIR" ls-files "$SCOPE_PATH/**" > "$OUT_DIR/src-files.txt"
+
+run_code_maat summary
+run_code_maat revisions -r 10000 -n 1
+run_code_maat coupling -r 10000 -m 2 -i 1 -s 60
+run_code_maat age -r 10000 -d "$RUN_DATE"
+run_code_maat authors -r 10000
+run_code_maat entity-ownership -r 10000
+run_code_maat entity-effort -r 10000
+run_code_maat main-dev -r 10000
+run_code_maat main-dev-by-revs -r 10000
+run_code_maat abs-churn -r 10000
+run_code_maat author-churn -r 10000
+run_code_maat entity-churn -r 10000
+
+LIZARD_BIN="$(command -v lizard || true)"
+if [ -z "$LIZARD_BIN" ] && [ -x "$HOME/.local/bin/lizard" ]; then
+  LIZARD_BIN="$HOME/.local/bin/lizard"
+fi
+"$LIZARD_BIN" --csv "$REPO_DIR/$SCOPE_PATH" > "$OUT_DIR/lizard-functions.csv" || true
+
+node "$BASE_DIR/report.mjs" "$OUT_DIR" "$REPO_DIR" "$REPO_NAME" "$RUN_DATE" "$SCOPE_PATH"
+
+cp "$OUT_DIR/summary.json" "$OUT_ROOT/latest.json"
+cp "$OUT_DIR/report.html" "$OUT_ROOT/latest.html"
+cp "$OUT_DIR/latest-pointer.json" "$OUT_ROOT/latest-pointer.json"
+
+echo "Wrote $OUT_DIR"
+echo "Latest summary: $OUT_ROOT/latest.json"
+echo "Latest page HTML: $OUT_ROOT/latest.html"

package/templates/schedules/weekly-code-health-reports/config.json

@@ -0,0 +1,13 @@
+{
+  "kind": "schedule",
+  "name": "weekly-code-health-reports",
+  "displayName": "Weekly Code Health Reports",
+  "slug": "weekly-code-health-reports",
+  "title": "Weekly Code Health Reports",
+  "description": "Gallery entry point for the community Code Maat + D3 code-health report package. Run a weekly report and update a stable page in place.",
+  "version": "1.0.0",
+  "category": "schedules",
+  "placeholders": ["REPO_URL", "BRANCH", "SCOPE_PATH", "REPORT_NAME", "PAGE_ID", "TIMEZONE"],
+  "runAllSeedersCandidate": false,
+  "tags": ["code-quality", "maintenance", "reporting", "community-template"]
+}

package/templates/schedules/weekly-code-health-reports/content.md

@@ -0,0 +1,60 @@
+# Weekly Code Health Reports
+
+Run a recurring Code Maat + D3 code-health report for a repository and update the same stable report page in place.
+
+This schedule is the templates gallery entry point for the community package in `templates/community/code-health-reports/`. The package itself is intentionally not an agent-template config; it is a runnable playbook bundle (`PLAYBOOK.md`, `run.sh`, `report.mjs`, and `lead-prompt.md`) used by this schedule.
+
+## Schedule
+
+```json
+{
+  "cron": "0 21 * * 0",
+  "timezone": "UTC",
+  "agentRole": "worker",
+  "enabled": true
+}
+```
+
+## Scheduled Task
+
+This is a reusable starting prompt. Before enabling it, replace the repository, scope, branch, report name, page ID, timezone, and worker targeting details with values for your project.
+
+Task Type: Weekly Code Health Reports
+
+Repository: `https://github.com/OWNER/REPO.git`
+Default branch: `main`
+Path scope: `src`
+Report name: `my-repo`
+Stable page ID: `<PAGE_ID>`
+
+## Instructions
+
+1. Use the community template in `templates/community/code-health-reports/`. See the docs playbook at `https://docs.agent-swarm.dev/docs/playbooks/code-health-reports` for the full setup and attribution notes.
+2. Install or update the runner workspace under `/workspace/code-maat`:
+   - `run.sh`
+   - `report.mjs`
+   - `lead-prompt.md`
+3. Run the report with project-specific parameters:
+
+   ```bash
+   BASE_DIR=/workspace/code-maat \
+   REPO_NAME=my-repo \
+   REPO_URL=https://github.com/OWNER/REPO.git \
+   BRANCH=main \
+   SCOPE_PATH=src \
+   bash /workspace/code-maat/run.sh
+   ```
+
+4. Publish `/workspace/code-maat/out/my-repo/latest.html` to the existing stable page ID. Do not create a new page for routine refreshes.
+5. Verify the rendered page loads and the D3 charts are not blank.
+6. If the run fails because of a local runner, dependency, branch, or report-generator issue, diagnose and fix it before reporting failure.
+
+## Cadence
+
+The default cron is `0 21 * * 0`, weekly on Sunday at 21:00 UTC. Change the `cron` field to adjust when the report refreshes, and change `timezone` if the cron should be interpreted in a different zone.
+
+The cadence is separate from page identity. Keep updating the same page ID so the report URL remains stable.
+
+## Completion
+
+Call `store-progress` with status `completed` and an output summary that includes the stable page URL, report workspace path, commit analyzed, generated timestamp, and any dependency or chart-rendering issues found.