plugin-scanner 2.0.137__tar.gz → 2.0.139__tar.gz

{plugin_scanner-2.0.137 → plugin_scanner-2.0.139}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plugin-scanner
-Version: 2.0.137
+Version: 2.0.139
 Summary: Lint, verify, and gate plugin ecosystems for maintainers, CI, and publish workflows.
 Project-URL: Homepage, https://github.com/hashgraph-online/ai-plugin-scanner
 Project-URL: Repository, https://github.com/hashgraph-online/ai-plugin-scanner

{plugin_scanner-2.0.137 → plugin_scanner-2.0.139}/dashboard/src/guard-api.ts

@@ -631,3 +631,15 @@ export async function exportDiagnostics(): Promise<Blob> {
   }
   return response.blob();
 }
+
+export async function repairApprovalCenter(): Promise<{ repaired: boolean; cleared: string[] }> {
+  if (isGuardDemoMode()) {
+    return { repaired: true, cleared: ["locator", "daemon_state"] };
+  }
+  const response = await fetch(guardApiInput("/v1/daemon/repair"), withGuardAuth({ method: "POST" }));
+  if (!response.ok) {
+    throw new Error(`Repair failed with ${response.status}`);
+  }
+  return response.json() as Promise<{ repaired: boolean; cleared: string[] }>;
+}
+

plugin_scanner-2.0.139/dashboard/src/runtime-overview.test.ts

@@ -0,0 +1,107 @@
+import { resolveCloudIntelCopy, resolveCloudSyncHealthCopy, resolveProtectionLevelCopy, resolveApprovalCenterHealth } from "./runtime-overview";
+import type { GuardCloudSyncHealth, GuardRuntimeSnapshot } from "./guard-types";
+
+function assert(condition: boolean, message: string): void {
+  if (!condition) {
+    throw new Error(message);
+  }
+}
+
+const healthDisabled: GuardCloudSyncHealth = {
+  state: "disabled",
+  label: "Sync disabled",
+  detail: "Cloud sync is turned off on this machine.",
+  pending_events: 0,
+  last_synced_at: null,
+  next_retry_after: null
+};
+
+const healthHealthy: GuardCloudSyncHealth = {
+  state: "healthy",
+  label: "Sync healthy",
+  detail: "Cloud sync is running normally.",
+  pending_events: 0,
+  last_synced_at: new Date().toISOString(),
+  next_retry_after: null
+};
+
+const localOnlyCopy = resolveCloudIntelCopy("local_only");
+assert(localOnlyCopy.label === "Offline, free", "T507: local_only label should be 'Offline, free'");
+assert(localOnlyCopy.detail.length > 0, "T507: local_only detail should not be empty");
+assert(localOnlyCopy.detail.includes("locally"), "T507: local_only detail should mention 'locally'");
+
+const localOnlySyncCopy = resolveCloudSyncHealthCopy(healthDisabled);
+assert(localOnlySyncCopy.label === healthDisabled.label, "T507: cloud sync health label should match");
+assert(localOnlySyncCopy.detail === healthDisabled.detail, "T507: cloud sync health detail should match");
+
+const protectionBalanced = resolveProtectionLevelCopy("balanced");
+assert(protectionBalanced.includes("secrets"), "T507: balanced description should mention secrets");
+
+const pairedActiveCopy = resolveCloudIntelCopy("paired_active");
+assert(pairedActiveCopy.label === "Synced, pro", "T508: paired_active label should be 'Synced, pro'");
+assert(pairedActiveCopy.detail.length > 0, "T508: paired_active detail should not be empty");
+assert(pairedActiveCopy.detail.includes("Guard Cloud"), "T508: paired_active detail should mention Guard Cloud");
+
+const pairedWaitingCopy = resolveCloudIntelCopy("paired_waiting");
+assert(pairedWaitingCopy.label === "Pairing…", "T508: paired_waiting label should be 'Pairing…'");
+
+const pairedActiveSyncCopy = resolveCloudSyncHealthCopy(healthHealthy);
+assert(pairedActiveSyncCopy.label === healthHealthy.label, "T508: healthy sync label should match");
+
+const protectionStrict = resolveProtectionLevelCopy("strict");
+assert(protectionStrict.includes("network"), "T508: strict description should mention network");
+
+const protectionCustom = resolveProtectionLevelCopy("custom");
+assert(protectionCustom.includes("Custom"), "T508: custom description should mention Custom");
+
+const baseSnapshot: GuardRuntimeSnapshot = {
+  generated_at: new Date().toISOString(),
+  approval_center_url: "http://localhost:7392/approval",
+  runtime_state: {
+    session_id: "sess-1",
+    daemon_host: "localhost",
+    daemon_port: 7391,
+    started_at: new Date().toISOString(),
+    last_heartbeat_at: new Date().toISOString(),
+    approval_center_url: "http://localhost:7392/approval",
+  },
+  pending_count: 0,
+  receipt_count: 0,
+  headline_state: "protected",
+  headline_label: "Protected",
+  headline_detail: "Guard is active.",
+  sync_configured: false,
+  cloud_state: "local_only",
+  cloud_state_label: "Offline",
+  cloud_state_detail: "Running locally.",
+  cloud_pairing_state: { state: "local_only", label: "Offline", detail: "No cloud." },
+  cloud_sync_health: healthDisabled,
+  dashboard_url: "http://localhost:7392",
+  inbox_url: "http://localhost:7392/inbox",
+  fleet_url: "http://localhost:7392/fleet",
+  connect_url: "http://localhost:7392/connect",
+  items: [],
+  latest_receipts: [],
+};
+
+const healthyApproval = resolveApprovalCenterHealth(baseSnapshot);
+assert(healthyApproval.state === "ready", "T738: protected snapshot with URL should be ready");
+assert(healthyApproval.label.toLowerCase().includes("ready"), "T738: ready label should say ready");
+assert(healthyApproval.detail.includes("http://localhost:7392/approval"), "T738: ready detail should include the URL");
+
+const nullRuntimeSnapshot: GuardRuntimeSnapshot = { ...baseSnapshot, runtime_state: null };
+const offlineApproval = resolveApprovalCenterHealth(nullRuntimeSnapshot);
+assert(offlineApproval.state === "stale", "T738: null runtime_state (non-setup) should be stale");
+assert(offlineApproval.label.toLowerCase().includes("offline"), "T738: stale label should mention offline");
+
+const setupSnapshot: GuardRuntimeSnapshot = { ...baseSnapshot, runtime_state: null, headline_state: "setup" };
+const startingApproval = resolveApprovalCenterHealth(setupSnapshot);
+assert(startingApproval.state === "starting", "T738: null runtime_state + setup headline should be starting");
+assert(startingApproval.label.toLowerCase().includes("starting"), "T738: starting label should say starting");
+
+const noUrlSnapshot: GuardRuntimeSnapshot = { ...baseSnapshot, approval_center_url: null };
+const repairApproval = resolveApprovalCenterHealth(noUrlSnapshot);
+assert(repairApproval.state === "repair_needed", "T738: null approval_center_url should need repair");
+assert(repairApproval.label.toLowerCase().includes("unreachable"), "T738: repair label should mention unreachable");
+assert(repairApproval.detail.toLowerCase().includes("repair"), "T738: repair detail should suggest repair action");
+

