gator-command 1.1.9__tar.gz → 1.2.0__tar.gz

{gator_command-1.1.9/src/gator_command.egg-info → gator_command-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gator-command
-Version: 1.1.9
+Version: 1.2.0
 Summary: Git-native governance for AI-assisted engineering
 Author-email: Cumberland Laboratories <support@cumberlandlaboratories.com>
 License: MIT

{gator_command-1.1.9 → gator_command-1.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gator-command"
-version = "1.1.9"
+version = "1.2.0"
 description = "Git-native governance for AI-assisted engineering"
 readme = "PYPI_README.md"
 license = {text = "MIT"}

{gator_command-1.1.9 → gator_command-1.2.0}/src/gator_command/scripts/dashboard/dashboard.css

@@ -360,6 +360,91 @@ html, body {
   background: #f8f9fb;
 }
 
+/* ── session table ─────────────────────────────────────────────────────── */
+
+.session-row:hover td {
+  background: #eef3fa;
+}
+
+.session-row-expanded td {
+  background: #f0f4fa;
+  border-bottom-color: transparent;
+}
+
+.session-detail td {
+  padding: 0;
+  background: #fafbfd;
+}
+
+.session-detail-content {
+  padding: 10px 16px 14px;
+  border-left: 3px solid #d0d8e4;
+  margin: 0 8px 8px;
+}
+
+.detail-section {
+  margin-bottom: 8px;
+}
+
+.commit-entry {
+  font-size: 12px;
+  margin: 2px 0;
+  color: #333;
+}
+
+.commit-type {
+  display: inline-block;
+  font-size: 10px;
+  padding: 1px 5px;
+  border-radius: 3px;
+  background: #eee;
+  color: #555;
+  margin: 0 4px;
+}
+
+.tag-badge {
+  display: inline-block;
+  font-size: 10px;
+  padding: 1px 6px;
+  border-radius: 8px;
+  background: #e8eef5;
+  color: #3a5a8a;
+  margin: 1px 2px;
+}
+
+.status-complete {
+  color: #4a7a4a;
+  font-size: 11px;
+}
+
+.status-inflight {
+  color: #b8860b;
+  font-size: 11px;
+  font-weight: 600;
+}
+
+.fleet-toggle-btn {
+  border: 1px solid #ccc;
+  background: #f5f5f5;
+  color: #555;
+  padding: 2px 10px;
+  border-radius: 4px;
+  font-size: 11px;
+  cursor: pointer;
+  margin-left: 10px;
+  vertical-align: middle;
+}
+
+.fleet-toggle-btn:hover {
+  background: #e8e8e8;
+}
+
+.fleet-toggle-btn.active {
+  background: #3a5a8a;
+  color: #fff;
+  border-color: #3a5a8a;
+}
+
 /* ── health badges ─────────────────────────────────────────────────────── */
 
 .badge {
@@ -930,6 +1015,89 @@ a:hover, .link-btn:hover {
   color: #0366d6;
 }
 
+/* ── search ────────────────────────────────────────────────────────────── */
+
+.topbar-search {
+  border: 1px solid #ccc;
+  border-radius: 4px;
+  padding: 3px 8px;
+  font-size: 12px;
+  width: 180px;
+  margin-right: 10px;
+  outline: none;
+}
+
+.topbar-search:focus {
+  border-color: #0366d6;
+  box-shadow: 0 0 0 2px rgba(3,102,214,0.15);
+}
+
+.in-doc-search {
+  border: 1px solid #ccc;
+  border-radius: 4px;
+  padding: 2px 6px;
+  font-size: 11px;
+  width: 130px;
+  margin-right: 6px;
+  outline: none;
+}
+
+.in-doc-search:focus {
+  border-color: #0366d6;
+}
+
+.file-header-right {
+  display: flex;
+  align-items: center;
+  gap: 4px;
+}
+
+.copy-content-btn {
+  border: none;
+  background: none;
+  cursor: pointer;
+  font-size: 13px;
+  color: #aaa;
+  padding: 0 4px;
+  vertical-align: middle;
+}
+
+.copy-content-btn:hover {
+  color: #0366d6;
+}
+
+mark.search-hit {
+  background: #fff3b0;
+  padding: 0 1px;
+  border-radius: 2px;
+}
+
+.search-result {
+  padding: 8px 12px;
+  margin-bottom: 6px;
+  border: 1px solid #e8e8e8;
+  border-radius: 4px;
+  background: #fafbfd;
+}
+
+.search-result:hover {
+  background: #f0f4fa;
+  border-color: #d0d8e4;
+}
+
+.search-result-title {
+  font-size: 13px;
+  font-weight: 600;
+  color: #0366d6;
+  margin-bottom: 3px;
+}
+
+.search-result-snippet {
+  font-size: 12px;
+  color: #555;
+  line-height: 1.4;
+}
+
 /* ── Markdown rendering ────────────────────────────────────────────────── */
 
 .repo-markdown h1 { font-size: 22px; font-weight: 600; margin: 20px 0 12px; color: #111; }

{gator_command-1.1.9 → gator_command-1.2.0}/src/gator_command/scripts/dashboard/dashboard.html

@@ -55,6 +55,7 @@
           <span id="topbar-subtitle"></span>
         </div>
         <div id="topbar-right">
+          <input type="text" id="repo-search-input" class="topbar-search" placeholder="Search... (AND / OR)" style="display:none" />
           <span id="generated-at"></span>
           <button id="refresh-btn" title="Re-run fleet scan">↺ Refresh</button>
         </div>

{gator_command-1.1.9 → gator_command-1.2.0}/src/gator_command/scripts/dashboard/dashboard.js

@@ -20,6 +20,7 @@
     data: null,          // fast_data from server
     activeView: "fleet",
     activeRepo: null,    // name of currently loaded repo (Repo view)
+    activeRepoKey: null, // path-hash key for session audit identity
     settings: null,      // dashboard settings (mode, etc.)
     standalone: false,   // true when no command post detected
   };
@@ -93,6 +94,13 @@
       btn.classList.toggle("active", btn.dataset.view === name);
     });
 
+    // Show/hide repo search input
+    const repoSearchInput = document.getElementById("repo-search-input");
+    if (repoSearchInput) {
+      repoSearchInput.style.display = (name === "repo") ? "" : "none";
+      if (name !== "repo") repoSearchInput.value = "";
+    }
+
     // Clear slot
     viewSlot.innerHTML = "";
 
@@ -115,7 +123,7 @@
     if (name === "audit") {
       updateTopbar("audit", "Governance posture");
       if (views.audit) {
-        views.audit(state.data, viewSlot);
+        views.audit(state.data, viewSlot, state.activeRepoKey);
       } else {
         viewSlot.innerHTML = "<p class='muted'>Audit view not available.</p>";
       }
@@ -130,6 +138,10 @@
         return;
       }
       state.activeRepo = repoName;
+      // Resolve repo_key from fleet data
+      const allRepos = (state.data && state.data.fleet && state.data.fleet.repos) || (state.data && state.data.repos) || [];
+      const matchedRepo = allRepos.find(r => r.name === repoName);
+      state.activeRepoKey = (matchedRepo && matchedRepo.repo_key) || null;
       // Update repo sidebar label
       repoTab.textContent = "";
       const icon = document.createElement("span");
@@ -405,13 +417,6 @@
 
     state.standalone = !!(state.data && state.data.standalone);
 
-    // Hide Audit tab in standalone mode (no data model without command post)
-    if (state.standalone) {
-      document.querySelectorAll('.sidebar-item[data-view="audit"]').forEach(el => {
-        el.style.display = "none";
-      });
-    }
-
     // Check for ?repo= query param
     const params = new URLSearchParams(window.location.search);
     const preloadRepo = params.get("repo");

gator_command-1.2.0/src/gator_command/scripts/dashboard/views/audit.js

@@ -0,0 +1,414 @@
+/**
+ * audit.js — Audit view for Gator Dashboard.
+ *
+ * Data source: data.audit (gator-audit --json) for governance metrics,
+ *              GET /api/audit/sessions for session summaries (lazy).
+ *
+ * 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; }
+  }
+
+  function fmtDateRange(startedAt, endedAt) {
+    if (!startedAt) return "—";
+    try {
+      const s = new Date(startedAt);
+      const e = endedAt ? new Date(endedAt) : null;
+      const datePart = s.toLocaleDateString(undefined, { month: "short", day: "numeric" });
+      const startTime = s.toLocaleTimeString(undefined, { hour: "2-digit", minute: "2-digit", hour12: false });
+      const endTime = e ? e.toLocaleTimeString(undefined, { hour: "2-digit", minute: "2-digit", hour12: false }) : "";
+      return endTime ? `${datePart} ${startTime}\u2013${endTime}` : `${datePart} ${startTime}`;
+    } catch (_) { return startedAt.slice(0, 16); }
+  }
+
+  function sessionStatus(endedAt) {
+    if (!endedAt) return "in-flight";
+    try {
+      const ago = Date.now() - new Date(endedAt).getTime();
+      return ago > 2 * 60 * 60 * 1000 ? "complete" : "in-flight";
+    } catch (_) { return "?"; }
+  }
+
+  // ── 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;
+  }
+
+  // ── session summary table (from /api/audit/sessions) ───────────────────────
+
+  function renderSessionTable(summaries, fleet) {
+    if (!summaries || summaries.length === 0) {
+      return "<p class='muted'>No session summaries available. Sessions are generated from committed snippets.</p>";
+    }
+
+    let html = `
+      <table class="data-table session-table">
+        <thead>
+          <tr>
+            <th>Session</th>
+            ${fleet ? '<th>Repo</th>' : ''}
+            <th>Model</th>
+            <th>Commits</th>
+            <th>Goal</th>
+            <th>Tags</th>
+            <th>Status</th>
+          </tr>
+        </thead>
+        <tbody>
+    `;
+
+    for (const s of summaries) {
+      const dateRange = fmtDateRange(s.started_at, s.ended_at);
+      const goal = s.goal || "";
+      const goalDisplay = goal.length > 50 ? goal.slice(0, 50) + "…" : goal;
+      const tags = (s.decision_tags || []).slice(0, 4);
+      const tagBadges = tags.map(t => `<span class="tag-badge">${escHtml(t)}</span>`).join(" ");
+      const extraTags = (s.decision_tags || []).length > 4 ? ` <span class="muted">+${s.decision_tags.length - 4}</span>` : "";
+      const status = sessionStatus(s.ended_at);
+      const statusClass = status === "complete" ? "status-complete" : "status-inflight";
+      const rowKey = escHtml((s.repo_key || "") + "-" + (s.session_id || ""));
+
+      html += `
+        <tr class="session-row" data-row-key="${rowKey}">
+          <td class="nowrap">${escHtml(dateRange)}</td>
+          ${fleet ? `<td>${escHtml(s.repo || "—")}</td>` : ''}
+          <td>${escHtml(s.model || "—")}</td>
+          <td class="mono">${s.commit_count || 0}</td>
+          <td title="${escHtml(goal)}">${escHtml(goalDisplay || "—")}</td>
+          <td>${tagBadges}${extraTags}</td>
+          <td><span class="${statusClass}">${status}</span></td>
+        </tr>
+        <tr class="session-detail" id="detail-${rowKey}" style="display:none">
+          <td colspan="${fleet ? 7 : 6}">
+            <div class="session-detail-content">
+              ${renderSessionDetail(s)}
+            </div>
+          </td>
+        </tr>
+      `;
+    }
+
+    html += "</tbody></table>";
+    return html;
+  }
+
+  function renderSessionDetail(s) {
+    let html = "";
+
+    // Commits
+    const commits = s.commits || [];
+    if (commits.length > 0) {
+      html += '<div class="detail-section"><strong>Commits</strong><div class="commit-list">';
+      for (const c of commits) {
+        html += `<div class="commit-entry"><span class="mono">${escHtml(c.short_commit || "?")}</span> <span class="commit-type">${escHtml(c.change_type || "")}</span> ${escHtml(c.intent || "")}</div>`;
+      }
+      html += "</div></div>";
+    }
+
+    // Files touched
+    const files = s.files_touched || [];
+    if (files.length > 0) {
+      html += '<div class="detail-section"><strong>Files touched</strong> <span class="muted">(' + files.length + ')</span><div class="file-list">';
+      const displayFiles = files.slice(0, 20);
+      for (const f of displayFiles) {
+        html += `<div class="mono" style="font-size:11px;color:#555">${escHtml(f)}</div>`;
+      }
+      if (files.length > 20) {
+        html += `<div class="muted">… and ${files.length - 20} more</div>`;
+      }
+      html += "</div></div>";
+    }
+
+    // Notes
+    const notes = s.notes || [];
+    if (notes.length > 0) {
+      html += '<div class="detail-section"><strong>Notes</strong><div class="notes-list">';
+      for (const n of notes) {
+        html += `<div style="font-size:12px;color:#444;margin:2px 0">• ${escHtml(n)}</div>`;
+      }
+      html += "</div></div>";
+    }
+
+    // Transcript link
+    if (s.transcript_ref) {
+      html += `<div class="detail-section"><strong>Transcript</strong> <span class="mono muted">${escHtml(s.transcript_ref)}</span></div>`;
+    }
+
+    if (!html) {
+      html = '<span class="muted">No additional details.</span>';
+    }
+
+    return html;
+  }
+
+  // ── main render ─────────────────────────────────────────────────────────────
+
+  window.GatorViews.audit = function (data, container, activeRepoKey) {
+    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>
+
+      <div class="section">
+        <div class="section-title">
+          Session summaries
+          <button class="fleet-toggle-btn" id="session-fleet-toggle" title="Toggle fleet view">Fleet</button>
+        </div>
+        <div id="session-table-container">
+          <p class="muted" style="padding:12px">Loading sessions...</p>
+        </div>
+      </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;
+
+    // Load session summaries lazily from /api/audit/sessions
+    // If no repo selected, start in fleet mode and hide the toggle
+    let fleetMode = !activeRepoKey;
+    const tableContainer = container.querySelector("#session-table-container");
+    const fleetBtn = container.querySelector("#session-fleet-toggle");
+
+    if (!activeRepoKey && fleetBtn) {
+      fleetBtn.style.display = "none";  // no repo context — fleet-only, hide toggle
+    } else if (fleetBtn) {
+      fleetBtn.classList.toggle("active", fleetMode);
+      fleetBtn.textContent = fleetMode ? "Single repo" : "Fleet";
+    }
+
+    function loadSessions() {
+      let url;
+      if (fleetMode) {
+        url = "/api/audit/sessions?fleet=true";
+      } else {
+        url = "/api/audit/sessions?repo=" + encodeURIComponent(activeRepoKey);
+      }
+      tableContainer.innerHTML = '<p class="muted" style="padding:12px">Loading sessions...</p>';
+      fetch(url)
+        .then(r => r.json())
+        .then(summaries => {
+          if (summaries.error) {
+            tableContainer.innerHTML = `<p class="muted" style="padding:12px">${escHtml(summaries.error)}</p>`;
+            return;
+          }
+          tableContainer.innerHTML = renderSessionTable(summaries, fleetMode);
+
+          // Expandable row click handlers
+          tableContainer.querySelectorAll(".session-row").forEach(row => {
+            row.style.cursor = "pointer";
+            row.addEventListener("click", function () {
+              const key = this.dataset.rowKey;
+              const detail = document.getElementById("detail-" + key);
+              if (detail) {
+                const visible = detail.style.display !== "none";
+                detail.style.display = visible ? "none" : "";
+                this.classList.toggle("session-row-expanded", !visible);
+              }
+            });
+          });
+        })
+        .catch(err => {
+          tableContainer.innerHTML = `<p class="muted" style="padding:12px">Failed to load sessions: ${escHtml(err.message)}</p>`;
+        });
+    }
+
+    if (fleetBtn) {
+      fleetBtn.addEventListener("click", function () {
+        fleetMode = !fleetMode;
+        this.classList.toggle("active", fleetMode);
+        this.textContent = fleetMode ? "Single repo" : "Fleet";
+        loadSessions();
+      });
+    }
+
+    // Initial load
+    if (!window.GATOR_SNAPSHOT) {
+      loadSessions();
+    }
+  };
+})();