gator-command 1.0.0__py3-none-any.whl

gator_command/scripts/dashboard/views/audit.js

@@ -0,0 +1,270 @@
+/**
+ * audit.js — Audit view for Gator Dashboard.
+ *
+ * Data source: data.audit (gator-audit --json)
+ *
+ * Primary question: can I show human oversight? where are the gaps?
+ */
+
+(function () {
+  "use strict";
+
+  window.GatorViews = window.GatorViews || {};
+
+  function escHtml(str) {
+    return String(str)
+      .replace(/&/g, "&")
+      .replace(/</g, "&lt;")
+      .replace(/>/g, "&gt;")
+      .replace(/"/g, "&quot;");
+  }
+
+  function fmtTs(ts) {
+    if (!ts) return "—";
+    try {
+      return new Date(ts).toLocaleDateString(undefined, {
+        year: "numeric", month: "short", day: "numeric",
+      });
+    } catch (_) { return ts; }
+  }
+
+  // ── significance bar chart ─────────────────────────────────────────────────
+
+  function renderSigBars(dist) {
+    const order  = ["critical", "high", "medium", "low", "routine"];
+    const colors = {
+      critical: "#a02020",
+      high:     "#c44020",
+      medium:   "#b8860b",
+      low:      "#4a7a4a",
+      routine:  "#888",
+    };
+
+    const total = Object.values(dist).reduce((s, v) => s + v, 0);
+    if (total === 0) return "<p class='muted'>No governed commits found in this period.</p>";
+
+    let html = "";
+    for (const level of order) {
+      const count = dist[level] || 0;
+      if (count === 0) continue;
+      const pct = Math.round((count / total) * 100);
+      html += `
+        <div class="sig-bar">
+          <span class="sig-bar-label">${escHtml(level)}</span>
+          <div class="sig-bar-track">
+            <div class="sig-bar-fill" style="width:${pct}%;background:${colors[level] || '#888'}"></div>
+          </div>
+          <span class="sig-bar-count">${count}</span>
+        </div>
+      `;
+    }
+    return html;
+  }
+
+  // ── governed commits table ─────────────────────────────────────────────────
+
+  function renderGoverned(govCommits) {
+    const entries = Object.entries(govCommits).filter(([k]) => k !== "total");
+    if (entries.length === 0) return "<p class='muted'>No data.</p>";
+
+    entries.sort((a, b) => b[1] - a[1]);
+
+    let html = `
+      <table class="data-table">
+        <thead><tr><th>Repo</th><th>Governed commits (7d)</th></tr></thead>
+        <tbody>
+    `;
+    for (const [repo, count] of entries) {
+      html += `<tr><td>${escHtml(repo)}</td><td class="mono">${count}</td></tr>`;
+    }
+    html += "</tbody></table>";
+    return html;
+  }
+
+  // ── override events table ──────────────────────────────────────────────────
+
+  function renderOverrides(events) {
+    if (!events || events.length === 0) {
+      return "<p class='muted'>No override events found.</p>";
+    }
+
+    let html = `
+      <table class="data-table">
+        <thead>
+          <tr>
+            <th>Repo</th>
+            <th>Commit</th>
+            <th>Date</th>
+            <th>Type</th>
+            <th>Approver</th>
+          </tr>
+        </thead>
+        <tbody>
+    `;
+    for (const ev of events) {
+      html += `
+        <tr>
+          <td>${escHtml(ev.repo || "—")}</td>
+          <td class="mono">${escHtml((ev.hash || "").slice(0, 7))}</td>
+          <td class="nowrap">${fmtTs(ev.timestamp)}</td>
+          <td>${escHtml(ev.override_type || "—")}</td>
+          <td>${escHtml(ev.approver || "—")}</td>
+        </tr>
+      `;
+    }
+    html += "</tbody></table>";
+    return html;
+  }
+
+  // ── render ─────────────────────────────────────────────────────────────────
+
+  window.GatorViews.audit = function (data, container) {
+    const audit = data.audit || {};
+
+    if (audit.error) {
+      container.innerHTML = `<div class="error-block">Audit data unavailable: ${escHtml(audit.error)}</div>`;
+      return;
+    }
+
+    const governance  = audit.governance  || {};
+    const sessions    = audit.sessions    || {};
+    const overrides   = audit.override_events || [];
+    const sigDist     = audit.significance_distribution || {};
+    const govCommits  = audit.governed_commits || {};
+    const sinceDays   = audit.since_days  || 7;
+
+    // Compute summary metrics
+    const totalRepos   = governance.repos || 0;
+    const hookCoverage = totalRepos > 0
+      ? Math.round((governance.hooks_installed / totalRepos) * 100)
+      : 0;
+    const overrideRate = (govCommits.total || 0) > 0
+      ? Math.round((overrides.length / govCommits.total) * 100)
+      : 0;
+
+    // Session summary coverage: repos with recent sessions / total repos
+    const reposWithSessions = Object.keys(sessions.by_repo || {}).length;
+    const sessionCoverage   = totalRepos > 0
+      ? Math.round((reposWithSessions / totalRepos) * 100)
+      : 0;
+
+    let html = `
+      <div class="view-header">
+        <span class="view-title">Audit</span>
+        <span class="view-subtitle">Last ${sinceDays} days &nbsp;·&nbsp; ${totalRepos} repos</span>
+      </div>
+
+      <div class="card-row">
+        <div class="card">
+          <div class="card-label">Hook coverage</div>
+          <div class="card-value">${hookCoverage}%</div>
+          <div class="card-note">${governance.hooks_installed || 0} of ${totalRepos} repos</div>
+        </div>
+        <div class="card">
+          <div class="card-label">Governed commits</div>
+          <div class="card-value">${govCommits.total || 0}</div>
+          <div class="card-note">fleet total, ${sinceDays}d window</div>
+        </div>
+        <div class="card">
+          <div class="card-label">Override events</div>
+          <div class="card-value" style="color:${overrides.length > 0 ? 'var(--color-drifted)' : 'inherit'}">${overrides.length}</div>
+          <div class="card-note">${overrideRate}% of governed commits</div>
+        </div>
+        <div class="card">
+          <div class="card-label">Session coverage</div>
+          <div class="card-value">${sessionCoverage}%</div>
+          <div class="card-note">${reposWithSessions} repos with sessions (${sinceDays}d)</div>
+        </div>
+      </div>
+
+      <div class="section">
+        <div class="section-title">Significance distribution (fleet)</div>
+        ${renderSigBars(sigDist)}
+      </div>
+
+      <div class="section">
+        <div class="section-title">Governed commits by repo (${sinceDays}d)</div>
+        ${renderGoverned(govCommits)}
+      </div>
+
+      <div class="section">
+        <div class="section-title">Override events</div>
+        ${renderOverrides(overrides)}
+      </div>
+    `;
+
+    // Session evidence table
+    const sessionSummaries = audit.session_summaries || [];
+    if (sessionSummaries.length > 0) {
+      html += `
+        <div class="section">
+          <div class="section-title">Recent session evidence</div>
+          <table class="data-table">
+            <thead>
+              <tr>
+                <th>Date</th>
+                <th>Repo</th>
+                <th>Vendor</th>
+                <th>Goal</th>
+                <th>Decisions</th>
+                <th>Evidence</th>
+              </tr>
+            </thead>
+            <tbody>
+      `;
+      const displayItems = sessionSummaries.slice(0, 25);
+      for (const s of displayItems) {
+        const goal = s.goal || "";
+        const goalDisplay = goal.length > 60 ? goal.slice(0, 60) + "…" : goal;
+        const isSnapshot = window.GATOR_SNAPSHOT;
+
+        let evidenceCell;
+        if (isSnapshot) {
+          evidenceCell = `<span class="mono muted" style="font-size:11px">${escHtml(s.source_file || "—")}</span>`;
+        } else {
+          evidenceCell = `<button class="view-btn" data-session-repo="${escHtml(s.repo)}" data-session-kind="${escHtml(s.source_kind)}" data-session-file="${escHtml(s.source_file)}">View</button>`;
+        }
+
+        html += `
+          <tr>
+            <td class="nowrap">${fmtTs(s.start || s.date)}</td>
+            <td>${escHtml(s.repo || "—")}</td>
+            <td>${escHtml(s.vendor || "—")}</td>
+            <td title="${escHtml(goal)}">${escHtml(goalDisplay || "—")}</td>
+            <td class="mono">${s.decisions_count || 0}</td>
+            <td>${evidenceCell}</td>
+          </tr>
+        `;
+      }
+      html += "</tbody></table></div>";
+    }
+
+    // Sessions by vendor
+    if (sessions.by_vendor && Object.keys(sessions.by_vendor).length > 0) {
+      html += `
+        <div class="section">
+          <div class="section-title">Sessions by agent (${sinceDays}d)</div>
+          <table class="data-table">
+            <thead><tr><th>Agent</th><th>Sessions</th></tr></thead>
+            <tbody>
+      `;
+      for (const [vendor, count] of Object.entries(sessions.by_vendor)) {
+        html += `<tr><td>${escHtml(vendor)}</td><td class="mono">${count}</td></tr>`;
+      }
+      html += "</tbody></table></div>";
+    }
+
+    container.innerHTML = html;
+
+    // Delegated click handler for session evidence View buttons
+    container.addEventListener("click", function (e) {
+      const btn = e.target.closest("[data-session-file]");
+      if (!btn) return;
+      window.showSessionModal(
+        btn.dataset.sessionRepo,
+        btn.dataset.sessionKind,
+        btn.dataset.sessionFile,
+      );
+    });
+  };
+})();

gator_command/scripts/dashboard/views/fleet.js

@@ -0,0 +1,307 @@
+/**
+ * fleet.js — Fleet view for Gator Dashboard.
+ *
+ * Repo operations surface: which repos are governed, their charter
+ * state, last activity, and template update status.
+ */
+
+(function () {
+  "use strict";
+
+  window.GatorViews = window.GatorViews || {};
+
+  // ── helpers ────────────────────────────────────────────────────────────────
+
+  function escHtml(str) {
+    return String(str)
+      .replace(/&/g, "&")
+      .replace(/</g, "&lt;")
+      .replace(/>/g, "&gt;")
+      .replace(/"/g, "&quot;");
+  }
+
+  function chartersCell(repo) {
+    const count = repo.charters;
+    if (count == null) return '<span class="muted">-</span>';
+    return `<span title="Click repo name for coverage detail">${count}</span>`;
+  }
+
+  function lastCommitCell(repo) {
+    const lc = repo.last_commit;
+    if (!lc) return '<span class="muted">-</span>';
+    return `<span class="nowrap">${escHtml(lc.age || "unknown")}</span>`;
+  }
+
+  function lastUpdatedCell(repo) {
+    const updated = repo.gator_updated;
+    if (!updated) return '<span class="muted">-</span>';
+    // Format: show date + time if available
+    if (updated.includes("T")) {
+      const [date, time] = updated.split("T");
+      return `<span class="nowrap" style="font-size:12px">${escHtml(date)}<br><span class="muted">${escHtml(time)}</span></span>`;
+    }
+    return `<span class="nowrap" style="font-size:12px">${escHtml(updated)}</span>`;
+  }
+
+  // ── render (command-post mode) ──────────────────────────────────────────
+
+  window.GatorViews.fleet = function (data, container) {
+    if (data.standalone) {
+      renderStandaloneRepos(data, container);
+      return;
+    }
+
+    const fleet = data.fleet || {};
+    if (fleet.error) {
+      container.innerHTML = `<div class="error-block">Fleet data unavailable: ${escHtml(fleet.error)}</div>`;
+      return;
+    }
+
+    const repos = fleet.repos || [];
+    const summary = fleet.summary || {};
+    const totalRepos = summary.total || repos.length;
+    const accessible = summary.accessible || 0;
+    const isSnapshot = !!window.GATOR_SNAPSHOT;
+
+    let html = `
+      <div class="view-header">
+        <span class="view-title">Fleet</span>
+        <span class="view-subtitle">${totalRepos} repos &middot; ${accessible} accessible</span>
+      </div>
+
+      <div class="section">
+        <table class="data-table">
+          <thead>
+            <tr>
+              <th>Repo</th>
+              <th>Gator</th>
+              <th>Branch</th>
+              <th>Charters</th>
+              <th>Last commit</th>
+              <th>Last updated</th>
+              ${isSnapshot ? "" : "<th>Status</th>"}
+            </tr>
+          </thead>
+          <tbody>
+    `;
+
+    for (const repo of repos) {
+      const accIcon = repo.accessible ? "" : ' <span title="Not accessible locally" class="muted">!</span>';
+      const isCommandPost = !!repo.is_command_post;
+      const statusCell = isSnapshot ? "" : (isCommandPost
+        ? `<td class="status-cell"><span class="muted" style="font-size:12px">via Updates</span></td>`
+        : `<td class="status-cell"><button class="update-btn" data-repo="${escHtml(repo.name)}" ${repo.accessible ? "" : "disabled"}>Check Status</button><span class="status-result"></span></td>`);
+
+      html += `
+        <tr id="fleet-row-${escHtml(repo.name)}">
+          <td>
+            <button class="link-btn" onclick="window.gatorNavToRepo('${escHtml(repo.name)}')">${escHtml(repo.name)}</button>
+            ${accIcon}
+          </td>
+          <td class="mono" style="font-size:12px">${repo.generation ? 'gen ' + repo.generation : '-'}</td>
+          <td class="mono">${escHtml(repo.branch || "-")}</td>
+          <td>${chartersCell(repo)}</td>
+          <td>${lastCommitCell(repo)}</td>
+          <td>${lastUpdatedCell(repo)}</td>
+          ${statusCell}
+        </tr>
+      `;
+    }
+
+    if (repos.length === 0) {
+      html += `<tr><td colspan="${isSnapshot ? 6 : 7}" class="muted" style="text-align:center;padding:24px">No repos found in registry.</td></tr>`;
+    }
+
+    html += `</tbody></table></div>`;
+    container.innerHTML = html;
+
+    if (!isSnapshot) bindStatusButtons(container);
+  };
+
+  // ── render (standalone mode) ────────────────────────────────────────────
+
+  function renderStandaloneRepos(data, container) {
+    const repos = data.repos || [];
+
+    let html = `
+      <div class="view-header">
+        <span class="view-title">Fleet</span>
+        <span class="view-subtitle">${repos.length} registered</span>
+      </div>
+
+      <div class="section">
+        <table class="data-table">
+          <thead>
+            <tr>
+              <th>Repo</th>
+              <th>Path</th>
+              <th>Status</th>
+            </tr>
+          </thead>
+          <tbody>
+    `;
+
+    for (const repo of repos) {
+      const accIcon = repo.accessible ? "" : ' <span title="Not accessible" class="muted">!</span>';
+      const statusCell = `<td class="status-cell"><button class="update-btn" data-repo="${escHtml(repo.name)}" ${repo.accessible ? "" : "disabled"}>Check Status</button><span class="status-result"></span></td>`;
+
+      html += `
+        <tr>
+          <td>
+            <button class="link-btn" onclick="window.gatorNavToRepo('${escHtml(repo.name)}')">${escHtml(repo.name)}</button>
+            ${accIcon}
+          </td>
+          <td class="mono" style="font-size:12px;max-width:300px;overflow:hidden;text-overflow:ellipsis">${escHtml(repo.path || "-")}</td>
+          ${statusCell}
+        </tr>
+      `;
+    }
+
+    if (repos.length === 0) {
+      html += `<tr><td colspan="3" class="muted" style="text-align:center;padding:24px">No repos registered. Run gatorize.sh on a repo to get started.</td></tr>`;
+    }
+
+    html += `</tbody></table></div>`;
+    container.innerHTML = html;
+    bindStatusButtons(container);
+  }
+
+  // ── Check Status / Update flow ──────────────────────────────────────────
+
+  function bindStatusButtons(container) {
+    container.querySelectorAll(".update-btn").forEach(btn => {
+      btn.addEventListener("click", async function () {
+        const repoName = this.dataset.repo;
+        const resultSpan = this.nextElementSibling;
+
+        this.disabled = true;
+        this.textContent = "Checking...";
+        resultSpan.textContent = "";
+        resultSpan.style.color = "";
+
+        try {
+          const resp = await fetch(`/api/repo/${encodeURIComponent(repoName)}/check`);
+          const data = await resp.json();
+
+          if (data.error) {
+            resultSpan.textContent = data.error;
+            resultSpan.style.color = "var(--color-critical)";
+            this.textContent = "Check Status";
+            this.disabled = false;
+            return;
+          }
+
+          // Update Charters cell with health indicator
+          updateCharterCell(repoName, data.charter_health);
+
+          // Count actionable updates
+          const plan = data.plan || [];
+          const adds = plan.filter(p => p.action === "add").length;
+          const updates = plan.filter(p => p.action === "update").length;
+          const total = adds + updates;
+
+          if (total === 0) {
+            resultSpan.textContent = "Current";
+            resultSpan.style.color = "var(--color-healthy)";
+            this.textContent = "Check Status";
+            this.disabled = false;
+          } else {
+            // Transform into Update button
+            resultSpan.textContent = `${total} update${total > 1 ? "s" : ""} available`;
+            resultSpan.style.color = "var(--color-drifted, orange)";
+            this.textContent = "Update";
+            this.disabled = false;
+            // Replace click handler for the update action
+            this.replaceWith(createUpdateButton(repoName, resultSpan));
+          }
+        } catch (err) {
+          resultSpan.textContent = "Error";
+          resultSpan.style.color = "var(--color-critical)";
+          this.textContent = "Check Status";
+          this.disabled = false;
+        }
+      });
+    });
+  }
+
+  function updateCharterCell(repoName, charterHealth) {
+    const row = document.getElementById(`fleet-row-${repoName}`);
+    if (!row) return;
+    // Charters is the 4th column (index 3) after Repo, Gator, Branch
+    const cells = row.querySelectorAll("td");
+    if (cells.length < 4) return;
+    const cell = cells[3];
+    const currentText = cell.textContent.trim();
+    const count = parseInt(currentText) || currentText;
+
+    if (!charterHealth || charterHealth.finding_count < 0) {
+      return;
+    }
+    if (charterHealth.finding_count === 0) {
+      cell.innerHTML = `<span style="color:var(--color-healthy);cursor:default" title="All functions and modules covered by charters.">${escHtml(String(count))} &#10003;</span>`;
+    } else {
+      const findings = charterHealth.findings || [];
+      const fc = charterHealth.finding_count;
+      // Build tooltip from findings
+      const tooltip = findings.slice(0, 8).map(f => {
+        const cls = f["class"] || f.type || "";
+        const msg = f.message || f.detail || JSON.stringify(f);
+        return cls ? `${cls}: ${msg}` : msg;
+      }).join("\n");
+      const more = fc > 8 ? `\n... and ${fc - 8} more` : "";
+      cell.innerHTML = `<span style="color:var(--color-drifted, orange);cursor:help" title="${escHtml(tooltip + more)}">${escHtml(String(count))} !</span>`;
+    }
+  }
+
+  function createUpdateButton(repoName, resultSpan) {
+    const btn = document.createElement("button");
+    btn.className = "update-btn";
+    btn.textContent = "Update";
+    btn.dataset.repo = repoName;
+    btn.addEventListener("click", async function () {
+      this.disabled = true;
+      this.textContent = "Updating...";
+      resultSpan.textContent = "";
+
+      try {
+        const resp = await fetch(`/api/repo/${encodeURIComponent(repoName)}/update`, {
+          method: "POST",
+          headers: { "X-Gator-Dashboard": "1" },
+        });
+        const data = await resp.json();
+
+        if (data.status === "ok") {
+          resultSpan.textContent = parseSummaryLine(data.output);
+          resultSpan.style.color = "var(--color-healthy)";
+          if (window.gatorRefreshFleet) window.gatorRefreshFleet();
+        } else {
+          resultSpan.textContent = "Failed";
+          resultSpan.style.color = "var(--color-critical)";
+          resultSpan.title = data.output || data.error || "";
+        }
+      } catch (err) {
+        resultSpan.textContent = "Error";
+        resultSpan.style.color = "var(--color-critical)";
+      }
+
+      // Replace with a fresh Check Status button
+      const freshBtn = document.createElement("button");
+      freshBtn.className = "update-btn";
+      freshBtn.textContent = "Check Status";
+      freshBtn.dataset.repo = repoName;
+      this.replaceWith(freshBtn);
+      bindStatusButtons(freshBtn.parentElement.closest("table") || freshBtn.parentElement);
+    });
+    return btn;
+  }
+
+  function parseSummaryLine(output) {
+    if (!output) return "Done";
+    const lines = output.split("\n").map(l => l.trim()).filter(Boolean);
+    const done = lines.find(l => l.startsWith("Done:"));
+    if (done) return done;
+    const current = lines.find(l => l.includes("Everything is current"));
+    if (current) return "Already current";
+    return "Done";
+  }
+})();