{plugin_scanner-2.0.137 → plugin_scanner-2.0.139}/dashboard/src/runtime-overview.tsx

@@ -40,6 +40,44 @@ function remediationLine(snapshot: GuardRuntimeSnapshot): string {
   return "Open Guard Cloud for shared proof, Watched Apps for local coverage, or the review queue when something needs your choice.";
 }
 
+export type ApprovalCenterHealthState = "ready" | "starting" | "stale" | "repair_needed";
+
+export type ApprovalCenterHealthCopy = {
+  state: ApprovalCenterHealthState;
+  label: string;
+  detail: string;
+};
+
+export function resolveApprovalCenterHealth(snapshot: GuardRuntimeSnapshot): ApprovalCenterHealthCopy {
+  if (snapshot.runtime_state === null) {
+    if (snapshot.headline_state === "setup") {
+      return {
+        state: "starting",
+        label: "Approval center starting",
+        detail: "Guard is setting up the local approval center. This takes a few seconds.",
+      };
+    }
+    return {
+      state: "stale",
+      label: "Approval center offline",
+      detail: "The local approval center is not running. Start Guard to restore the approval link.",
+    };
+  }
+  if (snapshot.approval_center_url === null) {
+    return {
+      state: "repair_needed",
+      label: "Approval center unreachable",
+      detail: "The approval center URL is missing. Use the repair action in Settings to restore it.",
+    };
+  }
+  return {
+    state: "ready",
+    label: "Approval center ready",
+    detail: `The approval center is running and accepting requests at ${snapshot.approval_center_url}.`,
+  };
+}
+
+
 export function resolveCloudSyncHealthCopy(health: GuardCloudSyncHealth): { label: string; detail: string } {
   return {
     label: health.label,
@@ -95,6 +133,28 @@ function CloudSyncHealthCard(props: { health: GuardCloudSyncHealth }) {
   );
 }
 
+function approvalHealthTone(state: ApprovalCenterHealthState): "green" | "blue" | "slate" | "red" {
+  if (state === "ready") return "green";
+  if (state === "starting") return "blue";
+  if (state === "repair_needed") return "red";
+  return "slate";
+}
+
+function ApprovalCenterHealthCard(props: { snapshot: GuardRuntimeSnapshot }) {
+  const copy = resolveApprovalCenterHealth(props.snapshot);
+  return (
+    <div className="rounded-xl border border-border bg-white px-5 py-4">
+      <div className="flex flex-wrap items-center justify-between gap-2">
+        <p className="text-xs font-semibold uppercase tracking-[0.18em] text-brand-blue">
+          Approval center health
+        </p>
+        <Tag tone={approvalHealthTone(copy.state)}>{copy.label}</Tag>
+      </div>
+      <p className="mt-2 text-sm leading-relaxed text-brand-dark/80">{copy.detail}</p>
+    </div>
+  );
+}
+
 function WatchedAppsCard(props: { inventory: GuardInventoryItem[] | undefined }) {
   const inventory = props.inventory ?? [];
   return (
@@ -247,6 +307,7 @@ export function RuntimeOverview(props: RuntimeOverviewProps) {
         </div>
 
         <CloudSyncHealthCard health={snapshot.cloud_sync_health} />
+        <ApprovalCenterHealthCard snapshot={snapshot} />
 
         <div className="rounded-xl border border-border bg-white px-5 py-4">
           <p className="text-xs font-semibold uppercase tracking-[0.18em] text-brand-blue">

{plugin_scanner-2.0.137 → plugin_scanner-2.0.139}/dashboard/src/settings-workspace.test.ts

@@ -1,4 +1,5 @@
 import { resolveSecurityLevelDescription, buildClearPolicyPayload } from "./settings-workspace";
+import { repairApprovalCenter } from "./guard-api";
 
 function assert(condition: boolean, message: string): void {
   if (!condition) {
@@ -25,3 +26,6 @@ assert(!("harness" in clearAllPayload) || clearAllPayload.harness === undefined,
 
 const clearNonePayload = buildClearPolicyPayload(false);
 assert(clearNonePayload.all === false, "T530: clearPolicy payload with all=false should have all=false");
+
+assert(typeof repairApprovalCenter === "function", "T739: repairApprovalCenter should be exported as a function");
+

{plugin_scanner-2.0.137 → plugin_scanner-2.0.139}/dashboard/src/settings-workspace.tsx

@@ -13,7 +13,7 @@ import {
   SectionLabel,
   Tag
 } from "./approval-center-primitives";
-import { clearEvidence, exportDiagnostics, fetchSettings, updateSettings, clearPolicy } from "./guard-api";
+import { clearEvidence, exportDiagnostics, fetchSettings, updateSettings, clearPolicy, repairApprovalCenter } from "./guard-api";
 import { resolveProtectionLevelCopy } from "./runtime-overview";
 import type { GuardSettings, GuardSettingsPayload } from "./guard-types";
 
@@ -163,6 +163,7 @@ export function SettingsWorkspace() {
   const [clearingApprovals, setClearingApprovals] = useState(false);
   const [clearingEvidence, setClearingEvidence] = useState(false);
   const [exporting, setExporting] = useState(false);
+  const [repairing, setRepairing] = useState(false);
   const [actionMessage, setActionMessage] = useState<string | null>(null);
   const saveSuccessTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
 
@@ -359,6 +360,22 @@ export function SettingsWorkspace() {
     }
   }, []);
 
+  const handleRepairApprovalCenter = useCallback(async () => {
+    if (!window.confirm("Reset the approval center locator? The daemon will be reachable again after Guard restarts. Pending approvals are preserved.")) {
+      return;
+    }
+    setRepairing(true);
+    setActionMessage(null);
+    try {
+      await repairApprovalCenter();
+      setActionMessage("Approval center repaired. Restart Guard to reconnect.");
+    } catch (error) {
+      setActionMessage(error instanceof Error ? error.message : "Unable to repair approval center.");
+    } finally {
+      setRepairing(false);
+    }
+  }, []);
+
   if (state.kind === "loading") {
     return (
       <div className="space-y-4">
@@ -629,6 +646,17 @@ export function SettingsWorkspace() {
                   </ActionButton>
                 </div>
               </div>
+              <div>
+                <p className="text-sm font-semibold text-brand-dark">Repair local approval center</p>
+                <p className="mt-1 text-xs leading-relaxed text-muted-foreground">
+                  Resets the approval center locator when the approval link returns an API error. Pending approvals are preserved.
+                </p>
+                <div className="mt-2">
+                  <ActionButton onClick={handleRepairApprovalCenter} disabled={repairing} variant="secondary">
+                    {repairing ? "Repairing…" : "Repair approval center"}
+                  </ActionButton>
+                </div>
+              </div>
               {actionMessage ? (
                 <p className="guard-fade-in text-sm leading-6 text-brand-dark/70">{actionMessage}</p>
               ) : null}

{plugin_scanner-2.0.137 → plugin_scanner-2.0.139}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "plugin-scanner"
-version = "2.0.137"
+version = "2.0.139"
 description = "Lint, verify, and gate plugin ecosystems for maintainers, CI, and publish workflows."
 readme = "README.md"
 license = "Apache-2.0"

{plugin_scanner-2.0.137 → plugin_scanner-2.0.139}/pyproject.toml.bak

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hol-guard"
-version = "2.0.137"
+version = "2.0.139"
 description = "Protect local AI harnesses with HOL Guard and run scanner checks for Codex, Claude, Cursor, Gemini, and OpenCode."
 readme = "README.md"
 license = "Apache-2.0"