@desplega.ai/agent-swarm 1.92.0 → 1.92.1

package/src/be/seed-scripts/catalog/ops-catalog-audit.ts

@@ -1,4 +1,9 @@
 import { z } from "zod";
+import {
+  type CatalogReport,
+  publishCatalogReportPage,
+  renderCatalogReportPage,
+} from "./catalog-report";
 
 export const argsSchema = z.object({
   nowIso: z.string().optional().describe("Audit clock override (default: current time)"),
@@ -22,7 +27,7 @@ export const argsSchema = z.object({
 const CODE_WORK_RE =
   /\b(git|github|gh\b|gh-cli|docker|docker-compose|bun|npm|pnpm|yarn|tsc|eslint|lint|test|pr\b|pull request|branch|commit|repo|worktree|typescript|javascript)\b/i;
 const CODE_AGENT_RE =
-  /\b(code|coder|coding|implement|implementation|engineer|software|typescript|javascript|repo|github|picateclas)\b/i;
+  /\b(code|coder|coding|implement|implementation|engineer|software|typescript|javascript|repo|github)\b/i;
 const NON_CODE_AGENT_RE = /\b(content|reviewer|research|sales|gtm|support|ops|lead)\b/i;
 const SMOKE_WORKFLOW_RE =
   /\b(smoke|demo|litmus-smoke|one[- ]shot|validation|des-462-gate-validation|gsc-runtime-smoke)\b/i;
@@ -74,6 +79,11 @@ function compactText(value: unknown, max = 180): string {
   return asText(value).replace(/\s+/g, " ").trim().slice(0, max);
 }
 
+function formatMetric(value: unknown): string {
+  if (typeof value === "number") return new Intl.NumberFormat("en-US").format(value);
+  return asText(value);
+}
+
 function daysSince(iso: string | null | undefined, nowMs: number): number | null {
   if (!iso) return null;
   const t = Date.parse(iso);
@@ -115,449 +125,34 @@ function hasStructuredOutput(value: any): boolean {
   return /"outputSchema"|"schema"|"jsonSchema"|"structured"/i.test(JSON.stringify(value ?? {}));
 }
 
-function htmlEscape(value: unknown): string {
-  return asText(value)
-    .replace(/&/g, "&")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;")
-    .replace(/"/g, "&quot;");
-}
-
-function humanLabel(value: string): string {
-  return value
-    .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
-    .replace(/[-_.]+/g, " ")
-    .replace(/\b\w/g, (char) => char.toUpperCase());
-}
-
-function formatMetric(value: unknown): string {
-  if (typeof value === "number") return new Intl.NumberFormat("en-US").format(value);
-  return asText(value);
-}
-
-function severityTone(value: string): string {
-  if (value === "critical") return "danger";
-  if (value === "high") return "warn";
-  if (value === "medium") return "note";
-  return "low";
-}
-
-function renderSampleValue(value: unknown): string {
-  if (Array.isArray(value)) {
-    return value
-      .map((item) => (typeof item === "object" && item !== null ? JSON.stringify(item) : asText(item)))
-      .join(", ");
-  }
-  if (value && typeof value === "object") return JSON.stringify(value);
-  return asText(value);
-}
-
-function renderSamples(samples: any[]): string {
-  if (!Array.isArray(samples) || samples.length === 0) return "";
-  const normalized = samples.map((sampleRow) =>
-    sampleRow && typeof sampleRow === "object" && !Array.isArray(sampleRow)
-      ? sampleRow
-      : { value: sampleRow },
-  );
-  const columns = Array.from(
-    new Set(normalized.flatMap((sampleRow) => Object.keys(sampleRow).slice(0, 6))),
-  ).slice(0, 6);
-  if (columns.length === 0) return "";
-  const rows = normalized
-    .map(
-      (sampleRow) =>
-        `<tr>${columns
-          .map((column) => `<td>${htmlEscape(renderSampleValue(sampleRow[column]))}</td>`)
-          .join("")}</tr>`,
-    )
-    .join("");
-  return `<div class="sample-table" aria-label="Sample rows">
-    <table>
-      <thead><tr>${columns.map((column) => `<th>${htmlEscape(humanLabel(column))}</th>`).join("")}</tr></thead>
-      <tbody>${rows}</tbody>
-    </table>
-  </div>`;
-}
-
-export function renderPage(result: any): string {
-  const metrics = [
+export function buildReport(result: any): CatalogReport {
+  return {
+    title: "Ops Catalog Audit",
+    slug: "ops-catalog-audit",
+    description: "Clustered audit-as-code report for schedules, workflows, and prompts/templates.",
+    generatedAt: result.generatedAt,
+    lede: `A re-runnable audit of schedules, workflows, and prompt/template catalogs. It found ${formatMetric(
+      result.summary.findingsTotal,
+    )} actionable issue cluster(s), with the highest-risk items called out first inside each group.`,
+    metrics: [
     ["Findings", result.summary.findingsTotal],
     ["Schedules enabled", result.summary.schedulesEnabled],
     ["Workflows enabled", result.summary.workflowsEnabled],
     ["Prompt templates", result.summary.promptTemplates],
-  ];
-  const sections = ["schedules", "workflows", "promptsTemplates"]
-    .map((key) => {
-      const group = result.goals[key];
-      const findings = group.findings
-        .map(
-          (finding: any) => `<article class="finding ${htmlEscape(severityTone(finding.severity))}">
-            <div class="finding-head">
-              <div>
-                <p class="finding-id">${htmlEscape(finding.id)}</p>
-                <h3>${htmlEscape(finding.summary)}</h3>
-              </div>
-              <span class="pill ${htmlEscape(severityTone(finding.severity))}">${htmlEscape(
-                finding.severity,
-              )}</span>
-            </div>
-            <p class="action">${htmlEscape(finding.action)}</p>
-            ${renderSamples(finding.samples)}
-          </article>`,
-        )
-        .join("");
-      const checks = Object.entries(group.checks || {})
-        .map(
-          ([label, value]) =>
-            `<div class="check"><span>${htmlEscape(humanLabel(label))}</span><strong>${htmlEscape(
-              formatMetric(value),
-            )}</strong></div>`,
-        )
-        .join("");
-      return `<section class="section">
-        <div class="section-grid">
-          <aside class="checks">
-            <p class="section-kicker">${htmlEscape(humanLabel(key))}</p>
-            <div class="check-list">${checks}</div>
-          </aside>
-          <div>
-            <div class="section-head">
-              <h2>${htmlEscape(group.goal)}</h2>
-              <span>${htmlEscape(formatMetric(group.findingCount))} finding(s)</span>
-            </div>
-            <div class="findings">
-              ${findings || '<p class="empty">No actionable findings in this cluster.</p>'}
-            </div>
-          </div>
-        </div>
-      </section>`;
-    })
-    .join("\n");
-  return `<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <meta name="theme-color" content="#f5f2ea">
-  <title>Ops Catalog Audit</title>
-  <style>
-    :root {
-      color-scheme: light;
-      --bg: #f5f2ea;
-      --panel: #ffffff;
-      --ink: #18181b;
-      --muted: #5f6368;
-      --line: #ded8cb;
-      --accent: #255c99;
-      --danger: #b42318;
-      --danger-bg: #fff1f0;
-      --warn: #b54708;
-      --warn-bg: #fff7ed;
-      --note: #175cd3;
-      --note-bg: #eff6ff;
-      --low: #067647;
-      --low-bg: #ecfdf3;
-      --radius: 8px;
-      --shadow: 0 1px 2px rgba(24, 24, 27, 0.06), 0 14px 36px rgba(24, 24, 27, 0.07);
-    }
-    * { box-sizing: border-box; }
-    body {
-      margin: 0;
-      background: var(--bg);
-      color: var(--ink);
-      font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
-      font-size: 16px;
-      line-height: 1.55;
-    }
-    main {
-      width: min(1120px, calc(100% - 32px));
-      margin: 0 auto;
-      padding: 48px 0 72px;
-    }
-    header { margin-bottom: 28px; }
-    .eyebrow {
-      margin: 0 0 8px;
-      color: var(--muted);
-      font-size: 13px;
-      font-weight: 750;
-      letter-spacing: 0.08em;
-      text-transform: uppercase;
-    }
-    h1 {
-      margin: 0;
-      max-width: 860px;
-      font-size: clamp(2rem, 4vw, 3rem);
-      line-height: 1.05;
-      letter-spacing: 0;
-    }
-    .lede {
-      max-width: 780px;
-      margin: 16px 0 0;
-      color: var(--muted);
-      font-size: 18px;
-    }
-    .metrics {
-      display: grid;
-      grid-template-columns: repeat(4, minmax(0, 1fr));
-      gap: 12px;
-      margin: 32px 0;
-    }
-    .metric, .section, details {
-      background: var(--panel);
-      border: 1px solid var(--line);
-      border-radius: var(--radius);
-      box-shadow: var(--shadow);
-    }
-    .metric { padding: 18px; }
-    .metric strong {
-      display: block;
-      font-size: 32px;
-      line-height: 1;
-      font-variant-numeric: tabular-nums;
-    }
-    .metric span {
-      display: block;
-      margin-top: 8px;
-      color: var(--muted);
-      font-size: 13px;
-      font-weight: 650;
-    }
-    .section {
-      margin-top: 18px;
-      padding: 24px;
-    }
-    .section-grid {
-      display: grid;
-      grid-template-columns: 260px minmax(0, 1fr);
-      gap: 28px;
-    }
-    .section-kicker {
-      margin: 0 0 12px;
-      color: var(--accent);
-      font-size: 13px;
-      font-weight: 800;
-      letter-spacing: 0.08em;
-      text-transform: uppercase;
-    }
-    .check-list {
-      display: grid;
-      gap: 8px;
-    }
-    .check {
-      display: flex;
-      align-items: baseline;
-      justify-content: space-between;
-      gap: 12px;
-      padding: 10px 0;
-      border-bottom: 1px solid var(--line);
-    }
-    .check span {
-      color: var(--muted);
-      font-size: 13px;
-    }
-    .check strong {
-      font-size: 18px;
-      font-variant-numeric: tabular-nums;
-    }
-    .section-head {
-      display: flex;
-      align-items: start;
-      justify-content: space-between;
-      gap: 16px;
-      margin-bottom: 16px;
-    }
-    .section-head h2 {
-      max-width: 680px;
-      margin: 0;
-      font-size: 24px;
-      line-height: 1.2;
-      letter-spacing: 0;
-    }
-    .section-head > span {
-      flex: 0 0 auto;
-      color: var(--muted);
-      font-size: 13px;
-      font-weight: 700;
-      white-space: nowrap;
-    }
-    .findings {
-      display: grid;
-      gap: 12px;
-    }
-    .finding {
-      border: 1px solid var(--line);
-      border-left: 4px solid var(--note);
-      border-radius: var(--radius);
-      padding: 16px;
-      background: #fffdf8;
-    }
-    .finding.danger { border-left-color: var(--danger); }
-    .finding.warn { border-left-color: var(--warn); }
-    .finding.low { border-left-color: var(--low); }
-    .finding-head {
-      display: flex;
-      align-items: start;
-      justify-content: space-between;
-      gap: 16px;
-    }
-    .finding-id {
-      margin: 0 0 4px;
-      color: var(--muted);
-      font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
-      font-size: 12px;
-    }
-    h3 {
-      margin: 0;
-      font-size: 17px;
-      line-height: 1.3;
-      letter-spacing: 0;
-    }
-    .pill {
-      display: inline-flex;
-      align-items: center;
-      min-height: 26px;
-      padding: 4px 9px;
-      border-radius: 999px;
-      font-size: 12px;
-      font-weight: 800;
-      text-transform: uppercase;
-      white-space: nowrap;
-    }
-    .pill.danger { background: var(--danger-bg); color: var(--danger); }
-    .pill.warn { background: var(--warn-bg); color: var(--warn); }
-    .pill.note { background: var(--note-bg); color: var(--note); }
-    .pill.low { background: var(--low-bg); color: var(--low); }
-    .action {
-      margin: 10px 0 0;
-      color: var(--muted);
-    }
-    .sample-table {
-      margin-top: 14px;
-      overflow-x: auto;
-      border: 1px solid var(--line);
-      border-radius: var(--radius);
-      background: var(--panel);
-    }
-    table {
-      width: 100%;
-      min-width: 640px;
-      border-collapse: collapse;
-    }
-    th, td {
-      padding: 10px 12px;
-      border-bottom: 1px solid var(--line);
-      text-align: left;
-      vertical-align: top;
-    }
-    th {
-      color: var(--muted);
-      font-size: 12px;
-      font-weight: 800;
-      letter-spacing: 0.06em;
-      text-transform: uppercase;
-    }
-    td {
-      max-width: 360px;
-      color: #27272a;
-      font-size: 13px;
-      overflow-wrap: anywhere;
-    }
-    tr:last-child td { border-bottom: 0; }
-    .empty {
-      margin: 0;
-      color: var(--muted);
-    }
-    details {
-      margin-top: 24px;
-      padding: 18px;
-    }
-    summary {
-      cursor: pointer;
-      font-weight: 800;
-    }
-    pre {
-      margin: 16px 0 0;
-      max-height: 560px;
-      overflow: auto;
-      padding: 16px;
-      border-radius: var(--radius);
-      background: #111827;
-      color: #f9fafb;
-      font-size: 12px;
-      line-height: 1.45;
-    }
-    @media (max-width: 860px) {
-      main { width: min(100% - 24px, 1120px); padding-top: 32px; }
-      .metrics { grid-template-columns: repeat(2, minmax(0, 1fr)); }
-      .section-grid { grid-template-columns: 1fr; gap: 18px; }
-      .section { padding: 18px; }
-      .section-head { display: block; }
-      .section-head > span { display: block; margin-top: 8px; }
-    }
-    @media (max-width: 520px) {
-      .metrics { grid-template-columns: 1fr; }
-      .lede { font-size: 16px; }
-      .finding-head { display: block; }
-      .pill { margin-top: 10px; }
-    }
-  </style>
-</head>
-<body>
-  <main>
-    <header>
-      <p class="eyebrow">Generated ${htmlEscape(result.generatedAt)}</p>
-      <h1>Ops Catalog Audit</h1>
-      <p class="lede">A re-runnable audit of schedules, workflows, and prompt/template catalogs. It found ${htmlEscape(
-        formatMetric(result.summary.findingsTotal),
-      )} actionable issue cluster(s), with the highest-risk items called out first inside each group.</p>
-    </header>
-    <section class="metrics" aria-label="Audit summary">
-      ${metrics
-        .map(
-          ([label, value]) =>
-            `<div class="metric"><strong>${htmlEscape(formatMetric(value))}</strong><span>${htmlEscape(
-              label,
-            )}</span></div>`,
-        )
-        .join("")}
-    </section>
-    ${sections}
-    <details>
-      <summary>Compressed JSON appendix</summary>
-      <pre>${htmlEscape(JSON.stringify(result, null, 2))}</pre>
-    </details>
-  </main>
-</body>
-</html>`;
+    ],
+    sections: ["schedules", "workflows", "promptsTemplates"].map((key) => ({
+      key,
+      goal: result.goals[key].goal,
+      findingCount: result.goals[key].findingCount,
+      checks: result.goals[key].checks,
+      findings: result.goals[key].findings,
+    })),
+    appendix: result,
+  };
 }
 
-async function publishAuditPage(result: any, ctx: any): Promise<any> {
-  const redacted = ctx.stdlib?.Redacted;
-  const value = (v: any) => (redacted?.value ? redacted.value(v) : String(v));
-  const response = await ctx.stdlib.fetch(`${value(ctx.swarm.config.mcpBaseUrl)}/api/pages`, {
-    method: "POST",
-    headers: {
-      Authorization: `Bearer ${value(ctx.swarm.config.apiKey)}`,
-      "Content-Type": "application/json",
-      "X-Agent-ID": value(ctx.swarm.config.agentId),
-    },
-    body: JSON.stringify({
-      title: "Ops Catalog Audit",
-      slug: "ops-catalog-audit",
-      description: "Clustered audit-as-code report for schedules, workflows, and prompts/templates.",
-      contentType: "text/html",
-      authMode: "authed",
-      body: renderPage(result),
-    }),
-  });
-  const body = await response.json().catch(async () => ({ error: await response.text() }));
-  if (!response.ok) return { error: body?.error || `page create failed: ${response.status}` };
-  return {
-    id: body?.id ?? null,
-    appUrl: body?.app_url ?? null,
-    apiUrl: body?.api_url ?? null,
-    version: body?.version ?? null,
-  };
+export function renderPage(result: any): string {
+  return renderCatalogReportPage(buildReport(result));
 }
 
 /** Audit schedules, workflows, and prompt/template catalogs by goal, with optional authed page output. */
@@ -906,6 +501,6 @@ export default async function opsCatalogAudit(args: any, ctx: any) {
     },
   };
 
-  if (publishPage) result.page = await publishAuditPage(result, ctx);
+  if (publishPage) result.page = await publishCatalogReportPage(buildReport(result), ctx);
   return result;
 }

package/src/be/seed-scripts/catalog/schedule-health.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { publishCatalogReportPage } from "./catalog-report";
 
 export const argsSchema = z.object({
   days: z
@@ -11,6 +12,7 @@ export const argsSchema = z.object({
     .number()
     .optional()
     .describe("Flag schedules with failure rate above this (0-1, default 0.2)"),
+  publishPage: z.boolean().optional().describe("Publish an authed HTML page (default true)"),
 });
 
 /** Per-schedule health check: failure rates and flagging unhealthy schedules. */
@@ -19,6 +21,7 @@ export default async function scheduleHealth(args: any, ctx: any) {
   if (!parsed.success) return { error: "invalid args: " + parsed.error.message };
   const days = parsed.data.days || 7;
   const threshold = parsed.data.failureThreshold ?? 0.2;
+  const publishPage = parsed.data.publishPage !== false;
   const since = new Date(Date.now() - days * 86400000).toISOString();
 
   // Get schedules
@@ -26,7 +29,38 @@ export default async function scheduleHealth(args: any, ctx: any) {
   const schedPayload = schedRes?.data ?? schedRes;
   const schedules: any[] = schedPayload?.schedules ?? [];
 
-  if (!schedules.length) return { days, schedules: [], flagged: [] };
+  if (!schedules.length) {
+    const result: any = { days, threshold, totalSchedules: 0, flaggedCount: 0, schedules: [], flagged: [] };
+    if (publishPage) {
+      result.page = await publishCatalogReportPage(
+        {
+          title: "Schedule Health Audit",
+          slug: "schedule-health",
+          description: "Per-schedule failure rate audit.",
+          generatedAt: new Date().toISOString(),
+          lede: "No schedules were returned for the selected window.",
+          metrics: [
+            ["Schedules", 0],
+            ["Flagged", 0],
+            ["Days", days],
+            ["Threshold", threshold],
+          ],
+          sections: [
+            {
+              key: "schedule-health",
+              goal: "Keep recurring schedules healthy and visible.",
+              findingCount: 0,
+              checks: { schedules: 0, flagged: 0 },
+              findings: [],
+            },
+          ],
+          appendix: result,
+        },
+        ctx,
+      );
+    }
+    return result;
+  }
 
   // Get recent tasks to correlate with schedules
   const taskRes: any = await ctx.swarm.task_list({ createdAfter: since, limit: 2000 });
@@ -62,7 +96,7 @@ export default async function scheduleHealth(args: any, ctx: any) {
 
   const flagged = results.filter((r: any) => r.flagged);
 
-  return {
+  const result: any = {
     days,
     threshold,
     totalSchedules: schedules.length,
@@ -70,4 +104,46 @@ export default async function scheduleHealth(args: any, ctx: any) {
     schedules: results.sort((a: any, b: any) => b.failureRate - a.failureRate),
     flagged,
   };
+
+  if (publishPage) {
+    result.page = await publishCatalogReportPage(
+      {
+        title: "Schedule Health Audit",
+        slug: "schedule-health",
+        description: "Per-schedule failure rate audit.",
+        generatedAt: new Date().toISOString(),
+        lede: `Checked ${schedules.length} schedule(s) over ${days} day(s); ${flagged.length} exceeded the configured failure threshold.`,
+        metrics: [
+          ["Schedules", schedules.length],
+          ["Flagged", flagged.length],
+          ["Days", days],
+          ["Threshold", threshold],
+        ],
+        sections: [
+          {
+            key: "schedule-health",
+            goal: "Keep recurring schedules healthy and visible.",
+            findingCount: flagged.length,
+            checks: {
+              totalSchedules: schedules.length,
+              flaggedSchedules: flagged.length,
+              threshold,
+              scannedTasks: tasks.length,
+            },
+            findings: flagged.map((schedule: any) => ({
+              id: `schedule.${schedule.id}`,
+              severity: schedule.failureRate >= 0.5 ? "high" : "medium",
+              summary: `${schedule.name} failed ${schedule.failed}/${schedule.runs} recent run(s).`,
+              action: "Review the latest failed tasks and disable, repair, or retarget this schedule.",
+              samples: [schedule],
+            })),
+          },
+        ],
+        appendix: result,
+      },
+      ctx,
+    );
+  }
+
+  return result;
 }

package/src/be/seed-scripts/catalog/task-failure-audit.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { publishCatalogReportPage } from "./catalog-report";
 
 export const argsSchema = z.object({
   days: z
@@ -17,6 +18,7 @@ export const argsSchema = z.object({
     .positive()
     .optional()
     .describe("Max failed tasks to scan (default 500)"),
+  publishPage: z.boolean().optional().describe("Publish an authed HTML page (default true)"),
 });
 
 const REASON_PATTERNS: any[] = [
@@ -46,6 +48,7 @@ export default async function taskFailureAudit(args: any, ctx: any) {
   const days = parsed.data.days || 7;
   const groupBy = parsed.data.groupBy || "reason";
   const limit = parsed.data.limit || 500;
+  const publishPage = parsed.data.publishPage !== false;
 
   const since = new Date(Date.now() - days * 86400000).toISOString();
   const res: any = await ctx.swarm.task_list({
@@ -77,11 +80,55 @@ export default async function taskFailureAudit(args: any, ctx: any) {
     .map((k: string) => groups[k])
     .sort((a: any, b: any) => b.count - a.count);
 
-  return {
+  const result: any = {
     days,
     groupBy,
     totalFailed: tasks.length,
     clusterCount: rows.length,
     groups: rows,
   };
+
+  if (publishPage) {
+    result.page = await publishCatalogReportPage(
+      {
+        title: "Task Failure Audit",
+        slug: "task-failure-audit",
+        description: "Clustered audit of recently failed swarm tasks.",
+        generatedAt: new Date().toISOString(),
+        lede: `Clustered ${tasks.length} failed task(s) over ${days} day(s) by ${groupBy}.`,
+        metrics: [
+          ["Failed tasks", tasks.length],
+          ["Clusters", rows.length],
+          ["Days", days],
+          ["Limit", limit],
+        ],
+        sections: [
+          {
+            key: "failure-clusters",
+            goal: "Surface repeated failure modes before they become operational drift.",
+            findingCount: rows.length,
+            checks: { totalFailed: tasks.length, clusterCount: rows.length, groupBy },
+            findings: rows.map((group: any) => ({
+              id: `failure.${group.key}`,
+              severity: group.count >= 5 ? "high" : group.count >= 2 ? "medium" : "low",
+              summary: `${group.count} failed task(s) in ${group.key}.`,
+              action: "Inspect the sample task IDs and decide whether this needs a fix, retry, or HEARTBEAT watch item.",
+              samples: [
+                {
+                  key: group.key,
+                  count: group.count,
+                  taskIds: group.taskIds,
+                  sampleReason: group.sampleReason,
+                },
+              ],
+            })),
+          },
+        ],
+        appendix: result,
+      },
+      ctx,
+    );
+  }
+
+  return result;
 }