Skip to content

armgit / ARES

Public Imported from GitHub
0

ARES - authorized red-team engagement automation with dashboard, campaign scope, module orchestration, OPSEC controls, encrypted vault, and reporting.

refactor(frontend): modularize DashboardPages, type-safe API payloads, and add test harnesses [AUD-006, AUD-008, AUD-009]

Mafifriziec6c3d84be98
diff --git a/frontend/src/App.test.tsx b/frontend/src/App.test.tsx
index 1855ec7..a252a6c 100644
--- a/frontend/src/App.test.tsx
+++ b/frontend/src/App.test.tsx
@@ -1,3 +1,4 @@
+import "./test/setup";
import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
import "@testing-library/jest-dom/vitest";
import { render, screen } from "@testing-library/react";
diff --git a/frontend/src/api/endpoints.ts b/frontend/src/api/endpoints.ts
index 79b358d..e3683fc 100644
--- a/frontend/src/api/endpoints.ts
+++ b/frontend/src/api/endpoints.ts
@@ -13,8 +13,10 @@ import type {
MonthlyFindingStats,
ReportItem,
TemplateMeta,
+ TemplatePlanResult,
TokenResponse,
UserProfile,
+ VaultRestoreResult,
WebSocketTicketResponse
} from "./types";
import {
@@ -201,15 +203,15 @@ export const api = {
findings: (id: string) => apiRequest<Finding[]>(`/campaigns/${encodeURIComponent(id)}/findings`),
cvss: (id: string) => apiRequest<Record<string, unknown>>(`/campaigns/${encodeURIComponent(id)}/cvss`),
restoreVault: (id: string) =>
- apiRequest<Record<string, unknown>>(`/campaigns/${encodeURIComponent(id)}/restore-vault`, { method: "POST" }),
+ apiRequest<VaultRestoreResult>(`/campaigns/${encodeURIComponent(id)}/restore-vault`, { method: "POST" }),
runCampaign: (
id: string,
body: Record<string, unknown>,
options: LiveSubmissionOptions = {}
- ) => {
+ ): Promise<TemplatePlanResult | LiveExecutionResponse> => {
const path = `/campaigns/${encodeURIComponent(id)}/run`;
return body.dry_run === true
- ? apiRequest<Record<string, unknown>>(path, {
+ ? apiRequest<TemplatePlanResult>(path, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(body)
diff --git a/frontend/src/api/types.ts b/frontend/src/api/types.ts
index a273d41..a1bb512 100644
--- a/frontend/src/api/types.ts
+++ b/frontend/src/api/types.ts
@@ -229,3 +229,41 @@ export interface FeasibilityResponse {
report: FeasibilityReportData;
}
+export interface LiveWebSocketEvent {
+ id?: string;
+ campaign_id?: string;
+ timestamp?: number;
+ event?: string;
+ type?: string;
+ module_id?: string;
+ status?: string;
+ detail?: string;
+ data?: Record<string, unknown>;
+ [key: string]: unknown;
+}
+
+export interface VaultRestoreResult {
+ restored: number;
+ campaign_id?: string;
+ message?: string;
+ status?: string;
+ total_credentials?: number;
+}
+
+export interface TemplatePlanSummary {
+ ready_to_run?: boolean;
+ total_stages?: number;
+ total_modules?: number;
+ estimated_duration_sec?: number;
+}
+
+export interface TemplatePlanResult {
+ plan?: unknown[];
+ summary?: TemplatePlanSummary;
+}
+
+export interface ApiErrorPayload {
+ detail?: string;
+ message?: string;
+}
+
diff --git a/frontend/src/features/auth/LoginPage.test.tsx b/frontend/src/features/auth/LoginPage.test.tsx
new file mode 100644
index 0000000..45784b1
--- /dev/null
+++ b/frontend/src/features/auth/LoginPage.test.tsx
@@ -0,0 +1,155 @@
+import "../../test/setup";
+import { cleanup, fireEvent, render, screen, waitFor } from "@testing-library/react";
+import { MemoryRouter } from "react-router-dom";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { LoginPage } from "./LoginPage";
+
+const mockLogin = vi.fn();
+let mockUser: { username: string; role?: string } | null = null;
+const mockNavigate = vi.fn();
+const mockInitiateSso = vi.fn();
+
+vi.mock("./authContext", () => ({
+ useAuth: () => ({
+ login: mockLogin,
+ user: mockUser,
+ logout: vi.fn(),
+ logoutAll: vi.fn(),
+ token: null,
+ isLoading: false,
+ refreshTokens: vi.fn()
+ })
+}));
+
+vi.mock("react-router-dom", async () => {
+ const actual = await vi.importActual<typeof import("react-router-dom")>("react-router-dom");
+ return {
+ ...actual,
+ useNavigate: () => mockNavigate
+ };
+});
+
+vi.mock("../../api/client", () => ({
+ initiateSso: (provider: string) => mockInitiateSso(provider)
+}));
+
+describe("LoginPage Integration Tests (AUD-009)", () => {
+ beforeEach(() => {
+ vi.clearAllMocks();
+ mockUser = null;
+ mockLogin.mockResolvedValue(undefined);
+ mockInitiateSso.mockResolvedValue({ redirect_url: "https://idp.example.com/login" });
+ });
+
+ afterEach(() => {
+ cleanup();
+ });
+
+ it("renders the sign-in form with header, inputs, and action buttons", () => {
+ render(
+ <MemoryRouter>
+ <LoginPage />
+ </MemoryRouter>
+ );
+
+ expect(screen.getByRole("heading", { name: "ARES Dashboard" })).toBeInTheDocument();
+ expect(screen.getByRole("heading", { name: "Sign In" })).toBeInTheDocument();
+ expect(screen.getByLabelText(/Username \/ Operator ID/i)).toBeInTheDocument();
+ expect(screen.getByLabelText(/^Password$/i)).toBeInTheDocument();
+ expect(screen.getByRole("button", { name: /^Sign in$/i })).toBeInTheDocument();
+ expect(screen.getByRole("button", { name: /continue with SSO/i })).toBeInTheDocument();
+ });
+
+ it("toggles password visibility between masked and plaintext", () => {
+ render(
+ <MemoryRouter>
+ <LoginPage />
+ </MemoryRouter>
+ );
+
+ const passwordInput = screen.getByLabelText(/^Password$/i);
+ expect(passwordInput).toHaveAttribute("type", "password");
+
+ const toggleButton = screen.getByRole("button", { name: /show password/i });
+ fireEvent.click(toggleButton);
+ expect(passwordInput).toHaveAttribute("type", "text");
+
+ const hideButton = screen.getByRole("button", { name: /hide password/i });
+ fireEvent.click(hideButton);
+ expect(passwordInput).toHaveAttribute("type", "password");
+ });
+
+ it("submits operator credentials and navigates on success", async () => {
+ render(
+ <MemoryRouter>
+ <LoginPage />
+ </MemoryRouter>
+ );
+
+ const usernameInput = screen.getByLabelText(/Username \/ Operator ID/i);
+ const passwordInput = screen.getByLabelText(/^Password$/i);
+ const submitBtn = screen.getByRole("button", { name: /^Sign in$/i });
+
+ fireEvent.change(usernameInput, { target: { value: "operator-ares" } });
+ fireEvent.change(passwordInput, { target: { value: "SuperSecretKey123!" } });
+ fireEvent.click(submitBtn);
+
+ await waitFor(() => {
+ expect(mockLogin).toHaveBeenCalledWith("operator-ares", "SuperSecretKey123!");
+ expect(mockNavigate).toHaveBeenCalledWith("/", { replace: true });
+ });
+ });
+
+ it("displays an error alert when authentication fails", async () => {
+ mockLogin.mockRejectedValueOnce(new Error("Invalid operator credentials"));
+
+ render(
+ <MemoryRouter>
+ <LoginPage />
+ </MemoryRouter>
+ );
+
+ const usernameInput = screen.getByLabelText(/Username \/ Operator ID/i);
+ const passwordInput = screen.getByLabelText(/^Password$/i);
+ const submitBtn = screen.getByRole("button", { name: /^Sign in$/i });
+
+ fireEvent.change(usernameInput, { target: { value: "operator-ares" } });
+ fireEvent.change(passwordInput, { target: { value: "wrong-password" } });
+ fireEvent.click(submitBtn);
+
+ await waitFor(() => {
+ expect(screen.getByText("Invalid operator credentials")).toBeInTheDocument();
+ });
+ });
+
+ it("handles SSO initiation and displays error notice if SSO is not configured", async () => {
+ mockInitiateSso.mockRejectedValueOnce(new Error("SSO provider disabled"));
+
+ render(
+ <MemoryRouter>
+ <LoginPage />
+ </MemoryRouter>
+ );
+
+ const ssoButton = screen.getByRole("button", { name: /continue with SSO/i });
+ fireEvent.click(ssoButton);
+
+ await waitFor(() => {
+ expect(mockInitiateSso).toHaveBeenCalledWith("default");
+ expect(screen.getByText(/SSO is not configured for this organization/i)).toBeInTheDocument();
+ });
+ });
+
+ it("redirects authenticated users away from login page", () => {
+ mockUser = { username: "active-operator", role: "admin" };
+
+ render(
+ <MemoryRouter>
+ <LoginPage />
+ </MemoryRouter>
+ );
+
+ // If authenticated, LoginPage immediately returns <Navigate to="/" replace />
+ expect(screen.queryByRole("heading", { name: "Sign In" })).not.toBeInTheDocument();
+ });
+});
diff --git a/frontend/src/features/dashboard/DashboardPages.tsx b/frontend/src/features/dashboard/DashboardPages.tsx
index 671c5bf..3409664 100644
--- a/frontend/src/features/dashboard/DashboardPages.tsx
+++ b/frontend/src/features/dashboard/DashboardPages.tsx
@@ -1,91 +1,45 @@
import {
- Activity,
- AlertTriangle,
- ArrowRight,
- ArrowUpDown,
Bell,
- Check,
- CheckCircle2,
ChevronDown,
- Copy,
- Cpu,
- Crosshair,
- Eye,
- EyeOff,
- FileText,
- Info,
- Key,
- Layers,
- Loader2,
- Lock,
Menu,
- MinusCircle,
- Plus,
- Radio,
Search,
- ShieldAlert,
- ShieldCheck,
- Target,
- Terminal,
Trash2,
X,
- Zap
} from "lucide-react";
import {
- ChangeEvent,
- FormEvent,
- KeyboardEvent,
ReactNode,
useCallback,
useEffect,
useMemo,
useRef,
- useState
+ useState,
} from "react";
-import { NavLink, Navigate, useLocation, useNavigate, useSearchParams } from "react-router-dom";
+import { NavLink, Navigate, useNavigate } from "react-router-dom";
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import {
- ApiError,
api,
- buildModuleRunPayload,
campaignEventsPath,
captureSession,
- isSessionCurrent
+ isSessionCurrent,
} from "../../api/client";
-import type { ApiKeyMeta, Campaign, ExecutionChain, FeasibilityReportData, FeasibilityResponse, Finding, ModuleMeta, MonthlyFindingStats, ParamField, ReportItem } from "../../api/types";
+import type { Campaign, LiveWebSocketEvent } from "../../api/types";
import { useAuth } from "../auth/authContext";
+import {
+ EmptyState,
+ ScreenMessage,
+ SectionHeader,
+ type TelemetrySnapshot,
+ formatRate,
+ metricNumber,
+ unique,
+} from "./dashboardComponents";
+
import { DashboardUiProvider } from "./dashboardUi";
import {
type DashboardUiState,
useDashboardSessionWriter,
- useDashboardUi,
useSessionState,
- useTabParam
} from "./dashboardUiState";
-import { StructuredJsonViewer } from "../../components/common/StructuredJsonViewer";
-import { ConfirmModal } from "../../components/ui/ConfirmModal";
-
-interface ModuleRunRecord {
- campaignId: string;
- moduleId: string;
- payload: unknown;
- isError?: boolean;
-}
-
-interface PersistedResult {
- key: string;
- payload: unknown;
- isError?: boolean;
-}
-
-interface GeneratedApiKey {
- id?: string;
- key: string;
- note?: string;
- prefix?: string;
-}
-
-type ApiKeyCopyStatus = "idle" | "copied" | "manual";
interface SearchResult {
id: string;
@@ -102,48 +56,6 @@ interface DashboardNotification {
tone: "info" | "warn" | "danger";
}
-const REQUIRED_FIELD_MESSAGE = "This field is required.";
-
-type ValidatableElement = HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
-type TelemetryMetricMap = Record<string, boolean | number | string | null | undefined>;
-interface TelemetrySnapshot {
- modules?: TelemetryMetricMap;
- queue?: TelemetryMetricMap;
- workers?: TelemetryMetricMap;
- latency_ms?: TelemetryMetricMap;
- throughput?: TelemetryMetricMap;
- findings?: number;
- credentials?: number;
- hosts?: TelemetryMetricMap;
- campaign_id?: string;
- timestamp?: number;
- [key: string]: unknown;
-}
-
-interface TemplatePlanStage {
- name?: string;
- modules?: string[];
- params?: Record<string, unknown>;
-}
-
-interface TemplatePlanResponse {
- template?: string;
- description?: string;
- plan?: {
- stages?: TemplatePlanStage[];
- };
- global_params?: Record<string, unknown>;
- note?: string;
-}
-
-function setRequiredMessage<T extends ValidatableElement>(event: FormEvent<T>) {
- event.currentTarget.setCustomValidity(REQUIRED_FIELD_MESSAGE);
-}
-
-function clearValidationMessage<T extends ValidatableElement>(event: ChangeEvent<T>) {
- event.currentTarget.setCustomValidity("");
-}
-
const navItems = [
{ to: "/", label: "Overview", code: "OVR" },
{ to: "/campaigns", label: "Campaigns", code: "CMP" },
@@ -164,49 +76,6 @@ const navGroups = [
{ label: "Control", items: navItems.slice(7) }
];
-const pageMeta: Record<string, { eyebrow: string; description: string }> = {
- Overview: {
- eyebrow: "Dashboard",
- description: "Health, telemetry, campaigns, and activity."
- },
- Campaigns: {
- eyebrow: "Operations",
- description: "Scopes, status, findings, and comparisons."
- },
- Modules: {
- eyebrow: "Operations",
- description: "Catalog, OPSEC, and authorized runs."
- },
- Reports: {
- eyebrow: "Operations",
- description: "Evidence packages and artifacts."
- },
- Graph: {
- eyebrow: "Intelligence",
- description: "Entities, relationships, and attack paths."
- },
- Templates: {
- eyebrow: "Intelligence",
- description: "Reusable campaign plans."
- },
- Strategy: {
- eyebrow: "Intelligence",
- description: "Authorized objective planning."
- },
- Security: {
- eyebrow: "Control",
- description: "Account, API keys, audit, and users."
- },
- "EDR/OPSEC": {
- eyebrow: "Control",
- description: "Detection outcomes and OPSEC feedback."
- },
- "Live Events": {
- eyebrow: "Control",
- description: "Campaign events as they arrive."
- }
-};
-
const brandMarkPath = "/dashboard/brand/ares-mark.png";
interface CampaignEventSocketOptions {
@@ -468,7 +337,7 @@ export function DashboardShell({ children }: { children: ReactNode }) {
setLiveCampaignId("");
setLiveConnected(false);
}
- setLiveEvents((items) => items.filter((item) => (item as any)?.campaign_id !== id));
+ setLiveEvents((items) => items.filter((item) => (item as LiveWebSocketEvent)?.campaign_id !== id));
await queryClient.invalidateQueries({ queryKey: ["telemetry"], refetchType: "all" });
await queryClient.invalidateQueries({ queryKey: ["monthlyStats"], refetchType: "all" });
@@ -512,11 +381,12 @@ export function DashboardShell({ children }: { children: ReactNode }) {
enabled: liveConnected,
onDisconnected: () => setLiveConnected(false),
onEvent: (event) => setLiveEvents((items) => {
+ const liveEvt = (typeof event === "object" && event !== null ? event : {}) as LiveWebSocketEvent;
const normalized = typeof event === "object" && event !== null
? {
...(event as Record<string, unknown>),
- campaign_id: (event as any).campaign_id || liveCampaignId,
- timestamp: typeof (event as any).timestamp === "number" ? (event as any).timestamp : Date.now()
+ campaign_id: liveEvt.campaign_id || liveCampaignId,
+ timestamp: typeof liveEvt.timestamp === "number" ? liveEvt.timestamp : Date.now()
}
: { raw: event, campaign_id: liveCampaignId, timestamp: Date.now() };
return [normalized, ...items].slice(0, 100);
@@ -535,18 +405,19 @@ export function DashboardShell({ children }: { children: ReactNode }) {
setLiveConnected,
liveEvents,
pushLiveEvent: (event: unknown) => setLiveEvents((items) => {
+ const liveEvt = (typeof event === "object" && event !== null ? event : {}) as LiveWebSocketEvent;
const normalized = typeof event === "object" && event !== null
? {
...(event as Record<string, unknown>),
- campaign_id: (event as any).campaign_id || liveCampaignId || selectedCampaignId || "",
- timestamp: typeof (event as any).timestamp === "number" ? (event as any).timestamp : Date.now()
+ campaign_id: liveEvt.campaign_id || liveCampaignId || selectedCampaignId || "",
+ timestamp: typeof liveEvt.timestamp === "number" ? liveEvt.timestamp : Date.now()
}
: { raw: event, campaign_id: liveCampaignId || selectedCampaignId || "", timestamp: Date.now() };
return [normalized, ...items].slice(0, 100);
}),
clearLiveEvents: (targetCampaignId?: string) => {
if (targetCampaignId) {
- setLiveEvents((items) => items.filter((item) => (item as any)?.campaign_id !== targetCampaignId));
+ setLiveEvents((items) => items.filter((item) => (item as LiveWebSocketEvent)?.campaign_id !== targetCampaignId));
} else {
setLiveEvents([]);
}
@@ -1113,5673 +984,21 @@ export function DashboardShell({ children }: { children: ReactNode }) {
);
}
-export function OverviewPage() {
- const navigate = useNavigate();
- const writeDashboardSession = useDashboardSessionWriter();
- const { campaigns: campaignList, campaignsLoading, selectedCampaignId, setSelectedCampaignId } = useDashboardUi();
- const telemetry = useQuery({
- queryKey: ["telemetry", selectedCampaignId],
- queryFn: () => api.telemetry(selectedCampaignId || undefined)
- });
- const monthlyStats = useQuery({
- queryKey: ["monthlyStats", selectedCampaignId],
- queryFn: () => api.monthlyStats(selectedCampaignId || undefined)
- });
- const snapshot = telemetry.data as TelemetrySnapshot | undefined;
- const monthlyData = monthlyStats.data as MonthlyFindingStats | undefined;
-
- const selectedCampaign = selectedCampaignId
- ? campaignList.find((campaign) => campaign.id === selectedCampaignId)
- : undefined;
-
- const nonDeletedCampaigns = (selectedCampaign ? [selectedCampaign] : campaignList).filter(
- (campaign) => String(campaign.status ?? "").toLowerCase() !== "deleted"
- );
- const runningCampaigns = nonDeletedCampaigns.filter((campaign) =>
- ["running", "active", "executing"].includes(String(campaign.status ?? "").toLowerCase())
- );
- const trackedCount = nonDeletedCampaigns.length;
- const runningCount = runningCampaigns.length;
-
- const findings = typeof monthlyData?.confirmed_findings === "number"
- ? monthlyData.confirmed_findings
- : typeof snapshot?.findings === "number"
- ? snapshot.findings
- : 0;
- const monthlyTotal = typeof monthlyData?.total === "number" ? monthlyData.total : 0;
- const monthlySeries = normalizeMonthlySeries(monthlyData?.period, monthlyData?.series);
-
- // Dynamic header status subtitle (strictly distinguish running execution vs in-scope campaigns)
- let overviewSubtitle: string;
- if (selectedCampaign) {
- const scopeStr = selectedCampaign.scope_cidrs?.length ? selectedCampaign.scope_cidrs.join(", ") : "Single target";
- overviewSubtitle = `Active Scope: ${selectedCampaign.name} (${selectedCampaign.id.slice(0, 8)}) · CIDRs: ${scopeStr} · Telemetry Scoped`;
- } else if (trackedCount === 0) {
- overviewSubtitle = "Enclave standby · No campaigns in scope · Ready for campaign deployment";
- } else if (runningCount > 0) {
- overviewSubtitle = `${runningCount} active execution${runningCount === 1 ? "" : "s"} · ${trackedCount} in scope · Enclave telemetry streaming`;
- } else {
- overviewSubtitle = `${trackedCount} campaign${trackedCount === 1 ? "" : "s"} in scope · Telemetry pipeline standby · Fail-closed policy enforced`;
- }
-
- // Fresh install empty-state (Task 5 / CampaignSync test requirement)
- if (!campaignsLoading && trackedCount === 0) {
- return (
- <Page title="Overview" subtitle={overviewSubtitle}>
- <div className="dashboard-empty-hero">
- <div className="fresh-hero-icon-wrap">
- <Target size={32} className="text-cyan-400" />
- </div>
- <h2>No Campaigns Initialized</h2>
- <p>
- Initialize an authorized red-team engagement to define target boundaries,
- configure CIDR scopes, and execute automated validation modules.
- </p>
- <div className="fresh-hero-actions">
- <button
- className="btn btn-primary flex items-center gap-2 px-4 py-2 text-sm font-semibold"
- onClick={() => {
- navigate("/campaigns?tab=List");
- }}
- type="button"
- >
- <Plus size={16} />
- <span>Create First Campaign</span>
- </button>
- <button
- className="btn flex items-center gap-2 px-4 py-2 text-sm"
- onClick={() => navigate("/modules")}
- type="button"
- >
- <Layers size={15} />
- <span>Browse Module Catalog</span>
- </button>
- </div>
- </div>
-
- <div className="fresh-readiness-panel">
- <div className="telemetry-strip flex items-center justify-between text-xs text-zinc-400">
- <div className="flex items-center gap-5">
- <span><strong className="text-zinc-200">Runtime:</strong> Ready</span>
- <span><strong className="text-zinc-200">Worker Pool:</strong> {metricNumber(snapshot?.workers, "active")} active</span>
- <span><strong className="text-zinc-200">Task Queue:</strong> {metricNumber(snapshot?.queue, "depth")} queued</span>
- </div>
- <span className="text-zinc-500 font-mono text-[11px]">Awaiting first engagement initialization</span>
- </div>
- </div>
- </Page>
- );
- }
-
- // Tactical operational metrics extraction
- const totalRuns = metricNumber(snapshot?.modules, "total");
- const successRuns = metricNumber(snapshot?.modules, "success");
- const failedRuns = metricNumber(snapshot?.modules, "failed");
- const errorRate = metricNumber(snapshot?.modules, "error_rate");
- const p95 = metricNumberOrNull(snapshot?.latency_ms, "p95");
- const queueDepth = metricNumber(snapshot?.queue, "depth");
- const activeWorkers = metricNumber(snapshot?.workers, "active");
- const unhealthyWorkers = metricNumber(snapshot?.workers, "unhealthy");
- const hostsDiscovered = metricNumber(snapshot?.hosts, "discovered");
- const hostsOwned = metricNumberOrNull(snapshot?.hosts, "owned");
- const tasksPerMin = metricNumberOrNull(snapshot?.throughput, "tasks_per_min");
- const credentialsCount = typeof snapshot?.credentials === "number" ? snapshot.credentials : 0;
- const isIngestionActive = Boolean(snapshot && snapshot.timestamp);
-
- const quickActions = (
- <div className="overview-quick-actions">
- <button
- type="button"
- className="btn btn-primary text-xs flex items-center gap-1.5"
- onClick={() => {
- navigate("/campaigns?tab=List");
- }}
- title="Initialize an authorized engagement"
- >
- <Plus size={14} />
- <span>New Campaign</span>
- </button>
- <button
- type="button"
- className="btn text-xs flex items-center gap-1.5"
- onClick={() => navigate("/modules")}
- title="Browse validation module catalog"
- >
- <Layers size={14} />
- <span>Module Catalog</span>
- </button>
- <button
- type="button"
- className="btn text-xs flex items-center gap-1.5"
- onClick={() => navigate("/live")}
- title="Open real-time event telemetry stream"
- >
- <Radio size={14} />
- <span>Live Stream</span>
- </button>
- </div>
- );
-
- return (
- <Page title="Overview" subtitle={overviewSubtitle} actions={quickActions}>
- <div className="overview-shell">
- {/* Tier 1: Executive Telemetry HUD */}
- <div className="hud-bento-grid">
- {/* Card 1: Active Engagements */}
- <div className="hud-bezel-card">
- <div className="hud-bezel-inner">
- <div className="hud-card-header">
- <span className="hud-card-title">Active Engagements</span>
- </div>
- <div className="hud-card-value">
- {trackedCount}
- </div>
- <div className="hud-card-footer">
- <span className="hud-context-text">
- {runningCount > 0
- ? `${runningCount} active execution${runningCount > 1 ? "s" : ""}`
- : trackedCount > 0
- ? "Staged readiness"
- : "Standby"}
- </span>
- </div>
- </div>
- </div>
-
- {/* Card 2: Validated Findings */}
- <div className="hud-bezel-card">
- <div className="hud-bezel-inner">
- <div className="hud-card-header">
- <span className="hud-card-title">Validated Findings</span>
- </div>
- <div className="hud-card-value">
- {formatMetric(findings)}
- </div>
- <div className="hud-card-footer">
- <span className="hud-context-text">
- {findings > 0 ? "Confirmed security vulnerabilities" : "No vulnerabilities detected"}
- </span>
- </div>
- </div>
- </div>
-
- {/* Card 3: Attack Surface */}
- <div className="hud-bezel-card">
- <div className="hud-bezel-inner">
- <div className="hud-card-header">
- <span className="hud-card-title">Attack Surface</span>
- </div>
- <div className="hud-card-value">
- {hostsDiscovered > 0 ? hostsDiscovered : "0"} <span className="text-xs font-normal text-zinc-400 font-sans">hosts</span>
- </div>
- <div className="hud-card-footer">
- <span className="hud-context-text">
- {hostsOwned !== null && hostsOwned > 0
- ? `${hostsOwned} compromise targets`
- : "Perimeter mapped"}
- </span>
- </div>
- </div>
- </div>
-
- {/* Card 4: Engine Health */}
- <div className="hud-bezel-card">
- <div className="hud-bezel-inner">
- <div className="hud-card-header">
- <span className="hud-card-title">Engine Health</span>
- </div>
- <div className="hud-card-value">
- {p95 !== null ? `${formatMetric(p95)} ms` : isIngestionActive ? "Nominal" : "Standby"}
- </div>
- <div className="hud-card-footer">
- <span className="hud-context-text">
- {activeWorkers} workers online · {queueDepth} queued
- </span>
- </div>
- </div>
- </div>
- </div>
-
- {/* Tier 2: Operational Telemetry (Clean 50/50 Balanced Grid) */}
- <div className="workstation-split">
- {/* Panel 1: Execution & Queue Telemetry */}
- <div className="overview-content-card">
- <div>
- <div className="flex items-center justify-between">
- <span className="text-[11px] font-mono uppercase tracking-wider text-zinc-400">
- Execution Telemetry
- </span>
- <span className="font-mono text-[11px] text-zinc-500">
- {snapshot?.timestamp ? formatReportTime(snapshot.timestamp) : "Standby"}
- </span>
- </div>
-
- <div className="pulse-stat-grid mt-3">
- <div className="pulse-stat-cell">
- <div className="pulse-stat-label">Task Queue</div>
- <div className="pulse-stat-value">
- {queueDepth} <span className="text-xs font-normal text-zinc-400 font-sans">queued</span>
- </div>
- </div>
- <div className="pulse-stat-cell">
- <div className="pulse-stat-label">Module Runs</div>
- <div className="pulse-stat-value">
- {totalRuns} <span className="text-xs font-normal text-zinc-400 font-sans">({successRuns} ok)</span>
- </div>
- </div>
- <div className="pulse-stat-cell">
- <div className="pulse-stat-label">Failure Rate</div>
- <div className={`pulse-stat-value ${failedRuns > 0 ? "text-rose-400" : "text-zinc-200"}`}>
- {formatRate(errorRate)}
- </div>
- </div>
- <div className="pulse-stat-cell">
- <div className="pulse-stat-label">Worker Pool</div>
- <div className="pulse-stat-value text-emerald-400">
- {activeWorkers} <span className="text-xs font-normal text-zinc-400 font-sans">active</span>
- </div>
- </div>
- </div>
- </div>
-
- <div className="flex items-center gap-2 pt-2 border-t border-zinc-800/60">
- <button
- type="button"
- className="btn btn-compact text-xs flex items-center gap-1.5"
- onClick={() => navigate("/modules")}
- title="Browse validation module catalog"
- >
- <Terminal size={13} />
- <span>Run Modules</span>
- </button>
- <button
- type="button"
- className="btn btn-compact text-xs flex items-center gap-1.5"
- onClick={() => navigate("/graph")}
- title="Open attack relationship graph"
- >
- <Crosshair size={13} />
- <span>Attack Graph</span>
- </button>
- <button
- type="button"
- className="btn btn-compact text-xs flex items-center gap-1.5 ml-auto"
- onClick={() => navigate("/reports")}
- title="View compliance and engagement reports"
- >
- <ShieldCheck size={13} />
- <span>Reports</span>
- </button>
- </div>
- </div>
-
- {/* Panel 2: Activity Pulse & Signals */}
- <div className="overview-content-card">
- <div>
- <div className="flex items-center justify-between">
- <span className="text-[11px] font-mono uppercase tracking-wider text-zinc-400">
- Activity Pulse
- </span>
- <span className="font-mono text-[11px] text-zinc-300">
- {monthlyTotal} signals total
- </span>
- </div>
- <div className="mt-3">
- {monthlySeries.some((value) => value.count > 0) ? (
- <SparklineBars values={monthlySeries} />
- ) : (
- <div className="h-24 flex items-center justify-center text-xs text-zinc-400 bg-zinc-950/40 rounded border border-dashed border-zinc-800">
- Awaiting operational signal telemetry
- </div>
- )}
- </div>
- </div>
-
- <div className="flex items-center justify-between text-xs text-zinc-400 pt-2 border-t border-zinc-800/60 font-mono text-[11px]">
- <span>Telemetry: {isIngestionActive ? "Ingestion Active" : "Standby"}</span>
- <span>{hostsDiscovered} hosts mapped</span>
- </div>
- </div>
- </div>
-
- {/* Tier 3: Campaign Inventory Matrix */}
- <CampaignTable
- campaigns={selectedCampaign ? [selectedCampaign] : campaignList}
- scopedCampaignId={selectedCampaignId}
- onClearScope={() => setSelectedCampaignId("")}
- onSelectCampaign={(id) => setSelectedCampaignId(id)}
- />
- </div>
- </Page>
- );
-}
-
-function normalizeMonthlySeries(
- period: string | undefined,
- series: MonthlyFindingStats["series"] | undefined
-): MonthlyFindingStats["series"] {
- if (!period || !/^\d{4}-\d{2}$/.test(period)) return [];
- const [yearText, monthText] = period.split("-");
- const year = Number(yearText);
- const month = Number(monthText);
- if (!Number.isInteger(year) || !Number.isInteger(month) || month < 1 || month > 12) return [];
-
- const counts = new Map<string, number>();
- for (const item of series ?? []) {
- const count = Number(item.count);
- if (item.date && Number.isFinite(count)) counts.set(item.date, Math.max(0, count));
- }
-
- const daysInMonth = new Date(year, month, 0).getDate();
- return Array.from({ length: daysInMonth }, (_, index) => {
- const date = `${period}-${String(index + 1).padStart(2, "0")}`;
- return { date, count: counts.get(date) ?? 0 };
- });
-}
-
-const VALID_TABS_CAMPAIGNS = ["List", "Scope", "Findings"] as const;
-type CampaignsTab = typeof VALID_TABS_CAMPAIGNS[number];
-
-export function CampaignsPage() {
- const queryClient = useQueryClient();
- const {
- selectedCampaignId: selected,
- setSelectedCampaignId: setSelected,
- campaigns: campaignList,
- deleteCampaign,
- isDeletingCampaign,
- refetchCampaigns,
- pushLiveEvent
- } = useDashboardUi();
- const [name, setName] = useSessionState("ares.dashboard.campaigns.create.name", "");
- const [client, setClient] = useSessionState("ares.dashboard.campaigns.create.client", "Internal");
- const [targets, setTargets] = useSessionState("ares.dashboard.campaigns.create.targets", "");
- const [scope, setScope] = useSessionState("ares.dashboard.campaigns.create.scope", "");
- const [noiseProfile, setNoiseProfile] = useSessionState("ares.dashboard.campaigns.create.noiseProfile", "stealth");
- const [createWarning, setCreateWarning] = useState("");
- const [otherId, setOtherId] = useSessionState("ares.dashboard.campaigns.compareId", "");
- const [rawTab, setActiveTab] = useTabParam("List");
- const activeTab = (VALID_TABS_CAMPAIGNS as readonly string[]).includes(rawTab)
- ? (rawTab as CampaignsTab)
- : "List";
- const [deleteError, setDeleteError] = useState<unknown>(null);
- const [deleteTarget, setDeleteTarget] = useState<string | null>(null);
- const [localDeleting, setLocalDeleting] = useState(false);
- const isDeleting = localDeleting || Boolean(isDeletingCampaign);
- const detail = useQuery({
- queryKey: ["campaign", selected],
- queryFn: () => api.campaign(selected),
- enabled: Boolean(selected)
- });
- const findings = useQuery({
- queryKey: ["findings", selected],
- queryFn: () => api.findings(selected),
- enabled: Boolean(selected)
- });
- const cvss = useQuery({
- queryKey: ["cvss", selected],
- queryFn: () => api.cvss(selected),
- enabled: Boolean(selected)
- });
- const diff = useQuery({
- queryKey: ["diff", selected, otherId],
- queryFn: () => api.diffCampaign(selected, otherId),
- enabled: Boolean(selected && otherId)
- });
- const create = useMutation({
- mutationFn: () =>
- api.createCampaign({
- name: name.trim(),
- client: client.trim(),
- targets: splitLines(targets),
- scope_cidrs: splitLines(scope),
- noise_profile: noiseProfile
- }),
- onSuccess: (campaign) => {
- setSelected(campaign.id);
- setName("");
- setTargets("");
- setScope("");
- setNoiseProfile("stealth");
- setCreateWarning("");
- setActiveTab("Scope");
- queryClient.setQueryData<Campaign[]>(["campaigns"], (old) => [campaign, ...(old ?? [])]);
- void queryClient.invalidateQueries({ queryKey: ["campaigns"], refetchType: "all" });
- }
- });
- const restore = useMutation({
- mutationFn: () => api.restoreVault(selected),
- onSuccess: (data) => {
- const count = (data as any)?.restored ?? 0;
- const campaignName = (detail.data ?? campaignList.find((c) => c.id === selected))?.name || selected;
- pushLiveEvent({
- type: "vault.restored",
- campaign_id: selected,
- message: `Credential vault synchronized: ${count} credential${count === 1 ? "" : "s"} rehydrated into runtime memory for '${campaignName}'.`,
- timestamp: Date.now(),
- restored: count
- });
- },
- onError: (err) => {
- const msg = (err as any)?.detail || (err as Error)?.message || "The request failed.";
- pushLiveEvent({
- type: "vault.restore_failed",
- campaign_id: selected,
- message: `Credential vault synchronization failed: ${msg}`,
- timestamp: Date.now(),
- error: msg
- });
- }
- });
- const run = useMutation({
- mutationFn: () => {
- const selectedCampaign = detail.data ?? campaignList.find((item) => item.id === selected);
- const targetHost = selectedCampaign?.targets?.[0] || "10.0.0.1";
- return api.runCampaign(selected, {
- plan: {
- stages: [
- {
- name: "Stage 1: Perimeter Recon & Fingerprint",
- modules: ["recon.fingerprint", "network.service_detect"],
- params: {
- "recon.fingerprint": { target: targetHost },
- "network.service_detect": { target: targetHost }
- }
- },
- {
- name: "Stage 2: Defense Feasibility & Coverage",
- modules: ["opsec.coverage_predictor"],
- params: {
- "opsec.coverage_predictor": { target: targetHost }
- }
- }
- ]
- },
- global_params: {
- target: targetHost,
- noise_profile: selectedCampaign?.noise_profile || "stealth"
- },
- dry_run: true
- });
- },
- onSuccess: (data) => {
- const isReady = (data as any)?.summary?.ready_to_run !== false;
- const stageCount = Array.isArray((data as any)?.plan)
- ? (data as any).plan.length
- : ((data as any)?.summary?.total_stages ?? 2);
- const campaignName = (detail.data ?? campaignList.find((c) => c.id === selected))?.name || selected;
- pushLiveEvent({
- type: isReady ? "campaign.dry_run_ready" : "campaign.dry_run_warning",
- campaign_id: selected,
- message: `Plan pre-flight check ${isReady ? "passed" : "completed with warnings"}: ${stageCount} stages verified for '${campaignName}'. Status: ${isReady ? "READY" : "WARNING"}.`,
- timestamp: Date.now(),
- plan: (data as any)?.plan,
- summary: (data as any)?.summary
- });
- },
- onError: (err) => {
- const msg = (err as any)?.detail || (err as Error)?.message || "The request failed.";
- pushLiveEvent({
- type: "campaign.dry_run_failed",
- campaign_id: selected,
- message: `Dry-run plan validation failed: ${msg}`,
- timestamp: Date.now(),
- error: msg
- });
- }
- });
-
- const handleDelete = async (targetId: string) => {
- if (!targetId || isDeleting) return;
- setLocalDeleting(true);
- setDeleteError(null);
- try {
- const ok = await deleteCampaign(targetId);
- if (ok) {
- setSelected("");
- setOtherId("");
- setActiveTab("List");
- } else {
- setDeleteError("Failed to delete campaign");
- }
- } catch (err) {
- setDeleteError(err);
- } finally {
- setLocalDeleting(false);
- }
- };
-
- return (
- <Page
- title="Campaigns"
- actions={<span className="status-pill">{campaignList.length} campaigns</span>}
- tabs={["List", "Scope", "Findings"]}
- activeTab={activeTab}
- onTabChange={setActiveTab}
- >
- {activeTab === "List" && (
- <>
- <section className="panel p-4">
- <SectionHeader title="Create Campaign" />
- <form className="grid gap-3" onSubmit={(e) => {
- e.preventDefault();
- if (!e.currentTarget.reportValidity()) return;
- const invalidScopeEntries = findInvalidScopeEntries(scope);
- if (invalidScopeEntries.length > 0) {
- setCreateWarning(`Scope CIDRs must be valid IPv4 CIDR/IP entries. Invalid: ${invalidScopeEntries.slice(0, 3).join(", ")}. Example: 10.0.0.0/24`);
- return;
- }
- setCreateWarning("");
- create.mutate();
- }}>
- <div className="grid gap-3 sm:grid-cols-2">
- <input className="field" required placeholder="Name" value={name} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setCreateWarning(""); setName(e.target.value); }} />
- <input className="field" required placeholder="Client" value={client} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setCreateWarning(""); setClient(e.target.value); }} />
- </div>
- <select className="field" value={noiseProfile} onChange={(e) => { setCreateWarning(""); setNoiseProfile(e.target.value); }}>
- <option value="stealth">Stealth</option>
- <option value="normal">Normal</option>
- <option value="aggressive">Aggressive</option>
- </select>
- <textarea className="field min-h-20" required placeholder="Targets" value={targets} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setCreateWarning(""); setTargets(e.target.value); }} />
- <textarea className="field min-h-20" required placeholder="Scope CIDRs" value={scope} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setCreateWarning(""); setScope(e.target.value); }} />
- {createWarning && <p className="notice notice-danger">{createWarning}</p>}
- <button className="btn btn-primary" disabled={create.isPending} type="submit">
- Create Campaign
- </button>
- </form>
- <DataPanel title="Create Error" data={create.error} />
- </section>
- <CampaignTable campaigns={campaignList} />
- </>
- )}
- {activeTab === "Scope" && (
- <>
- <section className="panel p-4">
- <SectionHeader title="Campaign Detail" />
- <div>
- <label htmlFor="scope-campaign-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
- Target Campaign
- </label>
- <CampaignPicker id="scope-campaign-select" campaigns={campaignList} value={selected} onChange={setSelected} />
- </div>
- <CampaignScopeSummary campaign={detail.data ?? campaignList.find((item) => item.id === selected)} loading={detail.isFetching} />
- <div className="mt-3 flex flex-wrap gap-2 items-center">
- <button
- className="btn"
- disabled={!selected || restore.isPending}
- onClick={() => restore.mutate()}
- type="button"
- >
- {restore.isPending && <Loader2 className="spin" size={14} />}
- <span>{restore.isPending ? "Restoring Vault…" : "Restore Vault"}</span>
- </button>
- <button
- className="btn"
- disabled={!selected || run.isPending}
- onClick={() => run.mutate()}
- type="button"
- >
- {run.isPending && <Loader2 className="spin" size={14} />}
- <span>{run.isPending ? "Simulating Dry Run…" : "Dry Run Plan"}</span>
- </button>
- <button
- className="btn btn-danger"
- disabled={!selected || isDeleting}
- onClick={() => setDeleteTarget(selected)}
- >
- {isDeleting ? "Deleting…" : "Delete"}
- </button>
- <input className="field max-w-xs" placeholder="Compare campaign ID" value={otherId} onChange={(e) => setOtherId(e.target.value)} />
- </div>
- </section>
-
- <DataPanel title="Vault Restore Error" data={restore.error} />
- <DataPanel title="Dry Run Error" data={run.error} />
- <DataPanel title="Delete Error" data={deleteError} />
- <DataPanel title="Campaign Detail Error" data={detail.error} />
- <DataPanel title="CVSS Error" data={cvss.error} />
- <DataPanel title="Campaign Diff Error" data={diff.error} />
- {cvss.data && <CvssScoreCard data={cvss.data} />}
- {diff.data && <CampaignDiffCard data={diff.data} />}
- </>
- )}
- {activeTab === "Findings" && (
- <section className="grid gap-4">
- <section className="panel p-4">
- <SectionHeader title="Campaign Findings" />
- <div>
- <label htmlFor="findings-campaign-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
- Target Campaign
- </label>
- <CampaignPicker id="findings-campaign-select" campaigns={campaignList} value={selected} onChange={setSelected} />
- </div>
- {!selected ? <EmptyState text="Select a campaign to review findings." /> : null}
- </section>
- {selected ? <DataPanel title="Findings Error" data={findings.error} /> : null}
- {selected ? <FindingsTable findings={findings.data ?? []} /> : null}
- </section>
- )}
- <ConfirmModal
- open={deleteTarget !== null}
- title="Delete Campaign"
- description="Permanently delete this campaign and all its stored findings, hosts, credentials, and loot artifacts. This action cannot be undone."
- confirmLabel="Delete Campaign"
- cancelLabel="Cancel"
- variant="danger"
- onConfirm={() => {
- if (deleteTarget) {
- const target = deleteTarget;
- setDeleteTarget(null);
- void handleDelete(target);
- }
- }}
- onCancel={() => setDeleteTarget(null)}
- />
- </Page>
- );
-}
-
-function ExecutionChainsPanel({
- chains,
- moduleIds,
- onSelectModule
-}: {
- chains: ExecutionChain[];
- moduleIds: Set<string>;
- onSelectModule: (moduleId: string) => void;
-}) {
- if (chains.length === 0) {
- return <EmptyState text="No execution chains are available." />;
- }
- return (
- <section className="grid gap-3">
- {chains.map((chain) => (
- <article className="panel p-4" key={chain.id}>
- <SectionHeader
- title={chain.title}
- eyebrow={chain.category}
- description={chain.description}
- action={<span className="badge">{chain.stages.length} stages</span>}
- />
- <div className="grid gap-3">
- {chain.stages.map((stage) => (
- <div className="compact-row" key={`${chain.id}-${stage.order}`}>
- <div className="flex flex-wrap items-center justify-between gap-2">
- <div className="flex flex-wrap items-center gap-2">
- <span className="badge">Step {stage.order}</span>
- <strong>{stage.title}</strong>
- {stage.final_goal && <span className="badge badge-low">Final goal</span>}
- </div>
- <span className="text-xs font-medium text-zinc-400">
- {stage.uses_previous_output ? "Uses prior output" : "Starts from campaign inputs"}
- </span>
- </div>
- <p className="mt-2 text-sm text-zinc-300">{stage.purpose}</p>
- {stage.module_ids.length > 0 && (
- <div className="mt-3 flex flex-wrap items-center gap-2">
- <strong className="text-sm">Run</strong>
- {stage.module_ids.map((moduleId) => (
- <button
- className="btn btn-compact"
- disabled={!moduleIds.has(moduleId)}
- key={moduleId}
- onClick={() => onSelectModule(moduleId)}
- title={moduleIds.has(moduleId) ? `Open ${moduleId} in the run panel` : "Module is not available in the current catalog"}
- type="button"
- >
- {moduleId}
- </button>
- ))}
- </div>
- )}
- <div className="mt-3 grid gap-1 text-xs text-zinc-400">
- <span><strong>Inputs:</strong> {stage.required_inputs.join(", ") || "none"}</span>
- <span><strong>Produces:</strong> {stage.produces.join("; ") || "none"}</span>
- <span><strong>Next:</strong> {stage.next_action}</span>
- </div>
- </div>
- ))}
- </div>
- </article>
- ))}
- </section>
- );
-}
-
-const VALID_TABS_MODULES = ["Catalog", "Execution Chains", "Run Panel", "Results"] as const;
-type ModulesTab = typeof VALID_TABS_MODULES[number];
-
-export function ModulesPage() {
- const { selectedCampaignId: campaignId, setSelectedCampaignId: setCampaignId, campaigns: campaignList } = useDashboardUi();
- const [searchParams] = useSearchParams();
- const location = useLocation();
- const queryClient = useQueryClient();
- const modules = useQuery({ queryKey: ["modules"], queryFn: api.modules });
- const executionChains = useQuery({ queryKey: ["executionChains"], queryFn: api.executionChains });
- const [selectedId, setSelectedId] = useSessionState("ares.dashboard.modules.selectedId", "");
- const [search, setSearch] = useSessionState("ares.dashboard.modules.search", "");
- const [category, setCategory] = useSessionState("ares.dashboard.modules.category", "");
- const [opsec, setOpsec] = useSessionState("ares.dashboard.modules.opsec", "");
- const [dryRun, setDryRun] = useSessionState("ares.dashboard.modules.dryRun", true);
- const [confirmed, setConfirmed] = useSessionState("ares.dashboard.modules.confirmed", false);
- const [params, setParams] = useSessionState<Record<string, unknown>>("ares.dashboard.modules.params", {});
- const [lastRunRecord, setLastRunRecord] = useSessionState<ModuleRunRecord | null>("ares.dashboard.modules.lastRun", null);
- const [rawTab, setActiveTab] = useTabParam("Catalog");
- const activeTab = (VALID_TABS_MODULES as readonly string[]).includes(rawTab)
- ? (rawTab as ModulesTab)
- : "Catalog";
- const previousSelectedId = useRef(selectedId);
-
- useEffect(() => {
- const queryModule = searchParams.get("module") || (location.state as { moduleId?: string } | null)?.moduleId;
-
- if (queryModule) {
- setSelectedId(queryModule);
- }
- }, [searchParams, location.state, setSelectedId]);
- const campaignDetail = useQuery({
- queryKey: ["campaign", campaignId],
- queryFn: () => api.campaign(campaignId),
- enabled: Boolean(campaignId)
- });
- const run = useMutation({
- mutationFn: () => api.runModule(selectedId, buildModuleRunPayload(campaignId, params, dryRun)),
- onSuccess: (payload) => {
- setLastRunRecord({ campaignId, moduleId: selectedId, payload });
- setActiveTab("Results");
- if (!dryRun) {
- void queryClient.invalidateQueries({ queryKey: ["graph"] });
- void queryClient.invalidateQueries({ queryKey: ["campaigns"] });
- void queryClient.invalidateQueries({ queryKey: ["campaign", campaignId] });
- void queryClient.invalidateQueries({ queryKey: ["attack-paths"] });
- void queryClient.invalidateQueries({ queryKey: ["findings"] });
- void queryClient.invalidateQueries({ queryKey: ["telemetry"] });
- void queryClient.invalidateQueries({ queryKey: ["monthlyStats"] });
- }
- },
- onError: (error) => {
- setLastRunRecord({ campaignId, moduleId: selectedId, payload: serializeError(error), isError: true });
- setActiveTab("Results");
- if (!dryRun) {
- void queryClient.invalidateQueries({ queryKey: ["graph"] });
- void queryClient.invalidateQueries({ queryKey: ["campaigns"] });
- void queryClient.invalidateQueries({ queryKey: ["campaign", campaignId] });
- void queryClient.invalidateQueries({ queryKey: ["attack-paths"] });
- void queryClient.invalidateQueries({ queryKey: ["findings"] });
- void queryClient.invalidateQueries({ queryKey: ["telemetry"] });
- void queryClient.invalidateQueries({ queryKey: ["monthlyStats"] });
- }
- }
- });
- const list = useMemo(() => modules.data ?? [], [modules.data]);
- const moduleIds = useMemo(() => new Set(list.map((item) => item.id)), [list]);
- const relatedChainsByModule = useMemo(() => {
- const related = new Map<string, string[]>();
- for (const chain of executionChains.data ?? []) {
- for (const stage of chain.stages) {
- for (const moduleId of stage.module_ids) {
- const current = related.get(moduleId) ?? [];
- if (!current.includes(chain.title)) {
- current.push(chain.title);
- }
- related.set(moduleId, current);
- }
- }
- }
- return related;
- }, [executionChains.data]);
- const selected = list.find((item) => item.id === selectedId);
- const selectedCampaign = campaignDetail.data ?? campaignList.find((item) => item.id === campaignId);
- const scopeWarning = moduleScopeWarning(selected, selectedCampaign, params, dryRun);
- const categories = unique(list.map((item) => item.category || ""));
- const visible = list.filter((item) => {
- const haystack = `${item.id} ${item.name ?? ""} ${item.description ?? ""} ${item.mitre ?? ""}`.toLowerCase();
- return (
- (!search || haystack.includes(search.toLowerCase())) &&
- (!category || item.category === category) &&
- (!opsec || item.opsec_level === opsec)
- );
- });
- const sensitive = isSensitiveModule(selected);
- const requiresConfirmation = sensitive;
- const dryRunSupported = selected?.dry_run_supported !== false;
- const kerberoastTargetMissing = selected?.id === "ad.kerberoast" && !String(params.target_user ?? "").trim();
- const [attemptedRun, setAttemptedRun] = useState(false);
- const executionConditionBlocked = (!requiresConfirmation || confirmed) && !run.isPending && (!dryRun || dryRunSupported) && !Boolean(scopeWarning) && !kerberoastTargetMissing;
- const canRun = Boolean(campaignId && selectedId) && executionConditionBlocked;
- const runBlocked = !canRun;
- const runHint = moduleRunHint(campaignId, selected, selectedCampaign, sensitive, confirmed, dryRun);
- const activeRun = (run.data ? { campaignId, moduleId: selectedId, payload: run.data, isError: false } : null) ??
- (lastRunRecord?.campaignId === campaignId ? lastRunRecord : null);
- const runResult = (!activeRun?.isError ? activeRun?.payload : undefined) as Record<string, unknown> | undefined;
- const runError = run.error ?? (activeRun?.isError ? activeRun.payload : undefined);
-
- useEffect(() => {
- let incomingParams: Record<string, unknown> | null = null;
- try {
- const stored = sessionStorage.getItem("ares.dashboard.modules.params");
- if (stored) {
- incomingParams = JSON.parse(stored);
- sessionStorage.removeItem("ares.dashboard.modules.params");
- }
- } catch {
- incomingParams = null;
- }
-
- const queryTarget = searchParams.get("target") || (location.state as { target?: string } | null)?.target;
- const stateParams = (location.state as { params?: Record<string, unknown> } | null)?.params;
- if (queryTarget || stateParams) {
- incomingParams = {
- ...(incomingParams ?? {}),
- ...(queryTarget ? { target: queryTarget, host: queryTarget, dc: queryTarget, targets: [queryTarget] } : {}),
- ...(stateParams ?? {})
- };
- }
-
- if (previousSelectedId.current === selectedId && !incomingParams) {
- return;
- }
- previousSelectedId.current = selectedId;
-
- const currentTarget = String(
- incomingParams?.target ||
- incomingParams?.host ||
- incomingParams?.dc ||
- params.target ||
- params.host ||
- params.dc ||
- params.target_host ||
- params.rhost ||
- selectedCampaign?.targets?.[0] ||
- ""
- ).trim();
-
- const targetModule = list.find((item) => item.id === selectedId);
- const schema = targetModule?.param_schema ?? {};
- const schemaKeys = Object.keys(schema);
-
- const nextParams: Record<string, unknown> = {};
-
- // 1. Populate primary target/host/dc fields if supported by module schema
- if (schemaKeys.includes("target") && currentTarget) {
- nextParams.target = currentTarget;
- }
- if (schemaKeys.includes("host") && currentTarget) {
- nextParams.host = currentTarget;
- }
- if (schemaKeys.includes("dc") && currentTarget) {
- nextParams.dc = currentTarget;
- }
- if (schemaKeys.includes("targets") && currentTarget) {
- nextParams.targets = [currentTarget];
- }
- if (schemaKeys.includes("target_host") && currentTarget) {
- nextParams.target_host = currentTarget;
- }
- if (schemaKeys.includes("rhost") && currentTarget) {
- nextParams.rhost = currentTarget;
- }
-
- // 2. Transfer standard parameters across chains and pivots if valid in schema
- const contextualKeys = ["port", "ports", "service", "domain", "username", "target_user", "use_ldaps"];
- for (const key of contextualKeys) {
- if (schemaKeys.includes(key)) {
- if (incomingParams && incomingParams[key] !== undefined) {
- nextParams[key] = incomingParams[key];
- } else if (params[key] !== undefined) {
- nextParams[key] = params[key];
- }
- }
- }
-
- // 3. Merge any specific incoming params passed explicitly
- if (incomingParams) {
- for (const [k, v] of Object.entries(incomingParams)) {
- if (v !== undefined) {
- nextParams[k] = v;
- }
- }
- }
- setParams(nextParams);
- setConfirmed(false);
- setDryRun(true);
- }, [selectedId, list, selectedCampaign, setConfirmed, setDryRun, setParams, searchParams, location.state]);
- return (
- <Page
- title="Modules"
- actions={<span className="status-pill">{visible.length} shown</span>}
- tabs={["Catalog", "Execution Chains", "Run Panel", "Results"]}
- activeTab={activeTab}
- onTabChange={setActiveTab}
- >
- {activeTab === "Catalog" && (
- <section className="panel p-4">
- <SectionHeader title="Module Catalog" />
- <div className="mb-3 grid gap-2 sm:grid-cols-3">
- <label className="field-with-icon sm:col-span-3">
- <Search size={15} />
- <input placeholder="Search modules, MITRE, descriptions" value={search} onChange={(e) => setSearch(e.target.value)} />
- </label>
- <select className="field" value={category} onChange={(e) => setCategory(e.target.value)}>
- <option value="">Category</option>
- {categories.map((item) => <option key={item} value={item}>{item}</option>)}
- </select>
- <select className="field" value={opsec} onChange={(e) => setOpsec(e.target.value)}>
- <option value="">OPSEC</option>
- {unique(list.map((item) => item.opsec_level || "")).map((item) => <option key={item} value={item}>{item}</option>)}
- </select>
- </div>
- <div className="grid max-h-[640px] gap-2 overflow-auto">
- {visible.map((item) => (
- <button
- className={`catalog-card ${selectedId === item.id ? "active" : ""}`}
- key={item.id}
- onClick={() => {
- setSelectedId(item.id);
- setActiveTab("Run Panel");
- }}
- >
- <div className="flex items-start justify-between gap-3">
- <div>
- <div className="font-bold">{item.id}</div>
- <div className="text-sm text-zinc-400">{item.description}</div>
- </div>
- <span className={opsecBadge(item.opsec_level)}>{item.opsec_level || "n/a"}</span>
- </div>
- <div className="mt-2 flex flex-wrap gap-1">
- {(item.mitre_list ?? []).slice(0, 4).map((technique) => <span className="badge" key={technique}>{technique}</span>)}
- {(relatedChainsByModule.get(item.id) ?? []).slice(0, 2).map((chainTitle) => (
- <span className="badge" key={chainTitle}>Chain: {chainTitle}</span>
- ))}
- </div>
- </button>
- ))}
- {visible.length === 0 && (
- <EmptyState text="No modules match the current search and filters." />
- )}
- </div>
- <DataPanel title="Module Catalog Error" data={modules.error} />
- </section>
- )}
- {activeTab === "Execution Chains" && (
- <>
- {executionChains.isPending && <EmptyState text="Loading execution chains..." />}
- {executionChains.error && <DataPanel title="Execution Chain Error" data={executionChains.error} />}
- {!executionChains.isPending && !executionChains.error && (
- <ExecutionChainsPanel
- chains={executionChains.data ?? []}
- moduleIds={moduleIds}
- onSelectModule={(moduleId) => {
- setSelectedId(moduleId);
- setActiveTab("Run Panel");
- }}
- />
- )}
- </>
- )}
- {activeTab === "Run Panel" && (
- <section className="panel p-4">
- <SectionHeader
- title="Run Panel"
- eyebrow={selected ? selected.id : "Select module"}
- action={selected ? <span className={opsecBadge(selected.opsec_level)}>{selected.opsec_level || "n/a"}</span> : null}
- />
- {selected?.description && <p className="text-sm text-zinc-300">{selected.description}</p>}
- {selected && (selected.capability_flags?.length || selected.supported_modes?.length) ? (
- <div className="mt-2 flex flex-wrap gap-1">
- {(selected.capability_flags ?? []).map((flag) => <span className="badge" key={flag}>{flag}</span>)}
- {(selected.supported_modes ?? []).map((mode) => <span className="badge" key={mode}>mode: {mode}</span>)}
- </div>
- ) : null}
- {selected?.dependency_notes?.length ? (
- <p className="mt-2 text-xs text-zinc-400 flex items-center gap-1.5">
- <Info size={13} className="text-zinc-500 shrink-0" />
- <span className="text-zinc-400 font-medium">Dependencies:</span> {selected.dependency_notes.join("; ")}
- </p>
- ) : null}
- {selected && !dryRunSupported && (
- <p className="mt-1 text-xs text-amber-400/80 flex items-center gap-1.5">
- <Info size={13} className="text-amber-400 shrink-0" />
- <span>Dry-run preview is unavailable for this module.</span>
- </p>
- )}
- <div className="mt-3 p-3.5 rounded-lg border border-zinc-800/80 bg-zinc-900/30">
- <label htmlFor="module-campaign-select" className="block text-xs font-mono text-zinc-300 mb-1.5 font-medium">
- Target Campaign
- </label>
- <CampaignPicker
- id="module-campaign-select"
- campaigns={campaignList}
- value={campaignId}
- hasError={attemptedRun && !campaignId}
- onChange={(id) => {
- setCampaignId(id);
- if (id) {
- setAttemptedRun(false);
- }
- }}
- />
- {attemptedRun && !campaignId && (
- <p className="mt-1.5 flex items-center gap-1.5 text-xs text-rose-400" role="alert">
- <AlertTriangle size={13} className="shrink-0 text-rose-400" />
- Select a scoped campaign before executing this module.
- </p>
- )}
- {campaignId && campaignDetail.isFetching && (
- <div className="notice mt-3 text-xs">
- <Loader2 className="spin" size={14} /> Loading campaign scope...
- </div>
- )}
- <DataPanel title="Campaign Scope Error" data={campaignDetail.error} />
- </div>
+// ============================================================================
+// MODULAR RE-EXPORTS (AUD-006 & AUD-008)
+// 100% backward-compatible façade re-exporting modular pages & components.
+// ============================================================================
- {selected ? (
- <form
- aria-busy={run.isPending}
- className="mt-4 grid gap-4 p-3.5 rounded-lg border border-zinc-800/80 bg-zinc-900/30"
- autoComplete="off"
- data-lpignore="true"
- data-form-type="other"
- onSubmit={(e) => {
- e.preventDefault();
- if (!campaignId) {
- setAttemptedRun(true);
- return;
- }
- if (!executionConditionBlocked) {
- return;
- }
- setAttemptedRun(false);
- run.mutate();
- }}
- >
- <div className="text-xs font-mono text-zinc-400 font-medium pb-2 border-b border-zinc-800/60 flex items-center justify-between">
- <span>Module Parameters</span>
- <span className="text-[11px] text-zinc-500 font-sans">{Object.keys(selected.param_schema || {}).length} field(s)</span>
- </div>
+export * from "./dashboardComponents";
- {/* Quick Target Selector for In-Scope Campaign Hosts */}
- {((selectedCampaign?.targets && selectedCampaign.targets.length > 0) || (selectedCampaign?.scope_cidrs && selectedCampaign.scope_cidrs.length > 0)) && (
- <div className="p-2.5 rounded-sm bg-zinc-900/60 border border-zinc-800 space-y-1.5 text-xs font-mono">
- <div className="flex items-center justify-between">
- <span className="text-zinc-400 text-[11px] uppercase tracking-wider flex items-center gap-1.5 font-semibold">
- <Target size={12} className="text-cyan-400 shrink-0" />
- QUICK ENGAGEMENT TARGETS:
- </span>
- <span className="text-[10px] text-zinc-500 font-sans">1-click populate</span>
- </div>
- <div className="flex flex-wrap items-center gap-1.5">
- {selectedCampaign?.targets?.map((tgt) => (
- <button
- key={tgt}
- type="button"
- onClick={() => setParams((prev) => ({ ...prev, target: tgt, host: tgt, dc: tgt, targets: [tgt] }))}
- className={`px-2 py-0.5 rounded-sm border text-[11px] transition-colors ${
- params.target === tgt || params.host === tgt || params.dc === tgt
- ? "bg-cyan-950 border-cyan-700 text-cyan-200 font-bold"
- : "bg-zinc-800 border-zinc-700 text-zinc-300 hover:bg-zinc-700 hover:text-zinc-100"
- }`}
- title={`Set target to ${tgt}`}
- >
- {tgt}
- </button>
- ))}
- {selectedCampaign?.scope_cidrs?.map((cidr) => (
- <button
- key={cidr}
- type="button"
- onClick={() => setParams((prev) => ({ ...prev, target: cidr, cidr }))}
- className="px-2 py-0.5 rounded-sm border border-zinc-800 bg-zinc-900 text-zinc-400 hover:bg-zinc-800 hover:text-zinc-200 text-[10px] transition-colors"
- title={`Set scope to ${cidr}`}
- >
- {cidr}
- </button>
- ))}
- </div>
- </div>
- )}
-
- <ParamForm
- schema={selected.param_schema}
- values={params}
- onChange={setParams}
- requiredOverrides={selected.id === "ad.kerberoast" ? { target_user: true } : undefined}
- />
-
- {/* Execution Mode Controls */}
- <div className="pt-2 border-t border-zinc-800/60 space-y-2.5">
- <label className="toggle-row text-xs text-zinc-300">
- <input type="checkbox" checked={dryRun} onChange={(e) => setDryRun(e.target.checked)} />
- {dryRunSupported ? "Dry run (simulate without live network execution)" : "Dry run unavailable"}
- </label>
-
- {requiresConfirmation && (
- <div className="notice notice-danger text-xs flex items-center gap-2.5 p-2.5 rounded border">
- <input
- id="confirm-override-checkbox"
- className="cursor-pointer shrink-0"
- type="checkbox"
- checked={confirmed}
- onChange={(e) => setConfirmed(e.target.checked)}
- />
- <label htmlFor="confirm-override-checkbox" className="cursor-pointer select-none">
- Confirm authorized high-noise or sensitive execution
- </label>
- </div>
- )}
-
- {runHint && runHint !== "Select a campaign before running a module." && (
- <p className="notice text-xs">{runHint}</p>
- )}
- {scopeWarning && (
- <p className="notice notice-danger text-xs">{scopeWarning}</p>
- )}
-
- <div className="pt-2">
- <button
- className="btn btn-primary w-full py-2.5 text-xs font-mono font-medium tracking-wide flex items-center justify-center gap-2"
- type="submit"
- disabled={!selectedId || run.isPending || (campaignId ? !executionConditionBlocked : false)}
- >
- {run.isPending ? (
- <>
- <Loader2 className="spin shrink-0" size={14} /> Running {selectedId}...
- </>
- ) : (
- `Execute ${selected.id}`
- )}
- </button>
- </div>
-
- {run.isPending && (
- <div className="notice notice-info text-xs" role="status" aria-live="polite">
- <Loader2 className="spin shrink-0" size={15} />
- Module execution in progress. Keep this page open while ARES validates the target and collects results.
- </div>
- )}
- </div>
- </form>
- ) : (
- <EmptyState text="Select a module from the catalog to configure and execute." />
- )}
- </section>
- )}
- {activeTab === "Results" && (
- <section className="panel p-4">
- <div className="flex items-center justify-between pb-3 mb-3 border-b border-zinc-800/80">
- <div>
- <span className="text-[10px] font-mono text-zinc-500 uppercase tracking-wider block">
- {activeRun?.moduleId ? `Module: ${activeRun.moduleId}` : (selected ? selected.id : "Execution")}
- </span>
- <h2 className="text-sm font-semibold text-zinc-100 flex items-center gap-2">
- <span>Run Results</span>
- {activeRun && (
- <span className="inline-flex items-center gap-1 px-1.5 py-0.5 rounded text-[10px] font-mono bg-zinc-800 text-zinc-300 border border-zinc-700">
- <Lock size={10} className="text-amber-400" />
- <span>Locked View</span>
- </span>
- )}
- </h2>
- </div>
- {activeRun && (
- <button
- type="button"
- onClick={() => {
- setLastRunRecord(null);
- run.reset();
- }}
- className="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-sm border border-zinc-700 bg-zinc-800/80 hover:bg-zinc-700 text-zinc-300 hover:text-white text-xs font-mono transition-colors"
- title="Dismiss and close this run result"
- >
- <X size={12} />
- <span>Close Result</span>
- </button>
- )}
- </div>
- {runResult || runError ? (
- <>
- <ModuleRunSummary
- result={runResult}
- error={runError}
- onSelectModule={(modId, targetParams) => {
- setSelectedId(modId);
- if (targetParams) {
- setParams((prev) => ({ ...prev, ...targetParams }));
- }
- setActiveTab("Run Panel");
- }}
- />
- <DataPanel title={runError ? "Run Error" : "Run Result"} data={runError ?? runResult} />
- </>
- ) : (
- <EmptyState text="Run a selected module to see results here." />
- )}
- </section>
- )}
- </Page>
- );
-}
-
-const VALID_TABS_REPORTS = ["Generate", "Library"] as const;
-type ReportsTab = typeof VALID_TABS_REPORTS[number];
-
-export function ReportsPage() {
- const { selectedCampaignId: campaignId, setSelectedCampaignId: setCampaignId, campaigns: campaignList } = useDashboardUi();
- const [format, setFormat] = useSessionState("ares.dashboard.reports.format", "html");
- const [warning, setWarning] = useState("");
- const [libraryError, setLibraryError] = useState("");
- const [deleteReportTarget, setDeleteReportTarget] = useState<ReportItem | null>(null);
- const [confirmClearAllReports, setConfirmClearAllReports] = useState(false);
- const [lastGenerateResult, setLastGenerateResult] = useSessionState<PersistedResult | null>("ares.dashboard.reports.lastGenerate", null);
- const [rawTab, setActiveTab] = useTabParam("Generate");
- const activeTab = (VALID_TABS_REPORTS as readonly string[]).includes(rawTab)
- ? (rawTab as ReportsTab)
- : "Generate";
- const queryClient = useQueryClient();
- const reports = useQuery({
- queryKey: ["reports", campaignId],
- queryFn: () => api.reports(campaignId),
- enabled: Boolean(campaignId)
- });
- const reportItems = reports.data?.reports ?? [];
- const reportResultKey = `${campaignId}:${format}`;
- const generate = useMutation({
- mutationFn: () => api.generateReport(campaignId, format),
- onSuccess: (payload) => {
- setLastGenerateResult({ key: reportResultKey, payload });
- setActiveTab("Library");
- void queryClient.invalidateQueries({ queryKey: ["reports", campaignId] });
- },
- onError: (error) => {
- setLastGenerateResult({ key: reportResultKey, payload: serializeError(error), isError: true });
- setActiveTab("Generate");
- }
- });
- const persistedGenerateResult = lastGenerateResult?.key === reportResultKey ? lastGenerateResult : null;
- const generateIssue = generate.error ?? (persistedGenerateResult?.isError ? persistedGenerateResult.payload : undefined);
- const pdfIssueHint = format === "pdf" ? pdfFailureHint(generateIssue) : "";
- const download = useMutation({
- mutationFn: async (item: ReportItem) => {
- const blob = await api.downloadReport(campaignId, item.filename);
- const url = URL.createObjectURL(blob);
- const link = document.createElement("a");
- link.href = url;
- link.download = item.filename;
- document.body.appendChild(link);
- link.click();
- link.remove();
- window.setTimeout(() => URL.revokeObjectURL(url), 1000);
- }
- });
- const deleteReport = useMutation({
- mutationFn: (item: ReportItem) => api.deleteReport(campaignId, item.filename),
- onSuccess: (_payload, item) => {
- queryClient.setQueryData<{ campaign_id: string; reports: ReportItem[] }>(
- ["reports", campaignId],
- (current) => current
- ? {
- ...current,
- reports: current.reports.filter((report) => report.filename !== item.filename)
- }
- : current
- );
- setLibraryError("");
- const activePayload = (generate.data ?? lastGenerateResult?.payload) as { filename?: string } | undefined;
- if (activePayload?.filename === item.filename) {
- generate.reset();
- setLastGenerateResult(null);
- }
- },
- onError: (error) => {
- setLibraryError(readableError(error, "Report could not be deleted."));
- }
- });
- const clearReports = useMutation({
- mutationFn: () => api.clearReports(campaignId),
- onSuccess: () => {
- queryClient.setQueryData<{ campaign_id: string; reports: ReportItem[] }>(
- ["reports", campaignId],
- (current) => current ? { ...current, reports: [] } : current
- );
- setLibraryError("");
- generate.reset();
- setLastGenerateResult(null);
- },
- onError: (error) => {
- setLibraryError(readableError(error, "Report library could not be cleared."));
- }
- });
-
- // Auto-clear stale generate result if the report file was deleted from library
- useEffect(() => {
- if (reports.isSuccess && (generate.data || lastGenerateResult?.payload)) {
- const activePayload = (generate.data ?? lastGenerateResult?.payload) as { filename?: string } | undefined;
- const activeFilename = activePayload?.filename;
- if (activeFilename && !reportItems.some((r) => r.filename === activeFilename)) {
- generate.reset();
- setLastGenerateResult(null);
- }
- }
- }, [reports.isSuccess, reportItems, generate.data, lastGenerateResult]);
-
- const deleteDisabled = deleteReport.isPending || clearReports.isPending;
- return (
- <Page
- title="Reports"
- actions={<span className="status-pill">{reports.data?.reports?.length ?? 0} artifacts</span>}
- tabs={["Generate", "Library"]}
- activeTab={activeTab}
- onTabChange={setActiveTab}
- >
- {activeTab === "Generate" && (
- <section className="panel p-4">
- <SectionHeader
- title="Generate Report"
- description="Export findings, scope, and remediation."
- />
- <div className="grid gap-3 sm:grid-cols-3 items-end">
- <div>
- <label htmlFor="report-campaign-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
- Target Campaign
- </label>
- <CampaignPicker
- id="report-campaign-select"
- campaigns={campaignList}
- value={campaignId}
- hasError={Boolean(warning && !campaignId)}
- onChange={(id) => {
- setCampaignId(id);
- setWarning("");
- }}
- />
- {warning && !campaignId && (
- <p className="mt-1.5 flex items-center gap-1.5 text-xs text-rose-400" role="alert">
- <AlertTriangle size={13} className="shrink-0 text-rose-400" />
- {warning}
- </p>
- )}
- </div>
- <div>
- <label htmlFor="report-format-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
- Export Format
- </label>
- <select
- id="report-format-select"
- className="field"
- value={format}
- onChange={(e) => setFormat(e.target.value)}
- >
- <option value="html">HTML Document</option>
- <option value="pdf">PDF Document</option>
- <option value="markdown">Markdown</option>
- <option value="json">JSON Export</option>
- </select>
- </div>
- <div>
- <button
- className="btn btn-primary w-full"
- disabled={generate.isPending}
- onClick={() => {
- if (!campaignId) {
- setWarning("Select a scoped campaign before generating a report.");
- return;
- }
- setWarning("");
- generate.mutate();
- }}
- >
- {generate.isPending ? (
- <>
- <Loader2 className="spin" size={16} /> Generating...
- </>
- ) : (
- "Generate Report"
- )}
- </button>
- </div>
- </div>
- {warning && campaignId && <p className="notice notice-danger mt-3">{warning}</p>}
- {pdfIssueHint && (
- <p className="notice notice-danger mt-3">
- <AlertTriangle size={16} />
- {pdfIssueHint}
- </p>
- )}
- <DataPanel
- title={generateIssue ? "Generate Error" : "Generate Result"}
- data={generate.error ?? generate.data ?? persistedGenerateResult?.payload}
- onClear={() => {
- generate.reset();
- setLastGenerateResult(null);
- }}
- />
- </section>
- )}
- {activeTab === "Library" && (
- <section className="panel table-panel">
- <SectionHeader
- title="Report Library"
- action={campaignId && reportItems.length > 0 ? (
- <button
- className="btn btn-danger"
- disabled={deleteDisabled}
- onClick={() => setConfirmClearAllReports(true)}
- >
- {clearReports.isPending ? (
- <Loader2 className="spin" size={15} />
- ) : null}
- Delete all
- </button>
- ) : null}
- />
- <div className="p-4 border-b border-zinc-800/80">
- <label htmlFor="library-campaign-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
- Target Campaign
- </label>
- <CampaignPicker
- id="library-campaign-select"
- campaigns={campaignList}
- value={campaignId}
- onChange={(id) => {
- setCampaignId(id);
- setWarning("");
- }}
- />
- </div>
- {campaignId && reportItems.length > 0 && (
- <div className="table-scroll">
- <table className="table">
- <thead><tr><th>Filename</th><th>Format</th><th>Size</th><th>Modified</th><th>Actions</th></tr></thead>
- <tbody>
- {reportItems.map((item) => (
- <tr key={item.filename}>
- <td className="font-medium text-zinc-100 font-mono text-sm">{item.filename}</td>
- <td><span className="badge">{item.format}</span></td>
- <td>{formatBytes(item.size_bytes)}</td>
- <td>{formatReportDate(item.modified_at)}</td>
- <td>
- <button className="btn" disabled={download.isPending || deleteDisabled} onClick={() => download.mutate(item)}>
- Download
- </button>
- <button
- className="btn btn-danger"
- disabled={deleteDisabled}
- onClick={() => setDeleteReportTarget(item)}
- >
- Delete
- </button>
- </td>
- </tr>
- ))}
- </tbody>
- </table>
- </div>
- )}
- {libraryError && (
- <p className="notice notice-danger mt-3">
- <AlertTriangle size={16} />
- {libraryError}
- </p>
- )}
- <DataPanel title="Report Library Error" data={reports.error} />
- {campaignId && reportItems.length === 0 && (
- <EmptyState text="No reports generated for this campaign yet." />
- )}
- {!campaignId && <EmptyState text="Select a campaign to list reports." />}
- <DataPanel title="Download Result" data={download.error} />
- </section>
- )}
- <ConfirmModal
- open={deleteReportTarget !== null}
- title="Delete Report"
- description={`Permanently delete report artifact "${deleteReportTarget?.filename ?? ""}". This action cannot be undone.`}
- confirmLabel="Delete Report"
- cancelLabel="Cancel"
- variant="danger"
- onConfirm={() => {
- if (deleteReportTarget) {
- setLibraryError("");
- deleteReport.mutate(deleteReportTarget);
- setDeleteReportTarget(null);
- }
- }}
- onCancel={() => setDeleteReportTarget(null)}
- />
- <ConfirmModal
- open={confirmClearAllReports}
- title="Delete All Reports"
- description={`Permanently delete all ${reportItems.length} report artifacts for this campaign. This action cannot be undone.`}
- confirmLabel="Delete All Reports"
- cancelLabel="Cancel"
- variant="danger"
- onConfirm={() => {
- setLibraryError("");
- clearReports.mutate();
- setConfirmClearAllReports(false);
- }}
- onCancel={() => setConfirmClearAllReports(false)}
- />
- </Page>
- );
-}
-
-const VALID_TABS_TEMPLATES = ["Templates", "Plan Builder"] as const;
-type TemplatesTab = typeof VALID_TABS_TEMPLATES[number];
-
-export function TemplatesPage() {
- const templates = useQuery({ queryKey: ["templates"], queryFn: api.templates });
- const [name, setName] = useSessionState("ares.dashboard.templates.name", "");
- const [params, setParams] = useSessionState("ares.dashboard.templates.params", "{}");
- const [warning, setWarning] = useState("");
- const [lastPlanResult, setLastPlanResult] = useSessionState<PersistedResult | null>("ares.dashboard.templates.lastPlan", null);
- const [rawTab, setActiveTab] = useTabParam("Templates");
- const activeTab = (VALID_TABS_TEMPLATES as readonly string[]).includes(rawTab)
- ? (rawTab as TemplatesTab)
- : "Templates";
- const templatePlanKey = `${name.trim()}:${params}`;
- const plan = useMutation({
- mutationFn: () => api.templatePlan(name, safeJson(params)),
- onSuccess: (payload) => setLastPlanResult({ key: templatePlanKey, payload }),
- onError: (error) => setLastPlanResult({ key: templatePlanKey, payload: serializeError(error), isError: true })
- });
- const selected = (templates.data ?? []).find((item) => item.name === name);
- const persistedPlanResult = lastPlanResult?.key === templatePlanKey ? lastPlanResult : null;
- const generated = (plan.data ?? (!persistedPlanResult?.isError ? persistedPlanResult?.payload : undefined)) as TemplatePlanResponse | undefined;
- const paramsValid = isJsonObject(params);
- return (
- <Page
- title="Templates"
- actions={<span className="status-pill">{templates.data?.length ?? 0} templates</span>}
- tabs={["Templates", "Plan Builder"]}
- activeTab={activeTab}
- onTabChange={setActiveTab}
- >
- <DataPanel title="Template Error" data={templates.error} />
- {activeTab === "Templates" && (
- <section className="panel p-4">
- <SectionHeader
- title="Campaign Templates"
- description="Pick a template and generate a plan."
- />
- <div className="grid gap-2">
- {(templates.data ?? []).map((item, index) => {
- const templateName = String(item.name ?? item.id ?? index);
- return (
- <button
- className={`template-card ${name === templateName ? "active" : ""}`}
- key={templateName}
- onClick={() => {
- setName(templateName);
- setWarning("");
- setLastPlanResult(null);
- plan.reset();
- setActiveTab("Plan Builder");
- }}
- >
- <span className="font-bold">{templateName}</span>
- <small>{item.description ?? "Campaign execution template"}</small>
- <span className="mt-2 flex flex-wrap gap-2">
- <span className="badge">{item.stages ?? 0} stages</span>
- <span className="badge">{item.modules ?? 0} modules</span>
- </span>
- </button>
- );
- })}
- </div>
- </section>
- )}
- {activeTab === "Plan Builder" && (
- <section className="panel p-4">
- <SectionHeader title="Plan Builder" action={name ? <span className="badge">{name}</span> : null} />
- <input className="field" placeholder="Template name" value={name} onChange={(e) => {
- setName(e.target.value);
- setWarning("");
- setLastPlanResult(null);
- }} />
- {selected ? (
- <div className="preview-card mt-3">
- <div className="font-bold">{selected.name}</div>
- <p className="mt-1 text-sm text-zinc-300">{selected.description}</p>
- <div className="mt-2 flex flex-wrap gap-2">
- <span className="badge">{selected.stages ?? 0} stages</span>
- <span className="badge">{selected.modules ?? 0} modules</span>
- </div>
- </div>
- ) : (
- <EmptyState text="Select a template from the left panel." />
- )}
- <div className="mt-3 block">
- <label htmlFor="template-global-params" className="block text-sm font-semibold mb-1 cursor-pointer">
- Global parameters
- </label>
- <textarea
- id="template-global-params"
- className="field min-h-32"
- value={params}
- placeholder={'{"target":"127.0.0.1","domain":"corp.local","dc":"10.0.0.5"}'}
- autoComplete="off"
- spellCheck={false}
- onChange={(e) => {
- setParams(e.target.value);
- setWarning("");
- }}
- />
- </div>
- <p className="mt-1 text-xs text-zinc-400">JSON object. Leave {"{}"} for defaults.</p>
- {(warning || !paramsValid) && (
- <p className="notice notice-danger mt-2">
- {warning || "Global parameters must be a valid JSON object."}
- </p>
- )}
- <button
- className="btn btn-primary mt-3"
- disabled={!name || plan.isPending || !paramsValid}
- onClick={() => {
- if (!name.trim()) {
- setWarning("Template name is required.");
- return;
- }
- if (!paramsValid) {
- setWarning("Global parameters must be a valid JSON object.");
- return;
- }
- setWarning("");
- plan.mutate();
- }}
- >
- {plan.isPending ? (
- <>
- <Loader2 className="spin" size={16} /> Generating...
- </>
- ) : (
- "Generate Plan"
- )}
- </button>
- <TemplatePlanSummary plan={generated} />
- <DataPanel
- title={(plan.error ?? (persistedPlanResult?.isError ? persistedPlanResult.payload : undefined)) ? "Plan Error" : "Plan Details"}
- data={plan.error ?? plan.data ?? persistedPlanResult?.payload}
- />
- </section>
- )}
- </Page>
- );
-}
-
-function StrategyActiveView({
- activeData,
- goal,
- llmBackend,
- allowed
-}: {
- activeData?: Record<string, unknown>;
- goal: string;
- llmBackend: string;
- allowed: boolean;
-}) {
- const [showRaw, setShowRaw] = useState(false);
- const activeCount = typeof activeData?.count === "number" ? activeData.count : 0;
- const maxAllowed = typeof activeData?.max_allowed === "number" ? activeData.max_allowed : 1;
- const slotsAvailable = typeof activeData?.slots_available === "number" ? activeData.slots_available : 1;
- const llmBackends = (activeData?.llm_backends as Record<string, boolean> | undefined);
- const backendReady = llmBackends ? llmBackends[llmBackend] !== false : true;
-
- const stages = [
- { number: 1, name: "Surface Discovery", desc: "Network & service perimeter mapping, host discovery", status: activeCount > 0 ? "active" : "standby" },
- { number: 2, name: "Defense Feasibility", desc: "EDR telemetry inspection, AMSI bypass calibration", status: "standby" },
- { number: 3, name: "Credential Extraction", desc: "Memory dumps, Kerberoasting, AS-REP extraction", status: "standby" },
- { number: 4, name: "Lateral Movement", desc: "Pivoting via WinRM, SMB, token impersonation", status: "standby" },
- { number: 5, name: "Domain Escalation", desc: "Privilege elevation, DCSync, Domain Admin achievement", status: "standby" }
- ];
-
- return (
- <div className="grid gap-4">
- <section className="panel p-4">
- <SectionHeader
- title="Planning Snapshot"
- action={
- <div className="flex items-center gap-2">
- <span className={`badge ${activeCount > 0 ? "badge-low" : "badge-info"}`}>
- {activeCount > 0 ? `${activeCount} Active Engagement` : "Idle / Ready"}
- </span>
- <span className="badge font-mono text-xs">{slotsAvailable} slot{slotsAvailable === 1 ? "" : "s"} free</span>
- </div>
- }
- />
- <div className="mini-stat-grid">
- <MiniStat title="Strategic Goal" value={goal} detail="Objective target" />
- <MiniStat
- title="LLM Backend"
- value={llmBackend}
- detail={backendReady ? "Engine online" : "Unconfigured key"}
- />
- <MiniStat
- title="Concurrency Slots"
- value={`${activeCount} / ${maxAllowed}`}
- detail={`${slotsAvailable} slot${slotsAvailable === 1 ? "" : "s"} available`}
- />
- <MiniStat
- title="Authorization"
- value={allowed ? "authorized" : "restricted"}
- detail={allowed ? "Ready to engage" : "Requires operator"}
- />
- </div>
- </section>
-
- <section className="panel p-4">
- <SectionHeader
- title="Autonomous Engagement Lifecycle"
- description="Sequential execution stages executed during autonomous strategy engagement."
- />
- <div className="compact-list mt-3">
- {stages.map((st) => (
- <div key={st.number} className="compact-row flex items-center justify-between gap-3 p-3">
- <div className="flex items-center gap-3">
- <div className={`w-7 h-7 rounded-full flex items-center justify-center text-xs font-bold ${
- st.status === "active"
- ? "bg-emerald-500/20 text-emerald-400 border border-emerald-500/50"
- : "bg-zinc-800 text-zinc-400 border border-zinc-700/60"
- }`}>
- {st.status === "active" ? <Loader2 size={13} className="spin text-emerald-400" /> : st.number}
- </div>
- <div>
- <div className="font-semibold text-sm text-zinc-100 flex items-center gap-2">
- <span>{st.name}</span>
- {st.status === "active" && (
- <span className="badge badge-low text-[10px] uppercase font-mono">Running</span>
- )}
- </div>
- <div className="text-xs text-zinc-400 mt-0.5">{st.desc}</div>
- </div>
- </div>
- <span className="badge font-mono text-xs">
- {st.status === "active" ? "In Progress" : "Standby"}
- </span>
- </div>
- ))}
- </div>
-
- {activeData && (
- <div className="mt-4 pt-3 border-t border-zinc-800/80">
- <button
- type="button"
- onClick={() => setShowRaw(!showRaw)}
- className="btn btn-compact text-[11px] py-1 px-2.5 text-zinc-400 hover:text-zinc-200 flex items-center gap-1.5"
- >
- <FileText size={12} />
- <span>{showRaw ? "Hide Raw Active State" : "View Raw Active State"}</span>
- <ChevronDown size={12} className={`transition-transform duration-200 ${showRaw ? "rotate-180" : ""}`} />
- </button>
- {showRaw && (
- <div className="mt-2">
- <StructuredJsonViewer data={activeData} title="Active Strategy State" maxHeightClass="max-h-72" />
- </div>
- )}
- </div>
- )}
- </section>
- </div>
- );
-}
-
-function StrategyResultView({
- resultData,
- isError
-}: {
- resultData: unknown;
- isError?: boolean;
-}) {
- const [showRaw, setShowRaw] = useState(false);
- const data = (resultData ?? {}) as Record<string, unknown>;
- const status = typeof data.status === "string" ? data.status : isError ? "failed" : "completed";
- const goal = typeof data.goal === "string" ? data.goal : "objective";
- const campaignId = typeof data.campaign_id === "string" ? data.campaign_id : "";
- const modulesRun = typeof data.modules_run === "number" ? data.modules_run : 0;
- const children = Array.isArray(data.children) ? (data.children as Record<string, unknown>[]) : [];
-
- const totalFindings = children.reduce((acc, c) => acc + (typeof c.findings_count === "number" ? c.findings_count : 0), 0);
- const totalDurationMs = children.reduce((acc, c) => acc + (typeof c.duration_ms === "number" ? c.duration_ms : 0), 0);
-
- return (
- <div className="grid gap-4">
- {isError && (
- <p className="notice notice-danger">
- Engagement failed: {String(data.detail ?? data.error ?? "Unknown execution error")}
- </p>
- )}
-
- <section className="panel p-4">
- <SectionHeader
- title="Engagement Summary"
- action={<StatusBadge status={status} />}
- />
- <div className="mini-stat-grid">
- <MiniStat title="Status" value={status} detail={campaignId ? `Campaign ${campaignId.slice(0, 8)}` : "Finished"} />
- <MiniStat title="Objective Goal" value={goal} detail="Strategic target" />
- <MiniStat title="Modules Run" value={String(modulesRun || children.length)} detail="Autonomous pipeline" />
- <MiniStat title="Total Findings" value={String(totalFindings)} detail="Security telemetry" />
- <MiniStat title="Total Duration" value={`${(totalDurationMs / 1000).toFixed(2)}s`} detail={`${totalDurationMs} ms total`} />
- </div>
- </section>
-
- {children.length > 0 && (
- <section className="panel table-panel">
- <SectionHeader
- title="Module Execution Breakdown"
- action={<span className="badge">{children.length} step{children.length === 1 ? "" : "s"}</span>}
- />
- <div className="table-scroll">
- <table className="table">
- <thead>
- <tr>
- <th>#</th>
- <th>Stage</th>
- <th>Module</th>
- <th>Status</th>
- <th>Findings</th>
- <th>Duration</th>
- <th>Error</th>
- </tr>
- </thead>
- <tbody>
- {children.map((child, index) => {
- const stageOrdinal = typeof child.stage_ordinal === "number" ? child.stage_ordinal + 1 : index + 1;
- const modId = typeof child.module_id === "string" ? child.module_id : `step-${index}`;
- const modStatus = typeof child.status === "string" ? child.status : "unknown";
- const findingsCount = typeof child.findings_count === "number" ? child.findings_count : 0;
- const durMs = typeof child.duration_ms === "number" ? child.duration_ms : 0;
- const errText = child.error ? String(child.error) : null;
- return (
- <tr key={`${modId}-${index}`}>
- <td className="muted-cell">#{String(index + 1).padStart(2, "0")}</td>
- <td>
- <span className="badge font-mono text-[11px]">Stage {stageOrdinal}</span>
- </td>
- <td>
- <span className="font-mono text-xs font-semibold text-zinc-100">{modId}</span>
- </td>
- <td>
- <StatusBadge status={modStatus} />
- </td>
- <td>
- <span className={`badge ${findingsCount > 0 ? "badge-info" : ""}`}>{findingsCount}</span>
- </td>
- <td className="font-mono text-xs text-zinc-400">{durMs} ms</td>
- <td>
- {errText ? (
- <span className="text-xs text-rose-400 font-mono" title={errText}>{errText.slice(0, 40)}</span>
- ) : (
- <span className="text-zinc-500 text-xs">—</span>
- )}
- </td>
- </tr>
- );
- })}
- </tbody>
- </table>
- </div>
- </section>
- )}
-
- <section className="panel p-4">
- <div className="flex items-center justify-between">
- <span className="text-xs text-zinc-400">Raw execution output and identity digest:</span>
- <button
- type="button"
- onClick={() => setShowRaw(!showRaw)}
- className="btn btn-compact text-[11px] py-1 px-2.5 text-zinc-400 hover:text-zinc-200 flex items-center gap-1.5"
- >
- <FileText size={12} />
- <span>{showRaw ? "Hide Raw Result" : "View Raw Result"}</span>
- <ChevronDown size={12} className={`transition-transform duration-200 ${showRaw ? "rotate-180" : ""}`} />
- </button>
- </div>
- {showRaw && (
- <div className="mt-3">
- <StructuredJsonViewer data={resultData} title="Raw Engagement Result" maxHeightClass="max-h-80" />
- </div>
- )}
- </section>
- </div>
- );
-}
-
-const VALID_TABS_STRATEGY = ["Objective", "Active", "Result"] as const;
-type StrategyTab = typeof VALID_TABS_STRATEGY[number];
-
-export function StrategyPage() {
- const { user } = useAuth();
- const { selectedCampaignId: campaignId, setSelectedCampaignId: setCampaignId, campaigns: campaignList } = useDashboardUi();
- const active = useQuery({ queryKey: ["strategy-active"], queryFn: api.activeStrategy });
- const [goal, setGoal] = useSessionState("ares.dashboard.strategy.goal", "domain_admin");
- const [llmBackend, setLlmBackend] = useSessionState("ares.dashboard.strategy.llmBackend", "claude");
- const [authorizations, setAuthorizations] = useSessionState("ares.dashboard.strategy.authorizations", "");
- const [lastEngageResult, setLastEngageResult] = useSessionState<PersistedResult | null>("ares.dashboard.strategy.lastEngage", null);
- const [rawTab, setActiveTab] = useTabParam("Objective");
- const activeTab = (VALID_TABS_STRATEGY as readonly string[]).includes(rawTab)
- ? (rawTab as StrategyTab)
- : "Objective";
- const [attemptedSubmit, setAttemptedSubmit] = useState(false);
- const strategyResultKey = `${campaignId}:${goal}:${llmBackend}:${authorizations}`;
- const engage = useMutation({
- mutationFn: () =>
- api.engageStrategy({
- campaign_id: campaignId,
- goal,
- llm_backend: llmBackend,
- max_rounds: 5,
- authorizations: splitLines(authorizations)
- }),
- onSuccess: (payload) => {
- setLastEngageResult({ key: strategyResultKey, payload });
- setActiveTab("Result");
- },
- onError: (error) => {
- setLastEngageResult({ key: strategyResultKey, payload: serializeError(error), isError: true });
- setActiveTab("Result");
- }
- });
- const persistedEngageResult = lastEngageResult?.key === strategyResultKey ? lastEngageResult : null;
- const allowed = user?.role === "team_lead" || user?.role === "operator";
-
- const llmBackends = (active.data?.llm_backends as Record<string, boolean> | undefined);
- const isEngineUnconfigured = llmBackends ? llmBackends[llmBackend] === false : false;
-
- const handleEngage = () => {
- if (!campaignId) {
- setAttemptedSubmit(true);
- return;
- }
- setAttemptedSubmit(false);
- engage.mutate();
- };
-
- return (
- <Page
- title="Strategy"
- actions={<span className={allowed ? "status-pill status-low" : "status-pill status-high"}>{allowed ? "Authorized" : "Restricted"}</span>}
- tabs={["Objective", "Active", "Result"]}
- activeTab={activeTab}
- onTabChange={setActiveTab}
- >
- {activeTab === "Objective" && (
- <section className="panel p-4">
- <SectionHeader title="Objective Builder" />
- <div className="space-y-4">
- <div>
- <label htmlFor="strategy-campaign-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
- Target Campaign
- </label>
- <CampaignPicker
- id="strategy-campaign-select"
- campaigns={campaignList}
- value={campaignId}
- hasError={attemptedSubmit && !campaignId}
- onChange={(id) => {
- setCampaignId(id);
- if (id) {
- setAttemptedSubmit(false);
- }
- }}
- />
- {attemptedSubmit && !campaignId && (
- <p className="mt-1.5 flex items-center gap-1.5 text-xs text-rose-400" role="alert">
- <AlertTriangle size={13} className="shrink-0 text-rose-400" />
- Select a scoped campaign before starting Strategy.
- </p>
- )}
- </div>
-
- <div>
- <label htmlFor="strategy-goal-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
- Strategic Objective
- </label>
- <select
- id="strategy-goal-select"
- className="field"
- value={goal}
- onChange={(e) => setGoal(e.target.value)}
- >
- <option value="domain_admin">Domain Admin (Active Directory)</option>
- <option value="enterprise_admin">Enterprise Admin (Forest Root)</option>
- <option value="cloud_admin">Cloud Admin (Identity Provider)</option>
- <option value="data_exfil">Data Exfiltration</option>
- <option value="persistence">Persistence & Foothold</option>
- <option value="full_compromise">Full Infrastructure Compromise</option>
- </select>
- </div>
-
- <div>
- <label htmlFor="strategy-engine-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
- AI Planning Engine
- </label>
- <select
- id="strategy-engine-select"
- className="field"
- value={llmBackend}
- onChange={(e) => setLlmBackend(e.target.value)}
- >
- <option value="claude">Claude (Anthropic)</option>
- <option value="openai">OpenAI (GPT-4o)</option>
- <option value="local">Local (Ollama)</option>
- </select>
- {isEngineUnconfigured && (
- <p className="mt-1.5 flex items-center gap-1.5 text-xs text-amber-400/90">
- <Info size={13} className="shrink-0 text-amber-400" />
- {llmBackend === "claude"
- ? "Anthropic API key is not configured in the server environment. Configure it on the server or select another engine."
- : llmBackend === "openai"
- ? "OpenAI API key is not configured in the server environment. Configure it on the server or select another engine."
- : "Local Ollama service is not reachable at http://127.0.0.1:11434. Start Ollama or verify server connection."}
- </p>
- )}
- </div>
-
- <div>
- <label htmlFor="strategy-authorizations" className="block text-xs font-medium text-zinc-300 mb-1.5">
- Explicit Authorizations
- </label>
- <textarea
- id="strategy-authorizations"
- className="field min-h-24"
- placeholder="Authorization notes or specific module constraints, one per line"
- value={authorizations}
- onChange={(e) => setAuthorizations(e.target.value)}
- />
- </div>
- </div>
-
- {!allowed && (
- <p className="notice notice-danger mt-3">
- Strategy engagement requires operator or team lead role.
- </p>
- )}
-
- <button
- className="btn btn-primary mt-4"
- disabled={!allowed || engage.isPending}
- onClick={handleEngage}
- >
- {engage.isPending ? (
- <>
- <Loader2 className="spin" size={16} /> Engaging...
- </>
- ) : (
- "Engage Scope"
- )}
- </button>
- </section>
- )}
- {activeTab === "Active" && (
- <section className="grid gap-4">
- {active.error ? (
- <DataPanel title="Active Strategy Error" data={active.error} />
- ) : active.data ? (
- <StrategyActiveView
- activeData={active.data as Record<string, unknown> | undefined}
- goal={goal}
- llmBackend={llmBackend}
- allowed={allowed}
- />
- ) : (
- <EmptyState text="No active strategy state is available yet." />
- )}
- </section>
- )}
- {activeTab === "Result" && (
- <section className="panel p-4">
- {(engage.data ?? engage.error ?? persistedEngageResult?.payload) ? (
- <StrategyResultView
- resultData={engage.data ?? engage.error ?? persistedEngageResult?.payload}
- isError={Boolean(engage.error ?? persistedEngageResult?.isError)}
- />
- ) : (
- <EmptyState text="Engage a strategy objective to see results here." />
- )}
- </section>
- )}
- </Page>
- );
-}
-
-function apiKeyVisibleIdentifier(key: ApiKeyMeta): string {
- const prefix = typeof key.key_prefix === "string" && key.key_prefix
- ? key.key_prefix
- : typeof key.prefix === "string" && key.prefix
- ? key.prefix
- : "";
- return prefix ? `Prefix: ${prefix}` : `ID: ${key.id.slice(0, 12)}`;
-}
-
-function apiKeyOwnerLabel(key: ApiKeyMeta): string {
- const owner = key.owner ?? key.owner_username ?? key.username ?? key.role;
- return typeof owner === "string" && owner.trim() ? owner : "";
-}
-
-function formatDateTime(value: string): string {
- const date = new Date(value);
- return Number.isNaN(date.getTime()) ? value : date.toLocaleString();
-}
-
-function SecurityAuditTable({ auditData, error }: { auditData?: unknown; error?: unknown }) {
- const [sortAsc, setSortAsc] = useState(false);
- const [showRaw, setShowRaw] = useState(false);
-
- const rows = useMemo((): Array<{ id: string; timestamp: string | number; actor: string; action: string; resource: string; status: string }> => {
- if (!auditData) return [];
- if (Array.isArray(auditData)) {
- return auditData.map((item, idx) => {
- const rawTs = (item as Record<string, unknown>).timestamp ?? (item as Record<string, unknown>).created_at;
- const ts: string | number = typeof rawTs === "string" || typeof rawTs === "number" ? rawTs : "";
- return {
- id: String((item as Record<string, unknown>).id ?? idx),
- timestamp: ts,
- actor: String((item as Record<string, unknown>).actor ?? (item as Record<string, unknown>).username ?? "system"),
- action: String((item as Record<string, unknown>).action ?? (item as Record<string, unknown>).event ?? "audit"),
- resource: String((item as Record<string, unknown>).resource ?? (item as Record<string, unknown>).target ?? (item as Record<string, unknown>).detail ?? "—"),
- status: String((item as Record<string, unknown>).status ?? "logged")
- };
- });
- }
- const obj = auditData as Record<string, unknown>;
- if (Array.isArray(obj.events)) {
- return (obj.events as Record<string, unknown>[]).map((item, idx) => {
- const rawTs = item.timestamp ?? item.created_at;
- const ts: string | number = typeof rawTs === "string" || typeof rawTs === "number" ? rawTs : "";
- return {
- id: String(item.id ?? idx),
- timestamp: ts,
- actor: String(item.actor ?? item.username ?? "system"),
- action: String(item.action ?? item.event ?? "audit"),
- resource: String(item.resource ?? item.target ?? item.detail ?? "—"),
- status: String(item.status ?? "logged")
- };
- });
- }
- if (Array.isArray(obj.logs)) {
- return (obj.logs as Record<string, unknown>[]).map((item, idx) => {
- const rawTs = item.timestamp ?? item.created_at;
- const ts: string | number = typeof rawTs === "string" || typeof rawTs === "number" ? rawTs : "";
- return {
- id: String(item.id ?? idx),
- timestamp: ts,
- actor: String(item.actor ?? item.username ?? "system"),
- action: String(item.action ?? item.event ?? "audit"),
- resource: String(item.resource ?? item.target ?? item.detail ?? "—"),
- status: String(item.status ?? "logged")
- };
- });
- }
- if (Array.isArray(obj.vulnerabilities)) {
- const scanTime = typeof obj.scan_timestamp === "number" ? new Date(obj.scan_timestamp * 1000).toISOString() : new Date().toISOString();
- const scanner = String(obj.scanner ?? "pip-audit");
- return (obj.vulnerabilities as Record<string, unknown>[]).map((v, idx) => ({
- id: String(v.vuln_id ?? idx),
- timestamp: scanTime,
- actor: scanner,
- action: String(v.vuln_id ?? "cve_detected"),
- resource: `${String(v.package ?? "")} ${String(v.version ?? "")}`,
- status: String(v.severity ?? "high")
- }));
- }
- return [];
- }, [auditData]);
-
- const sortedRows = useMemo(() => {
- return [...rows].sort((a, b) => {
- const timeA = new Date(a.timestamp || 0).getTime() || 0;
- const timeB = new Date(b.timestamp || 0).getTime() || 0;
- return sortAsc ? timeA - timeB : timeB - timeA;
- });
- }, [rows, sortAsc]);
-
- if (error) {
- return <DataPanel title="Security Audit Error" data={error} />;
- }
-
- return (
- <section className="panel table-panel">
- <SectionHeader
- title="Security Audit Log"
- description="Immutable record of sensitive operations, security scans, and administrative activity."
- action={
- <div className="flex items-center gap-2">
- <button
- type="button"
- onClick={() => setSortAsc(!sortAsc)}
- className="btn btn-compact text-xs flex items-center gap-1.5"
- title="Toggle sort direction by timestamp"
- >
- <ArrowUpDown size={12} />
- <span>{sortAsc ? "Oldest First" : "Newest First"}</span>
- </button>
- <span className="badge">{rows.length} event{rows.length === 1 ? "" : "s"}</span>
- </div>
- }
- />
- {sortedRows.length > 0 ? (
- <div className="table-scroll">
- <table className="table">
- <thead>
- <tr>
- <th
- className="cursor-pointer select-none hover:text-zinc-100"
- onClick={() => setSortAsc(!sortAsc)}
- title="Click to sort by timestamp"
- >
- <div className="flex items-center gap-1">
- <span>Timestamp</span>
- <ArrowUpDown size={12} className="text-zinc-400" />
- </div>
- </th>
- <th>Actor</th>
- <th>Action</th>
- <th>Resource</th>
- <th>Status</th>
- </tr>
- </thead>
- <tbody>
- {sortedRows.map((row) => (
- <tr key={row.id}>
- <td className="font-mono text-xs text-zinc-300 whitespace-nowrap">
- {row.timestamp ? formatDateTime(String(row.timestamp)) : "—"}
- </td>
- <td>
- <span className="font-mono text-xs font-semibold text-zinc-200">{row.actor}</span>
- </td>
- <td>
- <span className="badge font-mono text-[11px]">{row.action}</span>
- </td>
- <td>
- <span className="font-mono text-xs text-zinc-300">{row.resource}</span>
- </td>
- <td>
- <StatusBadge status={row.status} />
- </td>
- </tr>
- ))}
- </tbody>
- </table>
- </div>
- ) : (
- <div className="p-4">
- <EmptyState text="No security audit events recorded yet." />
- </div>
- )}
-
- {Boolean(auditData) && (
- <div className="p-4 border-t border-zinc-800/80">
- <div className="flex items-center justify-between">
- <span className="text-xs text-zinc-400">Underlying telemetry payload:</span>
- <button
- type="button"
- onClick={() => setShowRaw(!showRaw)}
- className="btn btn-compact text-[11px] py-1 px-2.5 text-zinc-400 hover:text-zinc-200 flex items-center gap-1.5"
- >
- <FileText size={12} />
- <span>{showRaw ? "Hide Raw Audit JSON" : "View Raw Audit JSON"}</span>
- <ChevronDown size={12} className={`transition-transform duration-200 ${showRaw ? "rotate-180" : ""}`} />
- </button>
- </div>
- {showRaw && (
- <div className="mt-3">
- <StructuredJsonViewer data={auditData} title="Raw Audit Payload" maxHeightClass="max-h-72" />
- </div>
- )}
- </div>
- )}
- </section>
- );
-}
-
-function SecurityUsersTable({ usersData, error }: { usersData?: unknown; error?: unknown }) {
- const [showRaw, setShowRaw] = useState(false);
- const usersList = Array.isArray(usersData) ? (usersData as Record<string, unknown>[]) : [];
-
- if (error) {
- return <DataPanel title="Users Error" data={error} />;
- }
-
- return (
- <section className="panel table-panel">
- <SectionHeader
- title="Platform Users"
- description="Registered accounts and role-based access control."
- action={<span className="badge">{usersList.length} user{usersList.length === 1 ? "" : "s"}</span>}
- />
- {usersList.length > 0 ? (
- <div className="table-scroll">
- <table className="table">
- <thead>
- <tr>
- <th>Username</th>
- <th>Role</th>
- <th>Last Active</th>
- <th>Status</th>
- </tr>
- </thead>
- <tbody>
- {usersList.map((u, index) => {
- const username = String(u.username ?? `user-${index}`);
- const role = String(u.role ?? "viewer");
- const isActive = u.is_active === true || u.is_active === 1;
- const lastLogin = u.last_login ? formatDateTime(String(u.last_login)) : "Never";
- const roleTone = role === "team_lead" ? "badge badge-high" : role === "operator" ? "badge badge-low" : "badge";
- return (
- <tr key={String(u.id ?? username)}>
- <td>
- <div className="flex items-center gap-2">
- <span className="w-6 h-6 rounded-full bg-zinc-800 text-zinc-300 font-bold text-xs flex items-center justify-center">
- {username.slice(0, 1).toUpperCase()}
- </span>
- <span className="font-semibold text-zinc-100 text-sm">{username}</span>
- </div>
- </td>
- <td>
- <span className={roleTone}>{formatRole(role)}</span>
- </td>
- <td className="text-xs text-zinc-400 font-mono">
- {lastLogin}
- </td>
- <td>
- <span className={`badge ${isActive ? "badge-low" : "badge-high"}`}>
- {isActive ? "Active" : "Disabled"}
- </span>
- </td>
- </tr>
- );
- })}
- </tbody>
- </table>
- </div>
- ) : (
- <div className="p-4">
- <EmptyState text="No user records loaded yet." />
- </div>
- )}
-
- {Boolean(usersData) && (
- <div className="p-4 border-t border-zinc-800/80">
- <div className="flex items-center justify-between">
- <span className="text-xs text-zinc-400">Raw database user records:</span>
- <button
- type="button"
- onClick={() => setShowRaw(!showRaw)}
- className="btn btn-compact text-[11px] py-1 px-2.5 text-zinc-400 hover:text-zinc-200 flex items-center gap-1.5"
- >
- <FileText size={12} />
- <span>{showRaw ? "Hide Raw Users JSON" : "View Raw Users JSON"}</span>
- <ChevronDown size={12} className={`transition-transform duration-200 ${showRaw ? "rotate-180" : ""}`} />
- </button>
- </div>
- {showRaw && (
- <div className="mt-3">
- <StructuredJsonViewer data={usersData} title="Raw User Records" maxHeightClass="max-h-72" />
- </div>
- )}
- </div>
- )}
- </section>
- );
-}
-
-const VALID_TABS_SECURITY = ["Account", "API Keys", "Audit", "Users"] as const;
-type SecurityTab = typeof VALID_TABS_SECURITY[number];
-
-export function SecurityPage() {
- const { user } = useAuth();
- const keys = useQuery({ queryKey: ["api-keys"], queryFn: api.apiKeys });
- const audit = useQuery({ queryKey: ["security-audit"], queryFn: api.securityAudit, enabled: user?.role === "team_lead" });
- const users = useQuery({ queryKey: ["security-users"], queryFn: api.users, enabled: user?.role === "team_lead" });
- const queryClient = useQueryClient();
- const secretKeyInputRef = useRef<HTMLInputElement | null>(null);
- const [currentPassword, setCurrentPassword] = useState("");
- const [newPassword, setNewPassword] = useState("");
- const [confirmPassword, setConfirmPassword] = useState("");
- const [confirmTouched, setConfirmTouched] = useState(false);
- const [keyName, setKeyName] = useState("");
- const [scopes, setScopes] = useState("read");
- const [creatingApiKey, setCreatingApiKey] = useState(false);
- const [generatedApiKey, setGeneratedApiKey] = useState<GeneratedApiKey | null>(null);
- const [apiKeyError, setApiKeyError] = useState<unknown>(null);
- const [copyStatus, setCopyStatus] = useState<ApiKeyCopyStatus>("idle");
- const [deleteTarget, setDeleteTarget] = useState<string | null>(null);
- const [rawTab, setActiveTab] = useTabParam("Account");
- const activeTab = (VALID_TABS_SECURITY as readonly string[]).includes(rawTab)
- ? (rawTab as SecurityTab)
- : "Account";
- const change = useMutation({
- mutationFn: () => api.changePassword({ current_password: currentPassword, new_password: newPassword }),
- onSuccess: () => {
- setCurrentPassword("");
- setNewPassword("");
- setConfirmPassword("");
- setConfirmTouched(false);
- }
- });
- const remove = useMutation({
- mutationFn: (id: string) => api.deleteApiKey(id),
- onSuccess: () => {
- void queryClient.invalidateQueries({ queryKey: ["api-keys"] });
- }
- });
-
- useEffect(() => {
- if (generatedApiKey) {
- secretKeyInputRef.current?.focus();
- }
- }, [generatedApiKey]);
-
- async function handleCreateApiKey(event: FormEvent<HTMLFormElement>): Promise<void> {
- event.preventDefault();
- if (!event.currentTarget.reportValidity()) return;
- setApiKeyError(null);
- setGeneratedApiKey(null);
- setCopyStatus("idle");
- setCreatingApiKey(true);
- try {
- const response = await api.createApiKey({ name: keyName, scopes });
- if (!response.key) {
- throw new Error("API key created, but the secret was not returned by the API.");
- }
- setGeneratedApiKey({
- id: response.id,
- key: response.key,
- note: response.note,
- prefix: response.prefix ?? response.key_prefix
- });
- setKeyName("");
- void queryClient.invalidateQueries({ queryKey: ["api-keys"] });
- } catch (error) {
- setApiKeyError(error);
- } finally {
- setCreatingApiKey(false);
- }
- }
-
- async function copyGeneratedKey(): Promise<void> {
- if (!generatedApiKey?.key) return;
-
- let copied = false;
- if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
- try {
- await navigator.clipboard.writeText(generatedApiKey.key);
- copied = true;
- } catch {
- copied = false;
- }
- }
-
- if (!copied && secretKeyInputRef.current) {
- secretKeyInputRef.current.focus();
- secretKeyInputRef.current.select();
- try {
- copied = document.execCommand("copy");
- } catch {
- copied = false;
- }
- }
-
- setCopyStatus(copied ? "copied" : "manual");
- }
-
- function closeGeneratedKeyModal(): void {
- setGeneratedApiKey(null);
- setCopyStatus("idle");
- }
-
- return (
- <Page
- title="Security"
- actions={<span className="status-pill">{formatRole(user?.role)}</span>}
- tabs={["Account", "API Keys", "Audit", "Users"]}
- activeTab={activeTab}
- onTabChange={setActiveTab}
- >
- {activeTab === "Account" && (
- <section className="panel p-4">
- <SectionHeader title="Account" />
- <div className="profile-row mb-3">
- <span className="profile-avatar-light">{user?.username?.slice(0, 1).toUpperCase() ?? "A"}</span>
- <div>
- <div className="font-semibold text-zinc-100">{user?.username}</div>
- <div className="text-xs text-zinc-400">{formatRole(user?.role)}</div>
- </div>
- </div>
- <form className="grid gap-2" onSubmit={(event) => {
- event.preventDefault();
- if (!event.currentTarget.reportValidity()) return;
- if (newPassword !== confirmPassword) return;
- change.mutate();
- }}>
- <input className="field" required type="password" placeholder="Current password" value={currentPassword} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setCurrentPassword(e.target.value); }} />
- <input className="field" required minLength={12} type="password" placeholder="New password" value={newPassword} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setNewPassword(e.target.value); }} />
- <div>
- <input
- className={`field ${confirmTouched && confirmPassword !== "" && newPassword !== confirmPassword ? "border-rose-500/70 focus:border-rose-500" : ""}`}
- required
- minLength={12}
- type="password"
- placeholder="Confirm new password"
- value={confirmPassword}
- onInvalid={setRequiredMessage}
- onBlur={() => setConfirmTouched(true)}
- onChange={(e) => {
- clearValidationMessage(e);
- setConfirmTouched(true);
- setConfirmPassword(e.target.value);
- }}
- />
- {confirmTouched && confirmPassword !== "" && newPassword !== confirmPassword && (
- <p className="mt-1.5 flex items-center gap-1.5 text-xs text-rose-400" role="alert">
- <AlertTriangle size={13} className="shrink-0 text-rose-400" />
- Passwords do not match
- </p>
- )}
- </div>
- <button
- className="btn"
- disabled={
- change.isPending ||
- !currentPassword.trim() ||
- !newPassword ||
- !confirmPassword ||
- newPassword !== confirmPassword
- }
- type="submit"
- >
- {change.isPending && <Loader2 className="spin" size={16} />}
- Change Password
- </button>
- </form>
- <DataPanel title="Password Result" data={change.data ?? change.error} />
- </section>
- )}
- {activeTab === "API Keys" && (
- <section className="panel p-4">
- <SectionHeader
- title="API Keys"
- action={<span className="badge">{keys.data?.length ?? 0} active</span>}
- description="Metadata only; new secrets are shown once."
- />
- <form className="mb-3 grid gap-2 sm:grid-cols-[1fr_120px_auto]" onSubmit={(event) => void handleCreateApiKey(event)}>
- <input className="field" required placeholder="Name" value={keyName} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setKeyName(e.target.value); }} />
- <select className="field" value={scopes} onChange={(e) => setScopes(e.target.value)}>
- <option value="read">read</option>
- <option value="write">write</option>
- <option value="admin">admin</option>
- </select>
- <button className="btn" disabled={creatingApiKey} type="submit">
- {creatingApiKey && <Loader2 className="spin" size={16} />}
- Create
- </button>
- </form>
- {(keys.data ?? []).map((key) => (
- <div className="key-row" key={key.id}>
- <div className="min-w-0">
- <div className="font-semibold text-zinc-100">{key.name ?? "Unnamed API key"}</div>
- <div className="mt-1 flex flex-wrap gap-2 text-xs font-semibold text-zinc-400">
- <span className="font-mono">{apiKeyVisibleIdentifier(key)}</span>
- {key.scopes ? <span className="badge">Scope: {key.scopes}</span> : null}
- {apiKeyOwnerLabel(key) ? <span>Owner: {apiKeyOwnerLabel(key)}</span> : null}
- </div>
- <div className="mt-1 flex flex-wrap gap-2 text-xs text-zinc-400">
- {key.created_at ? <span>Created: {formatDateTime(key.created_at)}</span> : null}
- {key.expires_at ? <span>Expires: {formatDateTime(key.expires_at)}</span> : <span>No expiry</span>}
- </div>
- </div>
- <button className="btn btn-danger" disabled={remove.isPending} onClick={() => setDeleteTarget(key.id)} type="button">Delete</button>
- </div>
- ))}
- {(keys.data ?? []).length === 0 && <EmptyState text="No API keys yet." />}
- <DataPanel title="API Key Error" data={apiKeyError ?? remove.error ?? keys.error} />
- </section>
- )}
- {activeTab === "Audit" && (
- <section className="grid gap-4">
- {user?.role === "team_lead" ? (
- <SecurityAuditTable auditData={audit.data} error={audit.error} />
- ) : (
- <EmptyState text="Audit data is available to team leads." />
- )}
- </section>
- )}
- {activeTab === "Users" && (
- <section className="grid gap-4">
- {user?.role === "team_lead" ? (
- <SecurityUsersTable usersData={users.data} error={users.error} />
- ) : (
- <EmptyState text="User management is available to team leads." />
- )}
- </section>
- )}
- {generatedApiKey && (
- <div className="fixed inset-0 z-50 flex items-center justify-center bg-slate-950/60 p-4">
- <section
- aria-labelledby="api-key-dialog-title"
- aria-modal="true"
- className="panel w-full max-w-2xl p-5 shadow-2xl"
- role="dialog"
- >
- <div className="mb-4 flex flex-wrap items-start justify-between gap-3">
- <div>
- <h2 className="text-lg font-bold text-zinc-100" id="api-key-dialog-title">Save your key</h2>
- <p className="mt-1 text-sm text-zinc-400">Copy this secret key now and store it somewhere safe.</p>
- </div>
- {generatedApiKey.prefix ? <span className="badge font-mono">{generatedApiKey.prefix}</span> : null}
- </div>
- <p className="mb-4 rounded-md border border-amber-500/30 bg-amber-500/10 p-3 text-sm font-semibold text-amber-200">
- This secret key is shown only once. After you close this dialog, ARES will not show the full key again.
- </p>
- <div className="block">
- <label htmlFor="generated-api-key-secret" className="block text-sm font-semibold text-zinc-300 mb-1 cursor-pointer">
- Secret key
- </label>
- <div className="mt-2 grid gap-2 sm:grid-cols-[1fr_auto]">
- <input
- id="generated-api-key-secret"
- aria-label="Generated API key secret"
- className="field font-mono text-sm"
- onFocus={(event) => event.currentTarget.select()}
- readOnly
- ref={secretKeyInputRef}
- value={generatedApiKey.key}
- />
- <button className="btn" onClick={() => void copyGeneratedKey()} type="button">
- {copyStatus === "copied" ? <CheckCircle2 size={16} /> : <Copy size={16} />}
- {copyStatus === "copied" ? "Copied" : "Copy"}
- </button>
- </div>
- </div>
- {copyStatus === "manual" && (
- <p className="mt-2 rounded-md border border-zinc-700 bg-zinc-900 p-3 text-sm text-zinc-300">
- Clipboard access was blocked. The key field is selected; press Ctrl+C to copy it manually.
- </p>
- )}
- {generatedApiKey.note ? <p className="mt-3 text-sm text-zinc-400">{generatedApiKey.note}</p> : null}
- <div className="mt-5 flex justify-end">
- <button className="btn btn-primary" onClick={closeGeneratedKeyModal} type="button">Done</button>
- </div>
- </section>
- </div>
- )}
- <ConfirmModal
- open={deleteTarget !== null}
- title="Delete API Key"
- description="This action cannot be undone. All integrations using this key will immediately lose access."
- confirmLabel="Delete API Key"
- cancelLabel="Cancel"
- variant="danger"
- onConfirm={() => {
- if (deleteTarget) {
- remove.mutate(deleteTarget);
- setDeleteTarget(null);
- }
- }}
- onCancel={() => setDeleteTarget(null)}
- />
- </Page>
- );
-}
-
-function EdrStatsSummary({
- statsData,
- error
-}: {
- statsData?: Record<string, unknown>;
- error?: unknown;
-}) {
- const [showRaw, setShowRaw] = useState(false);
- const technique = typeof statsData?.technique_id === "string" && statsData.technique_id ? statsData.technique_id : "All Techniques";
- const vendor = typeof statsData?.edr_vendor === "string" && statsData.edr_vendor ? statsData.edr_vendor : "All Vendors";
- const rate = typeof statsData?.success_rate === "number" ? statsData.success_rate : null;
- const message = typeof statsData?.message === "string" ? statsData.message : "Historical bypass knowledge base telemetry.";
- const statsList = Array.isArray(statsData?.stats) ? (statsData.stats as Record<string, unknown>[]) : [];
-
- const rateTone = rate != null ? (rate >= 0.8 ? "badge badge-low" : rate >= 0.5 ? "badge badge-medium" : "badge badge-high") : "badge";
- const rateLabel = rate != null ? `${(rate * 100).toFixed(0)}%` : "N/A";
- const evasionAssessment = rate != null ? (rate >= 0.8 ? "High Evasion" : rate >= 0.5 ? "Moderate Evasion" : "High Detection Risk") : "Insufficient Samples";
-
- return (
- <div className="grid gap-4">
- {error ? (
- <DataPanel title="Stats Error" data={error} />
- ) : (
- <>
- <section className="panel p-4">
- <SectionHeader
- title="Bypass Knowledge Base"
- description="Historical evasion success metrics calibrated against active endpoint detection agents."
- action={<span className={rateTone}>{evasionAssessment}</span>}
- />
- <div className="mini-stat-grid mt-3">
- <MiniStat
- title="Technique Under Test"
- value={technique}
- detail="MITRE / ARES technique ID"
- />
- <MiniStat
- title="Target EDR Vendor"
- value={vendor}
- detail="Security agent signature"
- />
- <MiniStat
- title="Historical Bypass Rate"
- value={rateLabel}
- detail={rate != null ? `${evasionAssessment} probability` : "Min 3 samples required"}
- />
- <MiniStat
- title="Telemetry Status"
- value={rate != null ? "Calibrated" : "Sampling"}
- detail={rate != null ? "Statistically valid" : "Pending further reports"}
- />
- </div>
- <div className="mt-3 p-3 rounded border border-zinc-800 bg-zinc-900/60 text-xs text-zinc-300 flex items-center gap-2">
- <ShieldCheck size={14} className="text-cyan-400 shrink-0" />
- <span>{message}</span>
- </div>
- </section>
-
- {statsList.length > 0 && (
- <section className="panel table-panel">
- <SectionHeader
- title="Historical Technique Records"
- action={<span className="badge">{statsList.length} records</span>}
- />
- <div className="table-scroll">
- <table className="table">
- <thead>
- <tr>
- <th>Technique</th>
- <th>EDR Vendor</th>
- <th>Success Rate</th>
- <th>Samples</th>
- </tr>
- </thead>
- <tbody>
- {statsList.map((item, index) => {
- const t = String(item.technique_id ?? `technique-${index}`);
- const v = String(item.edr_vendor ?? "all");
- const r = typeof item.success_rate === "number" ? item.success_rate : null;
- const count = typeof item.sample_count === "number" ? item.sample_count : (item.count ?? "—");
- return (
- <tr key={`${t}-${v}-${index}`}>
- <td className="font-mono text-xs font-semibold text-zinc-200">{t}</td>
- <td>
- <span className="badge font-mono text-[11px]">{v}</span>
- </td>
- <td>
- <span className={r != null ? (r >= 0.8 ? "badge badge-low" : r >= 0.5 ? "badge badge-medium" : "badge badge-high") : "badge"}>
- {r != null ? `${(r * 100).toFixed(0)}%` : "N/A"}
- </span>
- </td>
- <td className="font-mono text-xs text-zinc-400">{String(count)}</td>
- </tr>
- );
- })}
- </tbody>
- </table>
- </div>
- </section>
- )}
-
- {statsData && (
- <section className="panel p-4">
- <div className="flex items-center justify-between">
- <span className="text-xs text-zinc-400">Raw telemetry dataset:</span>
- <button
- type="button"
- onClick={() => setShowRaw(!showRaw)}
- className="btn btn-compact text-[11px] py-1 px-2.5 text-zinc-400 hover:text-zinc-200 flex items-center gap-1.5"
- >
- <FileText size={12} />
- <span>{showRaw ? "Hide Raw Stats JSON" : "View Raw Stats JSON"}</span>
- <ChevronDown size={12} className={`transition-transform duration-200 ${showRaw ? "rotate-180" : ""}`} />
- </button>
- </div>
- {showRaw && (
- <div className="mt-3">
- <StructuredJsonViewer data={statsData} title="Raw EDR Bypass Stats" maxHeightClass="max-h-72" />
- </div>
- )}
- </section>
- )}
- </>
- )}
- </div>
- );
-}
-
-const VALID_TABS_EDR = ["Knowledge Base", "Report Outcome", "Stats"] as const;
-type EdrTab = typeof VALID_TABS_EDR[number];
-
-export function EdrPage() {
- const stats = useQuery({ queryKey: ["edr-stats"], queryFn: api.edrStats });
- const [techniqueId, setTechniqueId] = useSessionState("ares.dashboard.edr.techniqueId", "");
- const [vendor, setVendor] = useSessionState("ares.dashboard.edr.vendor", "");
- const [version, setVersion] = useSessionState("ares.dashboard.edr.version", "");
- const [success, setSuccess] = useSessionState("ares.dashboard.edr.success", false);
- const [notes, setNotes] = useSessionState("ares.dashboard.edr.notes", "");
- const [lastReportResult, setLastReportResult] = useSessionState<PersistedResult | null>("ares.dashboard.edr.lastReport", null);
- const [rawTab, setActiveTab] = useTabParam("Knowledge Base");
- const activeTab = (VALID_TABS_EDR as readonly string[]).includes(rawTab)
- ? (rawTab as EdrTab)
- : "Knowledge Base";
- const edrReportKey = `${techniqueId.trim()}:${vendor.trim()}:${version.trim()}:${success}:${notes.trim()}`;
- const report = useMutation({
- mutationFn: () =>
- api.reportBypass({
- technique_id: techniqueId.trim(),
- edr_vendor: vendor.trim(),
- edr_version: version.trim(),
- success,
- notes: notes.trim()
- }),
- onSuccess: (payload) => setLastReportResult({ key: edrReportKey, payload }),
- onError: (error) => setLastReportResult({ key: edrReportKey, payload: serializeError(error), isError: true })
- });
- const persistedReportResult = lastReportResult?.key === edrReportKey ? lastReportResult : null;
- return (
- <Page
- title="EDR/OPSEC"
- actions={<span className={success ? "status-pill status-low" : "status-pill status-medium"}>{success ? "Successful" : "Blocked / detected"}</span>}
- tabs={["Knowledge Base", "Report Outcome"]}
- activeTab={activeTab === "Stats" ? "Knowledge Base" : activeTab}
- onTabChange={setActiveTab}
- >
- {(activeTab === "Knowledge Base" || (activeTab as string) === "Stats") && (
- <EdrStatsSummary statsData={stats.data as Record<string, unknown> | undefined} error={stats.error} />
- )}
- {activeTab === "Report Outcome" && (
- <>
- <section className="panel p-4">
- <SectionHeader title="Report Outcome" />
- <form className="grid gap-3" onSubmit={(event) => {
- event.preventDefault();
- if (!event.currentTarget.reportValidity()) return;
- report.mutate();
- }}>
- <div className="grid gap-3 md:grid-cols-2">
- <div className="block">
- <label htmlFor="edr-technique-id" className="block text-sm font-semibold mb-1 cursor-pointer">
- Technique ID <span className="text-red-700">*</span>
- </label>
- <input id="edr-technique-id" className="field" required autoComplete="off" spellCheck={false} placeholder="edr.bypass_adaptive / amsi-patch-reflection" value={techniqueId} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setTechniqueId(e.target.value); }} />
- </div>
- <div className="block">
- <label htmlFor="edr-vendor-name" className="block text-sm font-semibold mb-1 cursor-pointer">
- EDR vendor <span className="text-red-700">*</span>
- </label>
- <input id="edr-vendor-name" className="field" required autoComplete="off" spellCheck={false} placeholder="crowdstrike, defender_atp, sentinelone" value={vendor} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setVendor(e.target.value); }} />
- </div>
- <div className="block">
- <label htmlFor="edr-version-field" className="block text-sm font-semibold mb-1 cursor-pointer">
- EDR version
- </label>
- <input id="edr-version-field" className="field" autoComplete="off" spellCheck={false} placeholder="optional" value={version} onChange={(e) => setVersion(e.target.value)} />
- </div>
- <div className="block">
- <label htmlFor="edr-outcome-field" className="block text-sm font-semibold mb-1 cursor-pointer">
- Outcome
- </label>
- <select id="edr-outcome-field" className="field" value={success ? "success" : "blocked"} onChange={(e) => setSuccess(e.target.value === "success")}>
- <option value="blocked">Blocked / detected</option>
- <option value="success">Successful</option>
- </select>
- </div>
- </div>
- <div className="block">
- <label htmlFor="edr-notes-field" className="block text-sm font-semibold mb-1 cursor-pointer">
- Notes
- </label>
- <textarea id="edr-notes-field" className="field min-h-24" autoComplete="off" spellCheck={false} placeholder="Signal observed, lab context, or detection notes" value={notes} onChange={(e) => setNotes(e.target.value)} />
- </div>
- <button className="btn btn-primary" disabled={report.isPending} type="submit">
- {report.isPending ? (
- <>
- <Loader2 className="spin" size={16} /> Saving...
- </>
- ) : (
- "Report Outcome"
- )}
- </button>
- </form>
- </section>
- <DataPanel
- title={(report.error ?? (persistedReportResult?.isError ? persistedReportResult.payload : undefined)) ? "Outcome Error" : "Outcome Result"}
- data={report.data ?? report.error ?? persistedReportResult?.payload}
- />
- </>
- )}
- </Page>
- );
-}
-
-const VALID_TABS_LIVE = ["Stream", "Buffer"] as const;
-type LiveTab = typeof VALID_TABS_LIVE[number];
-
-export function LivePage() {
- const {
- selectedCampaignId,
- setSelectedCampaignId,
- liveCampaignId,
- setLiveCampaignId,
- liveConnected,
- setLiveConnected,
- liveEvents,
- clearLiveEvents,
- campaigns: campaignList
- } = useDashboardUi();
- const campaignId = liveCampaignId || selectedCampaignId;
- const [rawTab, setActiveTab] = useTabParam("Stream");
- const activeTab = (VALID_TABS_LIVE as readonly string[]).includes(rawTab)
- ? (rawTab as LiveTab)
- : "Stream";
- const [bufferViewScope, setBufferViewScope] = useState<"session" | "all">("session");
-
- const currentCampaign = useMemo(() => {
- return campaignList.find((c) => c.id === campaignId);
- }, [campaignList, campaignId]);
-
- // Session-isolated events for active campaign
- const sessionEvents = useMemo(() => {
- if (!campaignId) return [];
- return liveEvents.filter((event) => {
- const record = event && typeof event === "object" ? (event as Record<string, unknown>) : null;
- return record?.campaign_id === campaignId;
- });
- }, [liveEvents, campaignId]);
-
- // Stream uses campaign session events if a campaign is chosen, or global events if viewing all
- const scopedEvents = useMemo(() => {
- return campaignId ? sessionEvents : liveEvents;
- }, [campaignId, sessionEvents, liveEvents]);
-
- const streamEvents = useMemo(() => scopedEvents.slice(0, 10), [scopedEvents]);
-
- const displayedBufferEvents = useMemo(() => {
- if (!campaignId || bufferViewScope === "all") {
- return liveEvents;
- }
- return sessionEvents;
- }, [campaignId, bufferViewScope, liveEvents, sessionEvents]);
-
- return (
- <Page
- title="Live Events"
- actions={<span className={liveConnected ? "status-pill status-low" : "status-pill"}>{liveConnected ? "Listening" : "Offline"}</span>}
- tabs={["Stream", "Buffer"]}
- activeTab={activeTab}
- onTabChange={setActiveTab}
- >
- {activeTab === "Stream" && (
- <>
- <div className="panel p-4">
- <SectionHeader
- title="Campaign Event Stream"
- action={<span className="badge">{scopedEvents.length} buffered</span>}
- description="Watch selected campaign events."
- />
- <CampaignPicker
- campaigns={campaignList}
- value={campaignId}
- onChange={(id) => {
- setLiveCampaignId(id);
- setSelectedCampaignId(id);
- if (!id && liveConnected) {
- setLiveConnected(false);
- }
- }}
- />
- <div className="mt-3 flex flex-wrap items-center gap-2">
- <button className="btn btn-primary" disabled={!campaignId || liveConnected} onClick={() => {
- if (!liveCampaignId && campaignId) {
- setLiveCampaignId(campaignId);
- }
- setLiveConnected(true);
- }}>
- {liveConnected ? "Connected" : "Connect Stream"}
- </button>
- {liveConnected && (
- <button className="btn" onClick={() => setLiveConnected(false)}>
- Disconnect
- </button>
- )}
- <span className={liveConnected ? "badge badge-low" : "badge"}>{liveConnected ? "listening" : "offline"}</span>
- </div>
- </div>
- <section className="panel p-4">
- <SectionHeader
- title="Current Stream"
- action={
- <div className="flex items-center gap-2">
- <span className="badge">{streamEvents.length} newest</span>
- {streamEvents.length > 0 && (
- <button
- className="btn"
- onClick={() => {
- if (campaignId) {
- clearLiveEvents(campaignId);
- } else {
- clearLiveEvents();
- }
- }}
- >
- Clear Stream
- </button>
- )}
- </div>
- }
- />
- {streamEvents.length > 0 ? (
- <div className="grid gap-2">
- {streamEvents.map((event, index) => (
- <LiveEventCard
- event={event}
- index={index}
- key={(event as any)?.id || `${(event as any)?.timestamp || index}-${index}`}
- campaigns={campaignList}
- />
- ))}
- </div>
- ) : (
- <EmptyState
- text={
- !campaignId
- ? "Select a campaign session to stream events, or view global buffer."
- : liveConnected
- ? `Connected to session '${currentCampaign?.name || campaignId}'. Waiting for incoming events...`
- : `Session ready for '${currentCampaign?.name || campaignId}'. Click 'Connect Stream' to begin monitoring.`
- }
- />
- )}
- </section>
- </>
- )}
- {activeTab === "Buffer" && (
- <section className="panel p-4">
- <SectionHeader
- title="Buffered Events"
- action={
- <div className="flex items-center gap-2">
- {campaignId && (
- <div className="flex items-center gap-1 rounded bg-zinc-900/80 p-0.5 border border-zinc-800 text-xs">
- <button
- type="button"
- className={`px-2 py-0.5 rounded transition ${bufferViewScope === "session" ? "bg-zinc-800 text-zinc-100 font-medium" : "text-zinc-400 hover:text-zinc-200"}`}
- onClick={() => setBufferViewScope("session")}
- >
- Active Session ({sessionEvents.length})
- </button>
- <button
- type="button"
- className={`px-2 py-0.5 rounded transition ${bufferViewScope === "all" ? "bg-zinc-800 text-zinc-100 font-medium" : "text-zinc-400 hover:text-zinc-200"}`}
- onClick={() => setBufferViewScope("all")}
- >
- All Sessions ({liveEvents.length})
- </button>
- </div>
- )}
- {displayedBufferEvents.length > 0 ? (
- <button
- className="btn"
- onClick={() => {
- if (campaignId && bufferViewScope === "session") {
- clearLiveEvents(campaignId);
- } else {
- clearLiveEvents();
- }
- }}
- >
- {campaignId && bufferViewScope === "session" ? "Clear Session Events" : "Clear All Events"}
- </button>
- ) : (
- <span className="badge">0 retained</span>
- )}
- </div>
- }
- />
- {displayedBufferEvents.length > 0 ? (
- <div className="grid gap-2">
- {displayedBufferEvents.map((event, index) => (
- <LiveEventCard
- event={event}
- index={index}
- key={(event as any)?.id || `${(event as any)?.timestamp || index}-${index}`}
- campaigns={campaignList}
- />
- ))}
- </div>
- ) : (
- <EmptyState
- text={
- campaignId && bufferViewScope === "session"
- ? `No events retained for session '${currentCampaign?.name || campaignId}'.`
- : "No events retained in the buffer."
- }
- />
- )}
- </section>
- )}
- </Page>
- );
-}
-
-function Page({
- title,
- subtitle,
- actions,
- tabs,
- activeTab,
- onTabChange,
- children
-}: {
- title: string;
- subtitle?: ReactNode;
- actions?: ReactNode;
- tabs?: string[];
- activeTab?: string;
- onTabChange?: (tab: string) => void;
- children: ReactNode;
-}) {
- const [fallbackTab, setFallbackTab] = useState(tabs?.[0] ?? "");
- const meta = pageMeta[title] ?? {
- eyebrow: "ARES",
- description: "Security dashboard workspace."
- };
- const selectedTab = activeTab ?? fallbackTab;
- const setTab = useCallback((tab: string) => {
- if (onTabChange) {
- onTabChange(tab);
- } else {
- setFallbackTab(tab);
- }
- }, [onTabChange]);
-
- function handleTabKeyDown(event: KeyboardEvent<HTMLDivElement>) {
- if (!tabs || tabs.length === 0 || !["ArrowLeft", "ArrowRight", "Home", "End"].includes(event.key)) {
- return;
- }
- event.preventDefault();
- const currentIndex = Math.max(0, tabs.indexOf(selectedTab));
- if (event.key === "Home") {
- setTab(tabs[0]);
- return;
- }
- if (event.key === "End") {
- setTab(tabs[tabs.length - 1]);
- return;
- }
- const offset = event.key === "ArrowRight" ? 1 : -1;
- const nextIndex = (currentIndex + offset + tabs.length) % tabs.length;
- setTab(tabs[nextIndex]);
- }
-
- return (
- <div className="page">
- <section className="page-header">
- <div className="page-heading">
- <div>
- <p className="page-eyebrow">{meta.eyebrow}</p>
- <h1>{title}</h1>
- <p className="page-subtitle">{subtitle ?? meta.description}</p>
- </div>
- </div>
- {actions ? <div className="page-actions">{actions}</div> : null}
- </section>
- {tabs ? (
- <div className="page-tabs" aria-label={`${title} sections`} onKeyDown={handleTabKeyDown} role="tablist">
- {tabs.map((tab) => (
- <button
- aria-selected={tab === selectedTab}
- className={tab === selectedTab ? "active" : ""}
- key={tab}
- onClick={() => setTab(tab)}
- role="tab"
- tabIndex={tab === selectedTab ? 0 : -1}
- type="button"
- >
- {tab}
- </button>
- ))}
- </div>
- ) : null}
- <div className="page-content">{children}</div>
- </div>
- );
-}
-
-function SectionHeader({
- title,
- eyebrow,
- description,
- action
-}: {
- title: string;
- eyebrow?: string;
- description?: string;
- action?: ReactNode;
-}) {
- return (
- <div className="section-header">
- <div>
- {eyebrow ? <p className="section-eyebrow">{eyebrow}</p> : null}
- <h2>{title}</h2>
- {description ? <p>{description}</p> : null}
- </div>
- {action ? <div className="section-action">{action}</div> : null}
- </div>
- );
-}
-
-function MiniStat({ title, value, detail, icon }: { title: string; value: string; detail?: string; icon?: ReactNode }) {
- return (
- <div className="mini-stat">
- <div>
- <span>{title}</span>
- <strong>{value}</strong>
- {detail ? <small>{detail}</small> : null}
- </div>
- {icon ? <div className="mini-stat-icon">{icon}</div> : null}
- </div>
- );
-}
-
-function HighlightRow({
- label,
- value,
- detail,
- tone = "neutral"
-}: {
- label: string;
- value: string;
- detail: string;
- tone?: "low" | "medium" | "high" | "neutral";
-}) {
- return (
- <div className="highlight-row">
- <div>
- <strong>{label}</strong>
- <span>{detail}</span>
- </div>
- <span className={`highlight-value highlight-${tone}`}>{value}</span>
- </div>
- );
-}
-
-function SparklineBars({ values }: { values: MonthlyFindingStats["series"] }) {
- const max = Math.max(...values.map((value) => value.count), 1);
- const labelDays = new Set([1, 7, 14, 21, 28, values.length]);
- return (
- <>
- <div className="sparkline" aria-hidden="true">
- {values.map((value) => (
- <span
- key={value.date}
- title={`${formatMonthlyDate(value.date)} - ${value.count} ${value.count === 1 ? "security signal" : "security signals"}`}
- style={{ height: value.count > 0 ? `${Math.max(6, (value.count / max) * 100)}%` : "0%" }}
- />
- ))}
- </div>
- <div className="sparkline-axis" aria-hidden="true">
- {values.map((value) => {
- const day = Number(value.date.slice(-2));
- return <span key={value.date}>{labelDays.has(day) ? formatMonthlyDate(value.date) : null}</span>;
- })}
- </div>
- </>
- );
-}
-
-function formatMonthlyDate(date: string): string {
- const [year, month, day] = date.split("-").map(Number);
- return new Intl.DateTimeFormat("en-GB", { day: "numeric", month: "short", timeZone: "UTC" }).format(
- new Date(Date.UTC(year, month - 1, day))
- );
-}
-
-function metricNumber(map: TelemetryMetricMap | undefined, key: string): number {
- return metricNumberOrNull(map, key) ?? 0;
-}
-
-function metricNumberOrNull(map: TelemetryMetricMap | undefined, key: string): number | null {
- const value = map?.[key];
- if (typeof value === "number" && Number.isFinite(value)) return value;
- if (typeof value === "string" && value.trim()) {
- const parsed = Number(value);
- return Number.isFinite(parsed) ? parsed : null;
- }
- return null;
-}
-
-function formatMetric(value: number, suffix = ""): string {
- if (!Number.isFinite(value)) return `0${suffix}`;
- if (Number.isInteger(value)) return `${value}${suffix}`;
- return `${value.toFixed(1)}${suffix}`;
-}
-
-function formatRate(value: unknown): string {
- if (typeof value !== "number" || !Number.isFinite(value)) {
- return "not enough data";
- }
- const normalized = value <= 1 ? value * 100 : value;
- return `${Math.round(normalized)}%`;
-}
-
-function formatTimestamp(value: number | undefined): string {
- if (!value) return "No runtime sample yet";
- const ms = value > 1e11 ? value : value * 1000;
- return new Date(ms).toLocaleString();
-}
-
-function formatBytes(value: number): string {
- if (!Number.isFinite(value)) return "n/a";
- if (value < 1024) return `${value} B`;
- const units = ["KB", "MB", "GB", "TB"];
- let size = value / 1024;
- let unitIndex = 0;
- while (size >= 1024 && unitIndex < units.length - 1) {
- size /= 1024;
- unitIndex += 1;
- }
- return `${size >= 10 ? size.toFixed(0) : size.toFixed(1)} ${units[unitIndex]}`;
-}
-
-function formatReportDate(value: number): string {
- if (!Number.isFinite(value)) return "n/a";
- const timestamp = value > 10_000_000_000 ? value : value * 1000;
- return new Date(timestamp).toLocaleString();
-}
-
-function formatReportTime(value: number): string {
- if (!Number.isFinite(value)) return "n/a";
- const timestamp = value > 10_000_000_000 ? value : value * 1000;
- return new Date(timestamp).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit", second: "2-digit" });
-}
-
-function TelemetryPanel({ snapshot, loading, confirmedFindings }: { snapshot?: TelemetrySnapshot; loading: boolean; confirmedFindings: number }) {
- const total = metricNumber(snapshot?.modules, "total");
- const success = metricNumber(snapshot?.modules, "success");
- const failed = metricNumber(snapshot?.modules, "failed");
- const findings = confirmedFindings;
- const successRate = total > 0 ? Math.round((success / total) * 100) : null;
- const errorRate = total > 0 ? Math.min(100, Math.round(metricNumber(snapshot?.modules, "error_rate") * 100)) : null;
- const p95 = metricNumberOrNull(snapshot?.latency_ms, "p95");
- const queueDepth = metricNumber(snapshot?.queue, "depth");
- const activeWorkers = metricNumber(snapshot?.workers, "active");
- const unhealthyWorkers = metricNumber(snapshot?.workers, "unhealthy");
- const hostsDiscovered = metricNumber(snapshot?.hosts, "discovered");
- const hostsOwned = metricNumberOrNull(snapshot?.hosts, "owned");
- const tasksPerMin = metricNumberOrNull(snapshot?.throughput, "tasks_per_min");
- const workerTotal = activeWorkers + unhealthyWorkers;
- const workerCapacity = workerTotal > 0 ? Math.round((activeWorkers / workerTotal) * 100) : null;
- const hostsAvailable = snapshot?.hosts?.available === true;
- const hostOwnership = hostsAvailable && hostsDiscovered > 0 && hostsOwned !== null
- ? Math.round((hostsOwned / hostsDiscovered) * 100)
- : null;
- const throughputValue = tasksPerMin === null ? "n/a" : `${formatMetric(tasksPerMin)}/min`;
- const latencyDetail = p95 === null ? "no run timing data" : `${formatMetric(p95, " ms")} p95`;
-
- const isIngestionActive = Boolean(snapshot && snapshot.timestamp);
- const ingestionDotClass = loading ? "pending" : isIngestionActive ? "active" : "pending";
- const ingestionText = loading ? "Connecting..." : isIngestionActive ? "Ingestion Active" : "Awaiting Data";
-
- return (
- <section className="panel telemetry-panel">
- <SectionHeader
- title="Telemetry Report"
- description={loading ? "Waiting for metrics." : `Last sample: ${formatTimestamp(snapshot?.timestamp)}`}
- action={
- <div className="telemetry-live-status" title="Real-time telemetry ingestion pipeline">
- <span className={`status-indicator-dot ${ingestionDotClass}`} />
- <span className="status-indicator-text">{ingestionText}</span>
- {snapshot?.timestamp ? (
- <span className="status-indicator-time font-mono">{formatReportTime(snapshot.timestamp)}</span>
- ) : null}
- </div>
- }
- />
-
- <div className="telemetry-chart" aria-label="Runtime telemetry chart">
- <TelemetryBar label="Success rate" value={successRate} />
- <TelemetryBar label="Error rate" value={errorRate} tone="danger" />
- <TelemetryBar label="Worker capacity" value={workerCapacity} />
- <TelemetryBar label="Host ownership" value={hostOwnership} tone={hostsOwned !== null && hostsOwned > 0 ? "danger" : "ok"} />
- </div>
-
- <div className="mini-stat-grid mt-4">
- <MiniStat title="Module runs" value={formatMetric(total)} detail={`${success} success / ${failed} failed`} />
- <MiniStat title="Findings" value={formatMetric(findings)} />
- <MiniStat title="Queue" value={formatMetric(queueDepth)} detail={`${activeWorkers} active workers`} />
- <MiniStat title="Throughput" value={throughputValue} detail={latencyDetail} />
- </div>
-
- <div className="telemetry-footer">
- <span>Scope: {snapshot?.campaign_id ? `campaign ${snapshot.campaign_id}` : "global"}</span>
- <span>{hostsAvailable ? `${hostsDiscovered} discovered / ${hostsOwned ?? 0} owned hosts` : "Host ownership unavailable"}</span>
- <span>{workerTotal === 0 ? "no worker sample" : unhealthyWorkers === 0 ? "workers healthy" : `${unhealthyWorkers} unhealthy workers`}</span>
- </div>
-
- <details className="advanced-details">
- <summary className="text-xs text-zinc-400 hover:text-zinc-200 cursor-pointer mb-2">Telemetry Engine Payload</summary>
- <StructuredJsonViewer data={snapshot ?? {}} title="Telemetry Engine Snapshot" maxHeightClass="max-h-64" />
- </details>
- </section>
- );
-}
-
-function TelemetryBar({ label, value, tone = "ok" }: { label: string; value: number | null; tone?: "ok" | "danger" }) {
- const isNa = value === null;
- const isZero = value === 0;
- const clamped = isNa ? 0 : Math.max(0, Math.min(100, value));
- const trackClass = `telemetry-bar-track ${isNa ? "is-na" : isZero ? "is-zero" : ""}`;
- const valueLabel = isNa ? "n/a" : `${clamped}%`;
- const valueClass = isNa ? "is-na font-mono" : isZero ? "is-zero font-mono" : "font-mono";
-
- return (
- <div className="telemetry-bar" title={isNa ? "No data yet" : isZero ? "0% (measured baseline)" : `${label}: ${clamped}%`}>
- <span>{label}</span>
- <div className={trackClass}>
- <div className={tone === "danger" ? "telemetry-bar-fill danger" : "telemetry-bar-fill"} style={{ width: `${clamped}%` }} />
- </div>
- <strong className={valueClass}>{valueLabel}</strong>
- </div>
- );
-}
-
-function CvssScoreCard({ data }: { data?: Record<string, unknown> }) {
- if (!data) return null;
- const score = data.base_score ?? data.score ?? data.overall;
- const severity = String(data.severity ?? (typeof score === "number" && score >= 9 ? "critical" : typeof score === "number" && score >= 7 ? "high" : typeof score === "number" && score >= 4 ? "medium" : "low")).toLowerCase();
- const vector = data.vector_string ?? data.vector;
- return (
- <section className="panel p-4 cvss-card">
- <div className="flex items-start justify-between gap-4 mb-3">
- <div>
- <div className="text-[11px] font-semibold text-zinc-400 uppercase tracking-wider">Risk Assessment</div>
- <h3 className="text-base font-semibold text-white">CVSS Metrics</h3>
- </div>
- <span className={`${opsecBadge(severity)} font-semibold uppercase text-xs px-2.5 py-1`}>
- {severity}
- </span>
- </div>
- <div className="grid grid-cols-1 sm:grid-cols-3 gap-3 mb-3">
- <div className="bg-[#18181c] border border-[#27272a] rounded-lg p-3">
- <div className="text-[11px] text-zinc-400">Base Score</div>
- <div className="text-2xl font-bold font-mono text-white mt-1">{score !== undefined ? String(score) : "N/A"}</div>
- </div>
- <div className="bg-[#18181c] border border-[#27272a] rounded-lg p-3 sm:col-span-2">
- <div className="text-[11px] text-zinc-400">Vector String</div>
- <div className="text-xs font-mono text-zinc-300 mt-1.5 break-all">{vector ? String(vector) : "Vector string not calculated"}</div>
- </div>
- </div>
- <details className="advanced-details">
- <summary className="text-xs text-zinc-400 hover:text-zinc-200 cursor-pointer mb-2">Inspect Raw CVSS Payload</summary>
- <StructuredJsonViewer data={data} title="CVSS Risk Metrics" maxHeightClass="max-h-64" />
- </details>
- </section>
- );
-}
-
-function CampaignDiffCard({ data }: { data?: Record<string, unknown> }) {
- if (!data) return null;
- return (
- <section className="panel p-4 diff-card">
- <div className="flex items-center justify-between mb-3">
- <div>
- <div className="text-[11px] font-semibold text-zinc-400 uppercase tracking-wider">Delta Analysis</div>
- <h3 className="text-base font-semibold text-white">Campaign Comparison</h3>
- </div>
- <span className="badge badge-low text-xs">Compared</span>
- </div>
- <details className="advanced-details" open>
- <summary className="text-xs text-zinc-400 hover:text-zinc-200 cursor-pointer mb-2">Detailed Delta Metrics</summary>
- <StructuredJsonViewer data={data} title="Campaign Delta Metrics" maxHeightClass="max-h-72" />
- </details>
- </section>
- );
-}
-
-function DataPanel({
- title,
- data,
- onClear
-}: {
- title: string;
- data: unknown;
- onClear?: () => void;
-}) {
- const [copied, setCopied] = useState(false);
- if (!data) {
- return null;
- }
- const isError = data instanceof Error || data instanceof ApiError;
- if (isError) {
- const errorMsg = data instanceof ApiError ? String(data.detail) : data instanceof Error ? data.message : "The request failed.";
- return (
- <div className="rounded-lg border border-rose-500/30 bg-rose-500/10 p-3.5 text-xs text-rose-300 flex items-start justify-between gap-3 mb-3">
- <div className="flex items-start gap-2.5">
- <AlertTriangle size={16} className="text-rose-400 shrink-0 mt-0.5" />
- <div>
- <strong className="font-semibold text-rose-200 block mb-0.5">{title}</strong>
- <span className="leading-relaxed">{errorMsg}</span>
- </div>
- </div>
- <div className="flex items-center gap-2 shrink-0">
- {onClear && (
- <button
- className="btn btn-compact text-[11px] py-0.5 px-2 flex items-center gap-1 text-rose-300 hover:text-white border-rose-500/30 hover:bg-rose-500/20"
- onClick={onClear}
- type="button"
- title="Dismiss error"
- >
- <X size={12} />
- <span>Dismiss</span>
- </button>
- )}
- <span className="badge badge-high shrink-0 text-[10px] uppercase font-mono">Error</span>
- </div>
- </div>
- );
- }
-
- const jsonText = JSON.stringify(serializeError(data), null, 2);
- const handleCopy = () => {
- void navigator.clipboard.writeText(jsonText);
- setCopied(true);
- setTimeout(() => setCopied(false), 1500);
- };
-
- return (
- <section className="panel detail-panel mb-3">
- <div className="flex items-center justify-between mb-2">
- <strong className="text-xs font-semibold text-zinc-200">{title}</strong>
- {onClear && (
- <button
- className="btn btn-compact text-[11px] py-0.5 px-2 flex items-center gap-1 text-zinc-400 hover:text-rose-400 hover:border-rose-900/50"
- onClick={onClear}
- type="button"
- title="Clear payload preview"
- >
- <X size={12} />
- <span>Clear</span>
- </button>
- )}
- </div>
- <StructuredJsonViewer data={data} title={`${title} Telemetry`} maxHeightClass="max-h-96" defaultExpandedDepth={1} />
- </section>
- );
-}
-
-function getTailoredFindingDetails(finding: Finding) {
- const title = String(finding.title ?? "").toUpperCase();
- const desc = String(finding.description ?? "");
- const evidence = (finding.evidence ?? {}) as Record<string, unknown>;
- const rawPort = evidence.port ?? desc.match(/port\s+(\d+)/i)?.[1];
- const port = rawPort ? Number(rawPort) : null;
- const isKerberos = title.includes("KERBEROS") || port === 88;
- const isLdaps = title.includes("LDAPS") || port === 636;
- const isLdap = !isLdaps && (title.includes("LDAP") || port === 389);
- const isSmb = title.includes("SMB") || port === 445;
- const isWinrm = title.includes("WINRM") || port === 5985 || port === 5986;
- const isDns = title.includes("DNS") || port === 53;
- const isRpc = title.includes("RPC") || port === 135;
- const isMssql = title.includes("MSSQL") || port === 1433;
- const isRdp = title.includes("RDP") || port === 3389;
- const isDocker = title.includes("DOCKER") || port === 2375;
- const isRedis = title.includes("REDIS") || port === 6379;
- const isAttackSurface = title.includes("ATTACK SURFACE");
-
- let serviceTag = typeof evidence.role === "string" && evidence.role ? evidence.role : "";
- let serviceCategory = typeof evidence.service === "string" && evidence.service ? String(evidence.service).toUpperCase() : "";
- let tailoredRemediation = String(finding.remediation ?? "");
-
- if (isKerberos) {
- serviceTag = serviceTag || "PORT 88 / KERBEROS KDC / TIER-0 DC";
- serviceCategory = serviceCategory || "Active Directory Authentication";
- tailoredRemediation = tailoredRemediation || "Enforce AES-256 Kerberos encryption (disable RC4-HMAC), audit service accounts for SPNs to mitigate Kerberoasting, and monitor Event ID 4769 for abnormal TGS requests.";
- } else if (isLdaps) {
- serviceTag = serviceTag || "PORT 636 / LDAPS SECURE / TIER-0 DC";
- serviceCategory = serviceCategory || "Encrypted Directory Service";
- tailoredRemediation = tailoredRemediation || "Enforce strong TLS cipher suites, validate CA trust chains, and ensure LDAP channel binding is strictly enforced (LdapEnforceChannelBinding=2).";
- } else if (isLdap) {
- serviceTag = serviceTag || "PORT 389 / LDAP DIRECTORY";
- serviceCategory = serviceCategory || "Active Directory Service";
- tailoredRemediation = tailoredRemediation || "Require LDAP signing (LDAPServerIntegrity=2) and upgrade clients to LDAPS (port 636) to prevent NTLM relay and credential harvesting.";
- } else if (isSmb) {
- serviceTag = serviceTag || "PORT 445 / SMB SERVICE";
- serviceCategory = serviceCategory || "Core Windows File Sharing & Remote Admin";
- tailoredRemediation = tailoredRemediation || "Require SMB signing (RequireSecuritySignature=1), disable legacy SMBv1, and restrict port 445 inbound access to management subnets.";
- } else if (isWinrm) {
- serviceTag = serviceTag || `PORT ${port || 5985} / WINRM REMOTE MGMT`;
- serviceCategory = serviceCategory || "Windows Remote Management (PowerShell Remoting)";
- tailoredRemediation = tailoredRemediation || "Disable WinRM plaintext HTTP listeners, transition management traffic to WinRM HTTPS (port 5986), and enforce GPO firewall restrictions.";
- } else if (isMssql) {
- serviceTag = serviceTag || "PORT 1433 / MSSQL DATABASE";
- serviceCategory = serviceCategory || "Enterprise Relational Database";
- tailoredRemediation = tailoredRemediation || "Disable 'sa' account, enforce Windows Authentication only, and keep xp_cmdshell disabled in configuration.";
- } else if (isRdp) {
- serviceTag = serviceTag || "PORT 3389 / RDP REMOTE DESKTOP";
- serviceCategory = serviceCategory || "Interactive Terminal Services";
- tailoredRemediation = tailoredRemediation || "Enforce Network Level Authentication (NLA) and restrict RDP access to management VPN jump hosts.";
- } else if (isDocker) {
- serviceTag = serviceTag || "PORT 2375 / DOCKER DAEMON API";
- serviceCategory = serviceCategory || "Unauthenticated Container Engine";
- tailoredRemediation = tailoredRemediation || "Disable unauthenticated TCP socket; bind to local Unix socket or require mutual TLS authentication on port 2376.";
- } else if (isRedis) {
- serviceTag = serviceTag || "PORT 6379 / REDIS MEMORY STORE";
- serviceCategory = serviceCategory || "In-Memory Cache & Key-Value Store";
- tailoredRemediation = tailoredRemediation || "Enable requirepass authentication and bind Redis listener strictly to 127.0.0.1.";
- } else if (isDns) {
- serviceTag = serviceTag || "PORT 53 / MICROSOFT DNS";
- serviceCategory = serviceCategory || "Domain Name Resolution";
- tailoredRemediation = tailoredRemediation || "Restrict DNS zone transfers (AXFR) to designated secondary nameservers only, and enable DNSSEC validation.";
- } else if (isRpc) {
- serviceTag = serviceTag || "PORT 135 / MSRPC ENDPOINT";
- serviceCategory = serviceCategory || "RPC Endpoint Mapper";
- tailoredRemediation = tailoredRemediation || "Restrict RPC endpoint mapper via host-based firewall to prevent unauthenticated RPC enumeration and coercions.";
- } else if (isAttackSurface) {
- serviceTag = "HOST ATTACK SURFACE SUMMARY";
- serviceCategory = "Exposed Network Services";
- tailoredRemediation = tailoredRemediation || "Audit all listening ports against the enterprise baseline and enforce host-based micro-segmentation with Windows Defender Firewall.";
- }
-
- const rawConf = typeof finding.confidence === "number" ? finding.confidence : 1.0;
- const isHighConf = rawConf >= 0.85 || finding.validated === true;
- const confidenceText = rawConf >= 0.95
- ? "100% Confirmed"
- : formatRate(rawConf);
-
- const nextModules = Array.isArray(evidence.next_modules)
- ? (evidence.next_modules as string[])
- : isKerberos
- ? ["ad.asreproast", "ad.kerberoast", "ad.enum_spn"]
- : isLdaps
- ? ["ad.enum_users", "ad.adcs", "ad.ghost_forge"]
- : isLdap
- ? ["ad.enum_users", "ad.enum_spn", "ad.enum_acl"]
- : isSmb
- ? ["ad.coerce", "windows.secretsdump"]
- : isWinrm
- ? ["lateral.winrm"]
- : [];
-
- return {
- port,
- serviceTag,
- serviceCategory,
- tailoredRemediation,
- isHighConf,
- confidenceText,
- nextModules
- };
-}
-
-function DiscoveredPerimeterCard({
- rawOutput,
- onSelectModule,
- findingsCount = 0
-}: {
- rawOutput?: Record<string, unknown>;
- onSelectModule?: (moduleId: string, params?: Record<string, unknown>) => void;
- findingsCount?: number;
-}) {
- const [copiedLootIdx, setCopiedLootIdx] = useState<number | null>(null);
- const [showLoot, setShowLoot] = useState(false);
- if (!rawOutput) return null;
-
- const target = String(rawOutput.target ?? rawOutput.host ?? "");
- const openPorts = Array.isArray(rawOutput.open_ports) ? (rawOutput.open_ports as (number | string)[]) : [];
- const serviceMap = (rawOutput.service_map ?? {}) as Record<string, string>;
- const serviceVersions = (rawOutput.service_versions ?? {}) as Record<string, Record<string, unknown> | string>;
- const loot = Array.isArray(rawOutput.loot) ? (rawOutput.loot as Record<string, unknown>[]) : [];
- const scanMs = typeof rawOutput.scan_ms === "number" ? rawOutput.scan_ms : null;
- const totalScanned = typeof rawOutput.total_scanned === "number" ? rawOutput.total_scanned : null;
-
- const hasPerimeter = openPorts.length > 0 || Object.keys(serviceVersions).length > 0;
- if (!hasPerimeter && loot.length === 0) return null;
-
- return (
- <div className="space-y-2 mt-3">
- {/* 1. Defensive Telemetry & Purple Loot (Collapsible Progressive Disclosure) */}
- {loot.length > 0 && (
- <div className="border border-zinc-800 bg-zinc-950/80 rounded-sm overflow-hidden text-xs">
- <button
- type="button"
- onClick={() => setShowLoot((prev) => !prev)}
- className="w-full p-2.5 px-3 flex items-center justify-between hover:bg-zinc-900/60 transition-colors text-left font-sans"
- >
- <div className="flex items-center gap-2">
- <ShieldCheck size={14} className="text-emerald-400 shrink-0" />
- <span className="font-semibold text-zinc-200 text-xs">
- Synthesized Detection Rules ({loot.length})
- </span>
- <span className="text-[10px] px-1.5 py-0.2 bg-zinc-900 border border-zinc-800 text-zinc-400 rounded font-mono">
- KQL & Sigma
- </span>
- </div>
- <div className="flex items-center gap-1.5 text-xs text-zinc-400">
- <span className="text-[11px]">{showLoot ? "Hide Rules" : "Show Rules"}</span>
- <ChevronDown size={14} className={`transform transition-transform duration-200 ${showLoot ? "rotate-180" : ""}`} />
- </div>
- </button>
-
- {showLoot && (
- <div className="p-3 border-t border-zinc-800/80 space-y-2.5 bg-zinc-950/50 font-mono">
- {loot.map((item, idx) => {
- const name = String(item.name ?? `Artifact #${idx + 1}`);
- const lootType = String(item.loot_type ?? "rule");
- const content = item.content as Record<string, unknown> | undefined;
- const ruleText = typeof content?.kql === "string"
- ? content.kql
- : typeof content?.sigma === "string"
- ? content.sigma
- : typeof item.content === "string"
- ? item.content
- : JSON.stringify(item.content ?? item, null, 2);
-
- const handleCopyRule = () => {
- void navigator.clipboard.writeText(ruleText);
- setCopiedLootIdx(idx);
- setTimeout(() => setCopiedLootIdx(null), 1500);
- };
-
- return (
- <div key={idx} className="p-2.5 rounded-sm border border-zinc-800 bg-zinc-900/60 space-y-1.5">
- <div className="flex items-center justify-between gap-2">
- <div className="flex items-center gap-2 truncate">
- <Terminal size={12} className="text-zinc-400 shrink-0" />
- <strong className="text-zinc-200 text-xs truncate">{name}</strong>
- <span className="badge text-[10px] py-0 px-1.5 uppercase">{lootType}</span>
- </div>
- <button
- type="button"
- onClick={handleCopyRule}
- className="btn btn-compact text-[10px] py-0.5 px-2 flex items-center gap-1 shrink-0"
- title="Copy detection rule query"
- >
- {copiedLootIdx === idx ? (
- <>
- <CheckCircle2 size={11} className="text-emerald-400" />
- <span className="text-emerald-400">Copied</span>
- </>
- ) : (
- <>
- <Copy size={11} />
- <span>Copy Rule</span>
- </>
- )}
- </button>
- </div>
- <pre className="text-[11px] font-mono text-zinc-300 bg-zinc-950 p-2 rounded-sm overflow-x-auto max-h-36 border border-zinc-800/60 leading-relaxed select-all">
- {ruleText}
- </pre>
- </div>
- );
- })}
- </div>
- )}
- </div>
- )}
-
- {/* 2. Perimeter Inventory Bar (Clean, non-redundant when findings are present) */}
- {hasPerimeter && findingsCount > 0 && (
- <div className="border border-zinc-800 bg-zinc-950/80 rounded-sm p-2.5 px-3 flex flex-wrap items-center justify-between gap-2 text-xs font-mono">
- <div className="flex items-center gap-2">
- <Radio size={13} className="text-emerald-400 shrink-0" />
- <span className="font-semibold text-zinc-300 text-[11px]">
- Surface Inventory:
- </span>
- {target && (
- <span className="text-zinc-400">
- Host <strong className="text-zinc-100">{target}</strong>
- </span>
- )}
- </div>
- <div className="flex items-center gap-3 text-zinc-400 text-[11px]">
- {totalScanned !== null && <span>Scanned: {totalScanned} ports</span>}
- {scanMs !== null && <span>Latency: {scanMs}ms</span>}
- <div className="flex items-center gap-1.5">
- {openPorts.map((port) => (
- <span key={String(port)} className="px-1.5 py-0.5 rounded-sm bg-zinc-900 border border-zinc-700/80 text-emerald-400 font-semibold text-[10px]">
- {String(port)}/TCP ({serviceMap[String(port)] ?? "active"})
- </span>
- ))}
- </div>
- </div>
- </div>
- )}
-
- {/* 3. Discovered Services Grid (Rendered only if no findings exist, avoiding duplicate cards) */}
- {hasPerimeter && findingsCount === 0 && (
- <div className="border border-zinc-800 bg-zinc-950/80 rounded-sm p-3 space-y-2.5 font-mono text-xs">
- <div className="flex flex-wrap items-center justify-between gap-2 border-b border-zinc-800/60 pb-2">
- <div className="flex items-center gap-2">
- <Radio size={14} className="text-emerald-400 shrink-0" />
- <span className="font-semibold text-zinc-200 text-xs">
- Discovered Target Services
- </span>
- {target && (
- <span className="text-zinc-400 bg-zinc-900 px-2 py-0.5 border border-zinc-800 rounded-sm text-[11px]">
- Host: <strong className="text-zinc-100">{target}</strong>
- </span>
- )}
- </div>
- <div className="flex items-center gap-3 text-[11px] text-zinc-400">
- {totalScanned !== null && <span>Scanned: {totalScanned} ports</span>}
- {scanMs !== null && <span>Latency: {scanMs}ms</span>}
- </div>
- </div>
-
- <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-2">
- {openPorts.map((port) => {
- const portStr = String(port);
- const service = serviceMap[portStr] ?? "unknown";
- const versionInfo = serviceVersions[portStr];
- const banner = typeof versionInfo === "object" && versionInfo !== null
- ? String(versionInfo.banner ?? versionInfo.version ?? "")
- : typeof versionInfo === "string" ? versionInfo : "";
-
- return (
- <div
- key={portStr}
- className="p-2.5 rounded-sm border border-zinc-800 bg-zinc-900/60 hover:border-zinc-700 space-y-1.5 transition-colors"
- >
- <div className="flex items-center justify-between">
- <span className="font-bold text-zinc-100 bg-zinc-950 px-2 py-0.5 border border-zinc-800 rounded-sm">
- PORT {portStr}/TCP
- </span>
- <span className="text-[10px] text-emerald-400 uppercase font-semibold flex items-center gap-1">
- <span className="w-1.5 h-1.5 rounded-full bg-emerald-400 inline-block" />
- OPEN ({service})
- </span>
- </div>
-
- {banner && (
- <div className="text-[10px] text-zinc-400 truncate bg-zinc-950/70 p-1 rounded-sm border border-zinc-800/40">
- <span className="text-zinc-500 font-semibold">Banner: </span>
- <span className="text-zinc-300 font-mono">{banner}</span>
- </div>
- )}
-
- {onSelectModule && (
- <div className="pt-1 flex items-center gap-1 flex-wrap">
- {portStr === "22" && (
- <>
- <button
- type="button"
- onClick={() => onSelectModule("network.service_detect", { target, ports: "22" })}
- className="text-[10px] px-2 py-0.5 rounded-sm border border-zinc-700 bg-zinc-800 hover:bg-zinc-700 text-zinc-200 transition-colors"
- >
- Fingerprint SSH
- </button>
- <button
- type="button"
- onClick={() => onSelectModule("lateral.ssh_pivot", { target, port: 22 })}
- className="text-[10px] px-2 py-0.5 rounded-sm border border-zinc-700 bg-zinc-800 hover:bg-zinc-700 text-zinc-200 transition-colors"
- >
- SSH Pivot
- </button>
- <button
- type="button"
- onClick={() => onSelectModule("linux.privesc", { target })}
- className="text-[10px] px-2 py-0.5 rounded-sm border border-zinc-700 bg-zinc-800 hover:bg-zinc-700 text-zinc-200 transition-colors"
- >
- Privesc Audit
- </button>
- </>
- )}
- </div>
- )}
- </div>
- );
- })}
- </div>
- </div>
- )}
- </div>
- );
-}
-
-export function maskSecret(val: string): string {
- if (!val) return "••••";
- if (val.length <= 4) return "••••";
- if (val.length <= 8) return val.slice(0, 2) + "••••" + val.slice(-1);
- return val.slice(0, 3) + "••••••••" + val.slice(-3);
-}
-
-export function getPatternBadgeClass(pattern: string): string {
- const p = pattern.toLowerCase();
- if (p.includes("aws") || p.includes("cloud")) {
- return "bg-amber-950/40 text-amber-300 border-amber-800/60";
- }
- if (p.includes("conn") || p.includes("sql") || p.includes("db")) {
- return "bg-cyan-950/40 text-cyan-300 border-cyan-800/60";
- }
- if (p.includes("cert") || p.includes("private") || p.includes("rsa")) {
- return "bg-emerald-950/40 text-emerald-300 border-emerald-800/60";
- }
- if (p.includes("pass") || p.includes("pwd") || p.includes("shadow")) {
- return "bg-rose-950/40 text-rose-300 border-rose-800/60";
- }
- if (p.includes("key") || p.includes("token") || p.includes("api")) {
- return "bg-purple-950/40 text-purple-300 border-purple-800/60";
- }
- return "bg-zinc-900 text-zinc-300 border-zinc-700/80";
-}
-
-export interface DiscoveredSecretHit {
- file?: string;
- line?: number;
- pattern?: string;
- snippet?: string;
- extracted_secret?: string;
- secret_value?: string;
- entropy?: number;
- confidence?: number;
- is_placeholder?: boolean;
- [key: string]: unknown;
-}
-
-export function DiscoveredSecretsEvidenceViewer({
- hits,
- title = "Discovered Secrets & Hardcoded Credentials"
-}: {
- hits: DiscoveredSecretHit[];
- title?: string;
-}) {
- const [isExpanded, setIsExpanded] = useState(hits.length <= 6);
- const [revealedIdxs, setRevealedIdxs] = useState<Record<number, boolean>>({});
- const [copiedIdx, setCopiedIdx] = useState<number | null>(null);
- const [copiedFileIdx, setCopiedFileIdx] = useState<number | null>(null);
- const [revealAll, setRevealAll] = useState(false);
-
- if (!hits || hits.length === 0) return null;
-
- const toggleReveal = (idx: number) => {
- setRevealedIdxs((prev) => ({
- ...prev,
- [idx]: !prev[idx]
- }));
- };
-
- const handleToggleRevealAll = (e: React.MouseEvent) => {
- e.stopPropagation();
- const next = !revealAll;
- setRevealAll(next);
- const updated: Record<number, boolean> = {};
- hits.forEach((_, i) => {
- updated[i] = next;
- });
- setRevealedIdxs(updated);
- };
-
- const copySecret = (text: string, idx: number) => {
- void navigator.clipboard.writeText(text);
- setCopiedIdx(idx);
- setTimeout(() => setCopiedIdx(null), 1500);
- };
-
- const copyFile = (path: string, idx: number) => {
- void navigator.clipboard.writeText(path);
- setCopiedFileIdx(idx);
- setTimeout(() => setCopiedFileIdx(null), 1500);
- };
-
- return (
- <div className="mt-2.5 rounded-sm border border-zinc-800/90 bg-zinc-950/90 overflow-hidden font-mono text-xs">
- {/* Header */}
- <div
- role="button"
- tabIndex={0}
- onClick={() => setIsExpanded((prev) => !prev)}
- onKeyDown={(e) => {
- if (e.key === "Enter" || e.key === " ") {
- e.preventDefault();
- setIsExpanded((prev) => !prev);
- }
- }}
- className="w-full p-2.5 px-3 flex items-center justify-between hover:bg-zinc-900/60 transition-colors text-left cursor-pointer select-none"
- >
- <div className="flex items-center gap-2 flex-wrap">
- <Key size={13} className="text-amber-400 shrink-0" />
- <strong className="text-zinc-200 text-xs font-sans tracking-tight">
- {title} ({hits.length})
- </strong>
- <span className="text-[10px] uppercase tracking-wider px-1.5 py-0.5 rounded bg-amber-950/50 border border-amber-800/60 text-amber-300 font-semibold">
- LOOT EXTRACTED
- </span>
- {hits.some((h) => h.is_placeholder) && (
- <span className="text-[10px] px-1.5 py-0.5 rounded bg-zinc-900 border border-zinc-800 text-zinc-400">
- SAMPLE / TEST IDENTIFIED
- </span>
- )}
- </div>
-
- <div className="flex items-center gap-2 text-xs">
- <button
- type="button"
- onClick={handleToggleRevealAll}
- className="text-[11px] font-mono px-2 py-0.5 rounded border border-zinc-700 bg-zinc-900 text-zinc-300 hover:text-zinc-100 hover:bg-zinc-800 transition-colors flex items-center gap-1 shrink-0"
- title={revealAll ? "Mask all discovered secret values" : "Reveal all discovered secret values"}
- >
- {revealAll ? <EyeOff size={11} className="text-zinc-400" /> : <Eye size={11} className="text-zinc-400" />}
- <span>{revealAll ? "Mask All" : "Reveal All"}</span>
- </button>
- <div className="flex items-center gap-1 text-zinc-400 text-xs">
- <span className="text-[11px] font-sans">{isExpanded ? "Hide Details" : "Show Details"}</span>
- <ChevronDown size={14} className={`transform transition-transform duration-200 ${isExpanded ? "rotate-180" : ""}`} />
- </div>
- </div>
- </div>
-
- {/* Expanded Table */}
- {isExpanded && (
- <div className="border-t border-zinc-800/80 overflow-x-auto">
- <table className="w-full text-left text-xs border-collapse">
- <thead>
- <tr className="bg-zinc-900/80 border-b border-zinc-800/70 text-[10px] uppercase text-zinc-400 tracking-wider">
- <th className="py-2 px-3 font-medium">Source File & Line</th>
- <th className="py-2 px-3 font-medium">Pattern</th>
- <th className="py-2 px-3 font-medium">Discovered Credential / Value</th>
- <th className="py-2 px-3 font-medium">Shannon Entropy</th>
- <th className="py-2 px-3 font-medium">Confidence</th>
- </tr>
- </thead>
- <tbody className="divide-y divide-zinc-800/50">
- {hits.map((hit, idx) => {
- const isRevealed = Boolean(revealedIdxs[idx]);
- const secretVal = String(hit.secret_value || hit.extracted_secret || hit.snippet || "");
- const displayVal = isRevealed ? secretVal : maskSecret(secretVal);
- const entropyVal = typeof hit.entropy === "number" ? hit.entropy : null;
- const confVal = typeof hit.confidence === "number" ? hit.confidence : null;
- const patternName = String(hit.pattern ?? "credential");
- const filePath = String(hit.file ?? "");
- const lineNo = hit.line;
-
- return (
- <tr key={idx} className="hover:bg-zinc-900/40 transition-colors">
- {/* File Path & Line */}
- <td className="py-2.5 px-3 max-w-[240px]">
- <div className="flex items-center gap-1.5 truncate" title={filePath}>
- <FileText size={12} className="text-zinc-500 shrink-0" />
- <span className="text-zinc-200 truncate text-[11px] font-mono">
- {filePath.split(/\\|\//).slice(-2).join("/") || filePath}
- </span>
- {lineNo !== undefined && (
- <span className="text-[10px] text-amber-400 bg-zinc-900 px-1 py-0.2 border border-zinc-800 rounded shrink-0">
- :{lineNo}
- </span>
- )}
- <button
- type="button"
- onClick={() => copyFile(filePath, idx)}
- className="text-zinc-500 hover:text-zinc-300 p-0.5 rounded transition-colors shrink-0"
- title="Copy file path"
- >
- {copiedFileIdx === idx ? <Check size={11} className="text-emerald-400" /> : <Copy size={11} />}
- </button>
- </div>
- </td>
-
- {/* Pattern Badge */}
- <td className="py-2.5 px-3 whitespace-nowrap">
- <span className={`text-[10px] px-2 py-0.5 rounded border uppercase font-medium ${getPatternBadgeClass(patternName)}`}>
- {patternName.replace(/_/g, " ")}
- </span>
- </td>
-
- {/* Secret Value & Show/Hide + Copy */}
- <td className="py-2.5 px-3">
- <div className="flex items-center gap-1.5 max-w-sm">
- <div
- className="bg-zinc-900/90 border border-zinc-800/80 rounded px-2 py-1 font-mono text-[11px] text-zinc-100 truncate select-all flex-1 tracking-wider"
- title={isRevealed ? secretVal : "Value masked. Click Eye icon to reveal."}
- >
- {displayVal}
- </div>
- <button
- type="button"
- onClick={() => toggleReveal(idx)}
- className="p-1 rounded bg-zinc-900 border border-zinc-700/80 text-zinc-400 hover:text-zinc-200 hover:bg-zinc-800 transition-colors shrink-0"
- title={isRevealed ? "Mask secret" : "Reveal full secret value"}
- >
- {isRevealed ? <EyeOff size={12} /> : <Eye size={12} />}
- </button>
- <button
- type="button"
- onClick={() => copySecret(secretVal, idx)}
- className="p-1 rounded bg-zinc-900 border border-zinc-700/80 text-zinc-400 hover:text-zinc-200 hover:bg-zinc-800 transition-colors shrink-0"
- title="Copy secret value"
- >
- {copiedIdx === idx ? <Check size={12} className="text-emerald-400" /> : <Copy size={12} />}
- </button>
- </div>
- {hit.snippet && hit.snippet !== hit.extracted_secret && isRevealed && (
- <div className="mt-1 text-[10px] font-mono text-zinc-500 bg-zinc-950/70 p-1 rounded border border-zinc-900 truncate" title={hit.snippet}>
- Context: <code className="text-zinc-400">{hit.snippet}</code>
- </div>
- )}
- </td>
-
- {/* Shannon Entropy */}
- <td className="py-2.5 px-3 whitespace-nowrap">
- {entropyVal !== null ? (
- <div className="flex items-center gap-1.5">
- <span
- className={`font-semibold ${
- entropyVal >= 3.5
- ? "text-emerald-400"
- : entropyVal >= 2.5
- ? "text-amber-400"
- : "text-zinc-500"
- }`}
- >
- {entropyVal.toFixed(2)}
- </span>
- <span className="text-[10px] text-zinc-500">bits</span>
- <span
- className="text-[9px] px-1 py-0.2 rounded uppercase border text-zinc-400 border-zinc-800"
- title={
- entropyVal >= 3.5
- ? "High entropy (Likely true random credential/key)"
- : entropyVal >= 2.5
- ? "Moderate entropy (Standard passphrase)"
- : "Low entropy (Dictionary word or placeholder)"
- }
- >
- {entropyVal >= 3.5 ? "HIGH" : entropyVal >= 2.5 ? "MED" : "LOW"}
- </span>
- </div>
- ) : (
- <span className="text-zinc-600">n/a</span>
- )}
- </td>
-
- {/* Confidence & Placeholder Pill */}
- <td className="py-2.5 px-3 whitespace-nowrap">
- <div className="flex items-center gap-1.5">
- {confVal !== null ? (
- <span
- className={`px-1.5 py-0.5 rounded border text-[10px] font-medium font-mono ${
- confVal >= 0.85
- ? "text-emerald-300 bg-emerald-950/50 border-emerald-800/60"
- : confVal >= 0.60
- ? "text-amber-300 bg-amber-950/50 border-amber-800/60"
- : "text-rose-300 bg-rose-950/50 border-rose-800/60"
- }`}
- >
- {confVal >= 0.95 ? "100% Confirmed" : `${Math.round(confVal * 100)}%`}
- </span>
- ) : (
- <span className="text-zinc-500 text-[10px]">Standard</span>
- )}
-
- {hit.is_placeholder && (
- <span
- className="text-[9px] px-1.5 py-0.2 rounded bg-zinc-900 border border-zinc-700 text-zinc-400 uppercase tracking-tight"
- title="Identified as test sample or mock placeholder"
- >
- Placeholder
- </span>
- )}
- </div>
- </td>
- </tr>
- );
- })}
- </tbody>
- </table>
- </div>
- )}
- </div>
- );
-}
-
-function DiscoveredHashesEvidenceViewer({
- hashes,
- title = "Discovered Hashes & Account Secrets"
-}: {
- hashes: Record<string, unknown>[];
- title?: string;
-}) {
- const [isExpanded, setIsExpanded] = useState(hashes.length <= 6);
- const [copiedIdx, setCopiedIdx] = useState<number | null>(null);
-
- if (!hashes || hashes.length === 0) return null;
-
- const copyHash = (hash: string, idx: number) => {
- void navigator.clipboard.writeText(hash);
- setCopiedIdx(idx);
- setTimeout(() => setCopiedIdx(null), 1500);
- };
-
- return (
- <div className="mt-2 rounded-sm border border-zinc-800/90 bg-zinc-950/90 overflow-hidden font-mono text-xs">
- <button
- type="button"
- onClick={() => setIsExpanded((p) => !p)}
- className="w-full p-2.5 px-3 flex items-center justify-between hover:bg-zinc-900/60 transition-colors text-left"
- >
- <div className="flex items-center gap-2">
- <Key size={13} className="text-purple-400 shrink-0" />
- <strong className="text-zinc-200 text-xs font-sans tracking-tight">
- {title} ({hashes.length})
- </strong>
- <span className="text-[10px] uppercase tracking-wider px-1.5 py-0.5 rounded bg-purple-950/50 border border-purple-800/60 text-purple-300 font-semibold">
- HASH REPOSITORY
- </span>
- </div>
- <div className="flex items-center gap-1 text-zinc-400 text-xs">
- <span className="text-[11px] font-sans">{isExpanded ? "Hide" : "Show"}</span>
- <ChevronDown size={14} className={`transform transition-transform duration-200 ${isExpanded ? "rotate-180" : ""}`} />
- </div>
- </button>
-
- {isExpanded && (
- <div className="border-t border-zinc-800/80 overflow-x-auto">
- <table className="w-full text-left text-xs border-collapse">
- <thead>
- <tr className="bg-zinc-900/80 border-b border-zinc-800/70 text-[10px] uppercase text-zinc-400 tracking-wider">
- <th className="py-2 px-3">Principal / Account</th>
- <th className="py-2 px-3">Type</th>
- <th className="py-2 px-3">Extracted Hash</th>
- <th className="py-2 px-3">Privilege</th>
- </tr>
- </thead>
- <tbody className="divide-y divide-zinc-800/50">
- {hashes.map((item, idx) => {
- const user = String(item.username || item.account || item.user || "unknown");
- const hash = String(item.hash || item.ntlm_hash || item.value || "");
- const type = String(item.hash_type || item.type || "crypt");
- const isAdmin = Boolean(item.is_admin || item.is_domain_admin || item.privilege === "Domain Admin");
-
- return (
- <tr key={idx} className="hover:bg-zinc-900/40">
- <td className="py-2 px-3 font-semibold text-zinc-200">{user}</td>
- <td className="py-2 px-3">
- <span className="text-[10px] px-1.5 py-0.5 rounded bg-zinc-900 border border-zinc-800 text-zinc-400 uppercase">
- {type}
- </span>
- </td>
- <td className="py-2 px-3">
- <div className="flex items-center gap-1.5 max-w-md">
- <code className="text-zinc-300 bg-zinc-900 px-2 py-0.5 rounded border border-zinc-800 truncate text-[11px] select-all flex-1">
- {hash}
- </code>
- <button
- type="button"
- onClick={() => copyHash(hash, idx)}
- className="p-1 rounded bg-zinc-900 border border-zinc-700/80 text-zinc-400 hover:text-zinc-200"
- title="Copy hash"
- >
- {copiedIdx === idx ? <Check size={11} className="text-emerald-400" /> : <Copy size={11} />}
- </button>
- </div>
- </td>
- <td className="py-2 px-3 whitespace-nowrap">
- {isAdmin ? (
- <span className="text-[10px] px-1.5 py-0.5 rounded bg-rose-950/50 border border-rose-800/60 text-rose-300 font-semibold">
- Domain Admin
- </span>
- ) : (
- <span className="text-zinc-500 text-[10px]">Standard User</span>
- )}
- </td>
- </tr>
- );
- })}
- </tbody>
- </table>
- </div>
- )}
- </div>
- );
-}
-
-function DiscoveredTicketsEvidenceViewer({
- tickets,
- title = "Discovered Kerberos Tickets & TGTs"
-}: {
- tickets: Record<string, unknown>[];
- title?: string;
-}) {
- const [isExpanded, setIsExpanded] = useState(tickets.length <= 6);
-
- if (!tickets || tickets.length === 0) return null;
-
- return (
- <div className="mt-2 rounded-sm border border-zinc-800/90 bg-zinc-950/90 overflow-hidden font-mono text-xs">
- <button
- type="button"
- onClick={() => setIsExpanded((p) => !p)}
- className="w-full p-2.5 px-3 flex items-center justify-between hover:bg-zinc-900/60 transition-colors text-left"
- >
- <div className="flex items-center gap-2">
- <Key size={13} className="text-cyan-400 shrink-0" />
- <strong className="text-zinc-200 text-xs font-sans tracking-tight">
- {title} ({tickets.length})
- </strong>
- <span className="text-[10px] uppercase tracking-wider px-1.5 py-0.5 rounded bg-cyan-950/50 border border-cyan-800/60 text-cyan-300 font-semibold">
- KERBEROS CREDENTIAL CACHE
- </span>
- </div>
- <div className="flex items-center gap-1 text-zinc-400 text-xs">
- <span className="text-[11px] font-sans">{isExpanded ? "Hide" : "Show"}</span>
- <ChevronDown size={14} className={`transform transition-transform duration-200 ${isExpanded ? "rotate-180" : ""}`} />
- </div>
- </button>
-
- {isExpanded && (
- <div className="border-t border-zinc-800/80 overflow-x-auto">
- <table className="w-full text-left text-xs border-collapse">
- <thead>
- <tr className="bg-zinc-900/80 border-b border-zinc-800/70 text-[10px] uppercase text-zinc-400 tracking-wider">
- <th className="py-2 px-3">Client Principal</th>
- <th className="py-2 px-3">Service Principal</th>
- <th className="py-2 px-3">Expiry</th>
- <th className="py-2 px-3">Cache Path / Origin</th>
- </tr>
- </thead>
- <tbody className="divide-y divide-zinc-800/50">
- {tickets.map((t, idx) => {
- const client = String(t.client || t.client_principal || "n/a");
- const server = String(t.server || t.service_principal || "krbtgt");
- const expiry = String(t.endtime || t.expiry || t.expires || "valid");
- const path = String(t.path || t.ccache_path || t.source || "/tmp/krb5cc_*");
-
- return (
- <tr key={idx} className="hover:bg-zinc-900/40">
- <td className="py-2 px-3 font-semibold text-zinc-200">{client}</td>
- <td className="py-2 px-3 text-zinc-300">{server}</td>
- <td className="py-2 px-3 text-zinc-400 text-[11px]">{expiry}</td>
- <td className="py-2 px-3 text-zinc-500 font-mono text-[11px]">{path}</td>
- </tr>
- );
- })}
- </tbody>
- </table>
- </div>
- )}
- </div>
- );
-}
-
-export function ModuleRunSummary({
- result,
- error,
- onSelectModule
-}: {
- result?: Record<string, unknown>;
- error?: unknown;
- onSelectModule?: (moduleId: string, params?: Record<string, unknown>) => void;
-}) {
- if (!result && !error) {
- return null;
- }
- if (error) {
- return (
- <div className="border border-rose-900/60 bg-rose-950/20 p-3.5 rounded mt-4 font-mono text-xs text-rose-300" role="alert">
- <div className="flex items-center gap-2 font-semibold text-rose-400 mb-1">
- <AlertTriangle size={15} />
- <span>[EXECUTION_FAILED]</span>
- </div>
- <p>{error instanceof ApiError ? String(error.detail) : error instanceof Error ? error.message : "Module run failed."}</p>
- </div>
- );
- }
-
- const findings = Array.isArray(result?.findings) ? result.findings as Finding[] : [];
- const validationCount = Array.isArray(result?.validation_results) ? result.validation_results.length : 0;
- const duration = typeof result?.duration_ms === "number" ? formatMetric(result.duration_ms, " ms") : "n/a";
- const status = String(result?.status ?? "unknown");
- const moduleId = String(result?.module_id ?? "module");
- const rawOutput = (result?.raw_output ?? result?.raw) as Record<string, unknown> | undefined;
- const rawError = typeof rawOutput?.error === "string" ? rawOutput.error : "";
- const rawHint = typeof rawOutput?.hint === "string" ? rawOutput.hint : "";
- const auditProv = rawOutput?._audit_provenance as Record<string, unknown> | undefined;
- const provenanceHash = typeof auditProv?.provenance_hash === "string" ? auditProv.provenance_hash : "";
-
- const runError = typeof result?.error === "string" ? result.error : "";
- const outcome = String(result?.outcome ?? "");
- const outcomeMessage = String(result?.outcome_message ?? "");
- const displayOutcome = outcome || status;
- const dryRun = result?.dry_run === true || status.startsWith("dry_run_");
- const warnings = Array.isArray(result?.warnings) ? result.warnings.map(String) : [];
- const nextSteps = Array.isArray(result?.operator_next_steps) ? result.operator_next_steps.map(String) : [];
- const hasOutcomeError = ["operator_error", "dependency_error", "network_error", "unsupported", "module_error", "failed", "timeout"].includes(displayOutcome);
- const openPorts = Array.isArray(rawOutput?.open_ports) ? (rawOutput.open_ports as (number | string)[]) : [];
- const hasPerimeter = openPorts.length > 0 || Object.keys((rawOutput?.service_versions ?? {}) as object).length > 0;
- const filteredFindings = (result?.filtered_findings as { count?: number; reasons?: Record<string, number> } | undefined) ?? {};
- const filteredCount = typeof filteredFindings.count === "number" ? filteredFindings.count : 0;
- const filteredReasons = filteredFindings.reasons && typeof filteredFindings.reasons === "object" ? filteredFindings.reasons : {};
- let topReasonLabel = "below reporting threshold";
- const reasonEntries = Object.entries(filteredReasons).sort((a, b) => b[1] - a[1]);
- if (reasonEntries.length > 0) {
- const topKey = reasonEntries[0][0];
- if (topKey === "below_confidence_threshold") {
- topReasonLabel = "below reporting threshold";
- } else if (topKey === "no_evidence") {
- topReasonLabel = "no evidence";
- } else if (topKey === "validator_rejected") {
- topReasonLabel = "validator rejected";
- } else {
- topReasonLabel = topKey.replace(/_/g, " ");
- }
- }
- const emptyText = dryRun
- ? "No live execution was performed."
- : rawError
- ? `Module halted with status '${rawError}'. See execution notice above.`
- : hasPerimeter
- ? `Target perimeter active: ${openPorts.length} port(s) identified. Review reconnaissance telemetry below.`
- : outcome === "completed_no_findings"
- ? "No confirmed findings. The module completed without observing an exploitable condition."
- : runError
- ? "No findings recorded because execution failed."
- : "No findings returned.";
-
- return (
- <section className="mt-4 space-y-3 font-sans">
- {/* Tactical Telemetry Strip (Replacing bulky cards & notice clutter) */}
- <div className="grid grid-cols-2 md:grid-cols-4 gap-px bg-zinc-800/80 border border-zinc-800 rounded-sm overflow-hidden text-xs font-mono">
- <div className="bg-zinc-950 p-2.5">
- <span className="text-[10px] text-zinc-500 uppercase tracking-wider block">MODULE / OPERATION</span>
- <span className="font-semibold text-zinc-200">{moduleId}</span>
- </div>
- <div className="bg-zinc-950 p-2.5">
- <span className="text-[10px] text-zinc-500 uppercase tracking-wider block">EXECUTION OUTCOME</span>
- <span className={hasOutcomeError ? "text-rose-400 font-semibold" : "text-emerald-400 font-semibold"}>
- {displayOutcome}
- </span>
- </div>
- <div className="bg-zinc-950 p-2.5">
- <span className="text-[10px] text-zinc-500 uppercase tracking-wider block">OBSERVATIONS / AUDIT</span>
- <span className="font-semibold text-zinc-100">
- {findings.length} findings <span className="text-zinc-500 text-[11px]">({validationCount} verified)</span>
- </span>
- </div>
- <div className="bg-zinc-950 p-2.5">
- <span className="text-[10px] text-zinc-500 uppercase tracking-wider block">DURATION</span>
- <span className="font-semibold text-zinc-300">{duration}</span>
- </div>
- </div>
-
- {provenanceHash && (
- <div className="px-3 py-1.5 rounded-sm border border-zinc-800/80 bg-zinc-950/80 flex items-center justify-between gap-3 text-xs font-mono">
- <div className="flex items-center gap-2 text-zinc-400 truncate">
- <ShieldCheck size={13} className="text-emerald-400 shrink-0" />
- <span className="text-zinc-500 font-semibold">AUDIT PROVENANCE:</span>
- <code className="text-zinc-300 truncate text-[11px] select-all">{provenanceHash}</code>
- </div>
- <span className="text-[10px] text-emerald-400/90 uppercase tracking-wider shrink-0 font-semibold">[IMMUTABLE RECORD]</span>
- </div>
- )}
-
- {rawError && (
- <div className="p-3 rounded-sm border border-amber-900/50 bg-amber-950/20 text-xs font-mono text-amber-300 flex items-start gap-2" role="alert">
- <AlertTriangle size={14} className="shrink-0 mt-0.5 text-amber-400" />
- <div>
- <span className="font-semibold">[EXECUTION NOTICE: {rawError.replace(/_/g, " ").toUpperCase()}]</span>
- {rawHint && <p className="mt-0.5 text-zinc-400">{rawHint}</p>}
- </div>
- </div>
- )}
-
- {(outcomeMessage || runError) && !rawError && hasOutcomeError && (
- <div className="p-3 rounded-sm border border-rose-900/60 bg-rose-950/20 text-xs font-mono text-rose-300 flex items-center gap-2" role="alert">
- <AlertTriangle size={14} className="shrink-0 text-rose-400" />
- <span>{outcomeMessage || runError}</span>
- </div>
- )}
-
- {warnings.length > 0 && (
- <div className="p-3 rounded-sm border border-zinc-800 bg-zinc-950/60 text-xs font-mono text-zinc-400">
- <span className="text-zinc-300 uppercase tracking-wider font-semibold block mb-1">
- [{dryRun ? "SIMULATION NOTES" : "OPERATION NOTES"}]
- </span>
- <ul className="list-disc pl-4 space-y-0.5">
- {warnings.map((warning) => <li key={warning}>{warning}</li>)}
- </ul>
- </div>
- )}
-
- {nextSteps.length > 0 && (
- <div className="p-3 rounded-sm border border-zinc-800 bg-zinc-950/60 text-xs font-mono text-zinc-400">
- <span className="text-zinc-300 uppercase tracking-wider font-semibold block mb-1">
- [OPERATOR NEXT STEPS]
- </span>
- <ul className="list-disc pl-4 space-y-0.5">
- {nextSteps.map((step) => <li key={step}>{step}</li>)}
- </ul>
- </div>
- )}
-
- {/* Discovered Target Perimeter Matrix & Purple Team Loot */}
- <DiscoveredPerimeterCard rawOutput={rawOutput} onSelectModule={onSelectModule} findingsCount={findings.length} />
-
- {/* Findings Telemetry Stream (High-Density Tactical Matrix) */}
- {findings.length > 0 ? (
- <div className="space-y-2 mt-2">
- {findings.map((finding, index) => {
- const details = getTailoredFindingDetails(finding);
- const normSev = String(finding.severity ?? "info").toLowerCase();
- const borderAccent =
- normSev.includes("high") || normSev.includes("crit")
- ? "border-l-rose-500"
- : normSev.includes("med")
- ? "border-l-amber-500"
- : "border-l-zinc-700";
-
- const evidence = (finding.evidence ?? {}) as Record<string, unknown>;
- const rawSecretHits = (
- Array.isArray(evidence.hits)
- ? evidence.hits
- : Array.isArray(evidence.discovered_secrets)
- ? evidence.discovered_secrets
- : Array.isArray(rawOutput?.discovered_secrets) &&
- (finding.module_id === "exfil.secrets_scan" ||
- String(finding.title ?? "").toLowerCase().includes("secrets"))
- ? rawOutput.discovered_secrets
- : []
- ) as DiscoveredSecretHit[];
-
- const hashes = Array.isArray(evidence.hashes) ? (evidence.hashes as Record<string, unknown>[]) : [];
- const tickets = Array.isArray(evidence.tickets) ? (evidence.tickets as Record<string, unknown>[]) : [];
-
- return (
- <div
- className={`border border-zinc-800/80 border-l-[3px] ${borderAccent} bg-zinc-950/70 hover:bg-zinc-900/40 hover:border-zinc-700 transition-colors p-3.5 space-y-2.5 rounded-sm`}
- key={finding.id ?? index}
- >
- {/* Header Row: Endpoint Port, Mitre, Host, Severity & Confidence */}
- <div className="flex flex-wrap items-center justify-between gap-2 text-xs font-mono pb-2 border-b border-zinc-800/50">
- <div className="flex items-center gap-2 flex-wrap">
- {details.port ? (
- <span className="font-bold text-zinc-100 bg-zinc-900 px-2 py-0.5 border border-zinc-800 rounded-sm">
- PORT {details.port}/TCP
- </span>
- ) : details.serviceTag ? (
- <span className="font-bold text-zinc-100 bg-zinc-900 px-2 py-0.5 border border-zinc-800 rounded-sm">
- {details.serviceTag}
- </span>
- ) : null}
- {details.serviceCategory && (
- <span className="text-[11px] text-zinc-400 font-sans">
- {details.serviceCategory}
- </span>
- )}
- {finding.host && (
- <span className="text-[11px] text-zinc-500">
- TARGET: <strong className="text-zinc-300 font-mono">{finding.host}</strong>
- </span>
- )}
- {finding.mitre_technique && (
- <span className="text-[10px] text-zinc-500 border border-zinc-800 px-1.5 py-0.5 rounded-sm">
- {finding.mitre_technique}
- </span>
- )}
- </div>
-
- <div className="flex items-center gap-2.5 shrink-0">
- <span className={details.isHighConf ? "text-emerald-400 font-mono text-[11px] flex items-center gap-1 font-medium" : "text-zinc-400 font-mono text-[11px]"}>
- {details.isHighConf && <CheckCircle2 size={12} className="text-emerald-400" />}
- {details.confidenceText}
- </span>
- <span className={opsecBadge(finding.severity)}>
- {finding.severity ? String(finding.severity).toUpperCase() : "INFO"}
- </span>
- </div>
- </div>
-
- {/* Finding Title & Concise Narrative */}
- <div>
- <h3 className="font-sans font-semibold text-sm text-zinc-100 tracking-tight">
- {finding.title ?? `Observation #${index + 1}`}
- </h3>
- <p className="mt-1 text-xs text-zinc-400 leading-relaxed font-sans whitespace-pre-line">
- {String(finding.description ?? "")}
- </p>
- </div>
-
- {/* Discovered Secrets Evidence (Hardcoded Credentials, Keys & Tokens) */}
- {rawSecretHits.length > 0 && (
- <DiscoveredSecretsEvidenceViewer hits={rawSecretHits} />
- )}
-
- {/* Discovered Hashes Evidence Repository */}
- {hashes.length > 0 && (
- <DiscoveredHashesEvidenceViewer hashes={hashes} />
- )}
-
- {/* Discovered Kerberos Tickets Evidence Repository */}
- {tickets.length > 0 && (
- <DiscoveredTicketsEvidenceViewer tickets={tickets} />
- )}
-
- {/* Technical Remediation */}
- {details.tailoredRemediation && (
- <div className="pt-2 border-t border-zinc-800/50 text-xs font-mono text-zinc-400 flex items-start gap-2">
- <span className="text-zinc-500 shrink-0 text-[10px] uppercase font-semibold">[MITIGATION]</span>
- <span className="font-sans text-xs text-zinc-300 leading-relaxed">
- {details.tailoredRemediation}
- </span>
- </div>
- )}
-
- {/* Next Actions */}
- {details.nextModules.length > 0 && onSelectModule && (
- <div className="pt-2 border-t border-zinc-800/50 flex items-center gap-2 flex-wrap">
- <span className="text-[10px] font-mono text-zinc-500 uppercase tracking-wider shrink-0">
- Next Actions:
- </span>
- <div className="flex items-center gap-1.5 flex-wrap">
- {details.nextModules.map((nextMod) => (
- <button
- key={nextMod}
- type="button"
- onClick={() => onSelectModule(nextMod, { target: finding.host })}
- className="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-sm border border-zinc-700/80 bg-zinc-900/90 hover:border-zinc-500 hover:bg-zinc-800 text-zinc-200 font-mono text-[11px] transition-colors"
- title={`Arm and execute ${nextMod} on ${finding.host}`}
- >
- <Terminal size={11} className="text-zinc-400" />
- <span>Execute: <strong className="text-zinc-100">{nextMod}</strong></span>
- <ArrowRight size={11} className="text-zinc-400" />
- </button>
- ))}
- </div>
- </div>
- )}
- </div>
- );
- })}
- </div>
- ) : (
- <EmptyState text={emptyText} />
- )}
-
- {filteredCount > 0 && (
- <div
- data-testid="filtered-findings-notice"
- className="flex items-center gap-2 px-3 py-2 rounded-sm border border-zinc-800 bg-zinc-900/60 text-xs font-mono text-zinc-400 mt-2"
- >
- <Info size={13} className="text-zinc-500 shrink-0" />
- <span>
- {filteredCount} finding{filteredCount === 1 ? "" : "s"} filtered as low-confidence ({topReasonLabel})
- </span>
- </div>
- )}
- </section>
- );
-}
-
-function TemplatePlanSummary({ plan }: { plan?: TemplatePlanResponse }) {
- const stages = plan?.plan?.stages ?? [];
- if (!plan || stages.length === 0) {
- return null;
- }
- const moduleCount = stages.reduce((total, stage) => total + (stage.modules?.length ?? 0), 0);
- return (
- <section className="inline-summary mt-4">
- <SectionHeader
- title={plan.template ?? "Generated Plan"}
- description={plan.description}
- action={(
- <div className="flex flex-wrap gap-2">
- <span className="badge">{stages.length} stages</span>
- <span className="badge">{moduleCount} modules</span>
- </div>
- )}
- />
- <div className="compact-list">
- {stages.map((stage, index) => (
- <div className="compact-row" key={`${stage.name ?? "stage"}-${index}`}>
- <div className="flex flex-wrap items-center justify-between gap-2">
- <span className="font-bold">{index + 1}. {stage.name ?? "stage"}</span>
- <span className="text-xs font-semibold text-zinc-400">{stage.modules?.length ?? 0} modules</span>
- </div>
- <div className="mt-2 flex flex-wrap gap-1">
- {(stage.modules ?? []).map((moduleId) => <span className="badge" key={moduleId}>{moduleId}</span>)}
- </div>
- </div>
- ))}
- </div>
- <p className="mt-3 text-sm text-zinc-400">Ready for campaign dry-run structure.</p>
- </section>
- );
-}
-
-function CampaignScopeSummary({ campaign, loading }: { campaign?: Campaign; loading?: boolean }) {
- const [copied, setCopied] = useState(false);
- const [showRaw, setShowRaw] = useState(false);
- if (loading) {
- return (
- <div className="detail-summary mt-3">
- <div className="loading-row">
- <Loader2 className="spin" size={16} /> Loading campaign...
- </div>
- </div>
- );
- }
- if (!campaign) {
- return <EmptyState text="Select a campaign to review scope and findings." />;
- }
- const targets = campaignTargets(campaign);
- const scope = campaignScopeEntries(campaign);
- const excluded = campaignExcludedHosts(campaign);
-
- const copyScope = () => {
- void navigator.clipboard.writeText(JSON.stringify(campaign, null, 2));
- setCopied(true);
- setTimeout(() => setCopied(false), 1500);
- };
-
- return (
- <div className="detail-summary mt-3">
- <div className="mb-3 flex flex-wrap items-start justify-between gap-3">
- <div>
- <h3 className="text-base font-bold text-white tracking-tight">{campaign.name}</h3>
- <p className="text-xs text-zinc-400 mt-0.5">{campaign.client ?? "No client"} &middot; <span className="text-emerald-400 uppercase font-mono text-[11px]">{campaign.status ?? "created"}</span></p>
- </div>
- <div className="flex items-center gap-2">
- <button
- type="button"
- onClick={copyScope}
- className="btn btn-compact text-[11px] py-1 px-2.5 flex items-center gap-1.5"
- title="Copy campaign JSON"
- >
- {copied ? <CheckCircle2 size={12} className="text-emerald-400" /> : <Copy size={12} />}
- <span>{copied ? "Copied" : "Copy Scope"}</span>
- </button>
- <span className="badge font-mono text-[11px]">{campaign.operator ?? "operator"}</span>
- </div>
- </div>
- <div className="mini-stat-grid">
- <MiniStat title="Targets" value={String(targets.length)} detail={targets.slice(0, 3).join(", ") || "none declared"} />
- <MiniStat title="Scope CIDRs" value={String(scope.length)} detail={scope.slice(0, 3).join(", ") || "none declared"} />
- <MiniStat title="Excluded Hosts" value={String(excluded.length)} detail={excluded.length > 0 ? excluded.slice(0, 2).join(", ") : "none"} />
- <MiniStat title="Noise Profile" value={String(campaign.noise_profile ?? "stealth")} detail="OPSEC guardrail" />
- </div>
-
- <div className="mt-4 space-y-3">
- <div>
- <div className="flex items-center justify-between mb-1.5">
- <span className="text-xs font-semibold text-zinc-200 uppercase tracking-wider">Authorized IP Ranges &amp; CIDRs</span>
- <span className="badge font-mono text-[10px]">{scope.length} range{scope.length === 1 ? "" : "s"}</span>
- </div>
- {scope.length > 0 ? (
- <div className="flex flex-wrap gap-1.5">
- {scope.map((cidr) => (
- <span
- key={cidr}
- className="badge badge-info font-mono text-xs px-2.5 py-1 flex items-center gap-1.5"
- >
- <Radio size={11} className="text-cyan-400" />
- <span>{cidr}</span>
- </span>
- ))}
- </div>
- ) : (
- <p className="text-xs text-zinc-500 italic">No network CIDRs declared for this campaign.</p>
- )}
- </div>
-
- {targets.length > 0 && (
- <div>
- <div className="flex items-center justify-between mb-1.5">
- <span className="text-xs font-semibold text-zinc-200 uppercase tracking-wider">Target Hosts</span>
- <span className="badge font-mono text-[10px]">{targets.length} host{targets.length === 1 ? "" : "s"}</span>
- </div>
- <div className="flex flex-wrap gap-1.5">
- {targets.map((tgt) => (
- <span
- key={tgt}
- className="badge font-mono text-xs px-2 py-0.5 flex items-center gap-1 text-zinc-200"
- >
- <Target size={11} className="text-emerald-400" />
- <span>{tgt}</span>
- </span>
- ))}
- </div>
- </div>
- )}
-
- <div>
- <div className="flex items-center justify-between mb-1.5">
- <span className="text-xs font-semibold text-zinc-200 uppercase tracking-wider">Excluded Hosts / Out-of-Scope</span>
- <span className="badge font-mono text-[10px]">{excluded.length} excluded</span>
- </div>
- {excluded.length > 0 ? (
- <div className="flex flex-wrap gap-1.5">
- {excluded.map((host) => (
- <span
- key={host}
- className="badge badge-high font-mono text-xs px-2.5 py-1 flex items-center gap-1.5 border-rose-500/30 bg-rose-950/20 text-rose-300"
- >
- <MinusCircle size={12} className="text-rose-400" />
- <span>{host}</span>
- </span>
- ))}
- </div>
- ) : (
- <div className="text-xs text-zinc-500 italic flex items-center gap-1.5">
- <ShieldCheck size={13} className="text-zinc-600" />
- <span>None declared (all addresses within defined CIDRs are active scope)</span>
- </div>
- )}
- </div>
- </div>
-
- <div className="mt-4 pt-3 border-t border-zinc-800/80">
- <button
- type="button"
- onClick={() => setShowRaw(!showRaw)}
- className="btn btn-compact text-[11px] py-1 px-2.5 text-zinc-400 hover:text-zinc-200 flex items-center gap-1.5"
- >
- <FileText size={12} />
- <span>{showRaw ? "Hide Raw Scope JSON" : "View Raw Scope JSON"}</span>
- <ChevronDown size={12} className={`transition-transform duration-200 ${showRaw ? "rotate-180" : ""}`} />
- </button>
- {showRaw && (
- <div className="mt-2">
- <StructuredJsonViewer data={campaign} title="Campaign Scope & Target Configuration" maxHeightClass="max-h-72" />
- </div>
- )}
- </div>
- </div>
- );
-}
-
-function CampaignPicker({
- campaigns,
- value,
- onChange,
- id,
- hasError,
- className
-}: {
- campaigns: Campaign[];
- value: string;
- onChange: (id: string) => void;
- id?: string;
- hasError?: boolean;
- className?: string;
-}) {
- const safeValue = value && campaigns.some((c) => c.id === value) ? value : "";
- return (
- <select
- id={id}
- className={`field ${hasError ? "border-rose-500/70 focus:border-rose-500" : ""} ${className ?? ""}`.trim()}
- value={safeValue}
- onChange={(event) => onChange(event.target.value)}
- >
- <option value="">Select campaign</option>
- {campaigns.map((campaign) => (
- <option key={campaign.id} value={campaign.id}>
- {campaign.name || campaign.id}
- </option>
- ))}
- </select>
- );
-}
-
-function StatusBadge({ status }: { status?: string }) {
- const normalized = String(status ?? "").toLowerCase();
- const isOk = ["active", "running", "ready", "restored", "complete", "completed"].some((item) => normalized.includes(item));
- const isWarn = ["paused", "pending", "draft", "created"].some((item) => normalized.includes(item));
- const isDanger = ["failed", "deleted", "blocked", "error"].some((item) => normalized.includes(item));
- const toneClass = isOk ? "badge badge-low" : isDanger ? "badge badge-high" : isWarn ? "badge badge-medium" : "badge";
- const dotColor = isOk ? "bg-emerald-400" : isDanger ? "bg-rose-400" : isWarn ? "bg-amber-400" : "bg-zinc-400";
- return (
- <span className={toneClass}>
- <span className={`inline-block h-1.5 w-1.5 rounded-full ${dotColor}`} />
- <span>{status ?? "created"}</span>
- </span>
- );
-}
-
-export function NoiseProfileBadge({ noise }: { noise?: string }) {
- const normalized = String(noise ?? "stealth").toLowerCase();
- const isNoisy = normalized.includes("noisy") || normalized.includes("critical") || normalized.includes("high");
- const isEvasive = normalized.includes("evasive") || normalized.includes("medium");
- const isStealth = normalized.includes("stealth") || normalized.includes("low");
- const badgeClass = isNoisy ? "badge badge-high" : isEvasive ? "badge badge-medium" : isStealth ? "badge badge-low" : "badge";
- return (
- <span className={`${badgeClass} font-mono text-[11px] uppercase tracking-wider`}>
- {noise ?? "stealth"}
- </span>
- );
-}
-
-function CampaignTable({
- campaigns,
- scopedCampaignId,
- onClearScope,
- onSelectCampaign
-}: {
- campaigns: Campaign[];
- scopedCampaignId?: string;
- onClearScope?: () => void;
- onSelectCampaign?: (id: string) => void;
-}) {
- return (
- <section className="panel table-panel">
- <SectionHeader
- title={scopedCampaignId ? "Scoped Campaign Activity" : "Campaign Activity"}
- action={
- <div className="flex items-center gap-2">
- {scopedCampaignId && onClearScope ? (
- <button
- type="button"
- onClick={onClearScope}
- className="btn btn-compact text-xs font-mono"
- title="Reset scope filter to display all campaigns"
- >
- Show All Campaigns
- </button>
- ) : null}
- <span className="badge">{campaigns.length} record{campaigns.length === 1 ? "" : "s"}</span>
- </div>
- }
- />
- {campaigns.length > 0 ? (
- <div className="table-scroll">
- <table className="table">
- <thead><tr><th>#</th><th>Name</th><th>Client</th><th>Status</th><th>Noise</th><th>Operator</th></tr></thead>
- <tbody>
- {campaigns.map((campaign, index) => (
- <tr
- key={campaign.id}
- className={`campaign-table-row ${campaign.id === scopedCampaignId ? "is-selected" : ""} ${onSelectCampaign ? "cursor-pointer" : ""}`}
- onClick={() => onSelectCampaign?.(campaign.id)}
- title={onSelectCampaign ? `Filter dashboard to ${campaign.name}` : undefined}
- >
- <td className="muted-cell">#{String(index + 1).padStart(2, "0")}</td>
- <td>
- <div className="font-semibold text-zinc-100 text-sm tracking-tight">{campaign.name}</div>
- <div className="mt-1 flex items-center gap-1.5 text-xs">
- <span className="font-mono text-[11px] text-zinc-400 bg-zinc-900/90 px-1.5 py-0.5 rounded border border-zinc-800/80">
- {campaign.id.slice(0, 12)}
- </span>
- </div>
- </td>
- <td className="text-zinc-300 text-sm">{campaign.client || "Internal"}</td>
- <td><StatusBadge status={campaign.status} /></td>
- <td><NoiseProfileBadge noise={campaign.noise_profile} /></td>
- <td className="text-zinc-400 text-sm font-mono">{campaign.operator || "operator"}</td>
- </tr>
- ))}
- </tbody>
- </table>
- </div>
- ) : (
- <EmptyState text="No campaigns yet. Create one from the Campaigns page to unlock modules, reports, and graph views." />
- )}
- </section>
- );
-}
-
-function FindingsTable({ findings }: { findings: any[] }) {
- return (
- <section className="panel table-panel">
- <SectionHeader
- title="Findings"
- action={<span className="badge">{findings.length} records</span>}
- />
- {findings.length > 0 ? (
- <div className="table-scroll">
- <table className="table">
- <thead><tr><th>Severity</th><th>Title</th><th>Module</th><th>MITRE</th><th>Host</th></tr></thead>
- <tbody>
- {findings.map((finding, index) => (
- <tr key={finding.id ?? index}>
- <td><span className={opsecBadge(finding.severity)}>{finding.severity ?? "info"}</span></td>
- <td className="font-semibold text-zinc-100 text-sm">{finding.title ?? `Finding ${index + 1}`}</td>
- <td className="text-zinc-300 font-mono text-xs">{finding.module_id ?? "n/a"}</td>
- <td className="text-zinc-300 font-mono text-xs">{finding.mitre_technique ?? "n/a"}</td>
- <td className="text-zinc-400 text-sm">{finding.host ?? "n/a"}</td>
- </tr>
- ))}
- </tbody>
- </table>
- </div>
- ) : (
- <EmptyState text="No findings recorded for this campaign." />
- )}
- </section>
- );
-}
-
-function LiveEventCard({
- event,
- index,
- campaigns
-}: {
- event: unknown;
- index: number;
- campaigns?: Campaign[];
-}) {
- const record = event && typeof event === "object" && !Array.isArray(event) ? event as Record<string, unknown> : null;
- const type = String(record?.type ?? record?.event ?? record?.name ?? `event.${index + 1}`);
- const message = String(record?.message ?? record?.status ?? record?.detail ?? "Campaign event received.");
- const campaign = typeof record?.campaign_id === "string" ? record.campaign_id : "";
- const matchedCampaign = campaigns?.find((c) => c.id === campaign);
- const campaignLabel = matchedCampaign?.name ? matchedCampaign.name : (campaign ? `Campaign ${campaign.slice(0, 8)}` : "");
- const moduleId = typeof record?.module_id === "string" ? record.module_id : "";
- const created = typeof record?.timestamp === "number"
- ? formatTimestamp(record.timestamp)
- : typeof record?.created_at === "string"
- ? formatDateTime(record.created_at)
- : "";
-
- return (
- <article className="event-card">
- <div className="event-marker" aria-hidden="true" />
- <div className="min-w-0">
- <div className="flex flex-wrap items-center gap-2">
- <strong>{type}</strong>
- {campaignLabel ? <span className="badge">{campaignLabel}</span> : null}
- {moduleId ? <span className="badge">{moduleId}</span> : null}
- </div>
- <p>{message}</p>
- {created ? <small>{created}</small> : null}
- <details className="advanced-details compact mt-2">
- <summary className="text-[11px] font-mono text-zinc-400 hover:text-zinc-200 cursor-pointer">Telemetry Details</summary>
- <div className="mt-1.5">
- <StructuredJsonViewer
- data={serializeError(event)}
- title="Event Telemetry"
- defaultExpandedDepth={1}
- maxHeightClass="max-h-56"
- showSummaryStrip={false}
- />
- </div>
- </details>
- </div>
- </article>
- );
-}
-
-function ParamForm({
- schema,
- values,
- onChange,
- requiredOverrides
-}: {
- schema: ModuleMeta["param_schema"];
- values: Record<string, unknown>;
- onChange: (values: Record<string, unknown>) => void;
- requiredOverrides?: Record<string, boolean>;
-}) {
- const entries = Object.entries(schema ?? {});
- if (entries.length === 0) {
- return <EmptyState text="No parameters" />;
- }
- return (
- <div className="grid gap-3">
- {entries.map(([name, field]) => {
- const required = requiredOverrides?.[name] ?? field.required;
- const inputField = required === field.required ? field : { ...field, required };
- const description = fieldDescription(name, field);
- const isBool = field.type === "boolean";
-
- const inputId = `param_${name}`;
- if (isBool) {
- return (
- <div className="flex items-center gap-2.5 py-1 text-xs text-zinc-300" key={name}>
- <input
- id={inputId}
- name={inputId}
- type="checkbox"
- checked={Boolean(values[name] ?? field.default)}
- onChange={(event) => {
- onChange({ ...values, [name]: event.target.checked });
- }}
- />
- <label htmlFor={inputId} className="font-mono text-xs text-zinc-200 cursor-pointer select-none">
- {name}
- </label>
- {!required && <span className="text-[10px] font-mono text-zinc-500">(optional)</span>}
- {description && <span className="text-[11px] text-zinc-500">({description})</span>}
- </div>
- );
- }
-
- return (
- <div className="block" key={name}>
- <div className="flex items-center justify-between gap-2 mb-1">
- <label htmlFor={inputId} className="font-mono text-xs text-zinc-300 cursor-pointer select-none">
- {name}
- {required && <span className="text-rose-500 font-sans ml-1">*</span>}
- </label>
- {!required && <span className="text-[10px] font-mono text-zinc-500">optional</span>}
- </div>
- <ParamInput
- id={inputId}
- name={name}
- field={inputField}
- value={values[name]}
- onChange={(value) => {
- const next = { ...values };
- if (!required && isEmptyParamValue(value)) {
- delete next[name];
- } else {
- next[name] = value;
- }
- onChange(next);
- }}
- />
- {description && (
- <span className="mt-1 block text-[11px] text-zinc-500 leading-snug">
- {description}
- </span>
- )}
- </div>
- );
- })}
- </div>
- );
-}
-
-function ParamInput({
- id,
- name,
- field,
- value,
- onChange
-}: {
- id?: string;
- name: string;
- field: ParamField;
- value: unknown;
- onChange: (value: unknown) => void;
-}) {
- const inputId = id ?? `param_${name}`;
- if (field.type === "boolean") {
- return (
- <input
- id={inputId}
- name={inputId}
- className="ml-2 cursor-pointer"
- type="checkbox"
- checked={Boolean(value)}
- required={field.required}
- onChange={(event) => onChange(event.target.checked)}
- />
- );
- }
- if (field.type === "array") {
- return (
- <textarea
- id={inputId}
- name={inputId}
- className="field mt-1 min-h-20"
- value={Array.isArray(value) ? value.join(", ") : String(value ?? "")}
- placeholder={paramPlaceholder(name, field)}
- required={field.required}
- autoComplete="off"
- spellCheck={false}
- onInvalid={setRequiredMessage}
- onChange={(event) => {
- clearValidationMessage(event);
- onChange(parseArrayParam(event.target.value, field));
- }}
- />
- );
- }
- const type = field.secret ? "password" : field.type === "integer" || field.type === "number" ? "number" : "text";
- return (
- <input
- id={inputId}
- name={inputId}
- className="field mt-1"
- type={type}
- value={String(value ?? "")}
- min={field.min}
- max={field.max}
- placeholder={paramPlaceholder(name, field)}
- required={field.required}
- autoComplete={field.secret ? "new-password" : "off"}
- autoCorrect="off"
- autoCapitalize="off"
- spellCheck={false}
- data-lpignore="true"
- data-form-type="other"
- onInvalid={setRequiredMessage}
- onChange={(event) => {
- clearValidationMessage(event);
- if (type === "number") {
- onChange(event.target.value === "" ? undefined : Number(event.target.value));
- return;
- }
- onChange(event.target.value === "" ? undefined : event.target.value);
- }}
- />
- );
-}
-
-function fieldDefaultHint(field: ParamField): string {
- if (field.secret || field.default === undefined) {
- return "";
- }
- const value = formatDefaultValue(field.default);
- return value ? `Default: ${value}` : "";
-}
-
-function paramPlaceholder(name: string, field: ParamField): string {
- if (!field.secret) {
- const value = formatDefaultValue(field.default);
- if (value) {
- return value;
- }
- }
- const lower = name.toLowerCase();
- if (lower === "target_user" && field.description === "Required target user or SPN; run ad.enum_spn first") {
- return "svc-sql or MSSQLSvc/sql01.lab.local:1433";
- }
- if (lower.includes("target")) {
- return "127.0.0.1";
- }
- if (lower.includes("port")) {
- return "80, 443, 8080, 8443, 8888";
- }
- if (lower.includes("domain")) {
- return "corp.local";
- }
- return field.required ? "" : "Leave blank to use the module default";
-}
-
-function fieldDescription(name: string, field: ParamField): string | undefined {
- if (name === "target_user" && field.description === "Required target user or SPN; run ad.enum_spn first") {
- return "Required target user or SPN; run ad.enum_spn first.";
- }
- if (name === "timeout") {
- return (field.description ? `${field.description}. ` : "") + "Recommendation: use 2.5s - 3.0s for virtual lab / VM targets.";
- }
- if (name === "ports" && (!field.description || field.description.includes("Port spec"))) {
- return "Comma-separated ports (e.g. 88, 389, 445) or presets (top1000). Required for service detection.";
- }
- return field.description;
-}
-
-function formatDefaultValue(value: unknown): string {
- if (value === undefined || value === null || value === "") {
- return "";
- }
- if (Array.isArray(value)) {
- return value.join(", ");
- }
- if (typeof value === "boolean") {
- return value ? "true" : "false";
- }
- if (typeof value === "object") {
- return JSON.stringify(value);
- }
- return String(value);
-}
-
-function ScreenMessage({ title, body }: { title: string; body: string }) {
- return (
- <div className="grid min-h-screen place-items-center bg-zinc-950 p-4 text-zinc-100">
- <div className="rounded-xl border border-zinc-800 bg-zinc-900/60 p-6 text-center shadow-sm">
- <h1 className="text-lg font-semibold tracking-tight text-zinc-100">{title}</h1>
- <p className="mt-1 text-xs text-zinc-400">{body}</p>
- </div>
- </div>
- );
-}
-
-function EmptyState({ text }: { text: string }) {
- return <div className="empty-state">{text}</div>;
-}
-
-function strategyBackendHint(backend: string): string {
- if (backend === "openai") {
- return "OpenAI planning requires OPENAI_API_KEY in the ARES server environment. Security-page API keys do not count as LLM provider keys.";
- }
- if (backend === "local") {
- return "Local planning uses Ollama from the ARES server host, usually http://localhost:11434. No cloud LLM key is required.";
- }
- return "Claude planning requires ANTHROPIC_API_KEY in the ARES server environment. Security-page API keys only authenticate callers to ARES.";
-}
-
-function moduleRunHint(
- campaignId: string,
- module: ModuleMeta | undefined,
- campaign: Campaign | undefined,
- sensitive: boolean,
- confirmed: boolean,
- dryRun: boolean
-): string {
- if (!campaignId) {
- return "Select a campaign before running a module.";
- }
- if (!module) {
- return "Select a module from the catalog.";
- }
- if (!campaign) {
- return "Campaign details are still loading.";
- }
- if (sensitive && !confirmed) {
- return "Confirm authorization before running high-noise or sensitive modules.";
- }
- if (!dryRun && "target" in (module.param_schema ?? {}) && campaignScopeEntries(campaign).length === 0) {
- return "Live target modules require campaign scope CIDRs. Add a scope such as 127.0.0.1/32 before running.";
- }
- return "";
-}
-
-function splitLines(value: string): string[] {
- return value
- .split(/\r?\n|,/)
- .map((item) => item.trim())
- .filter(Boolean);
-}
-
-function findInvalidScopeEntries(value: string): string[] {
- return splitLines(value).filter((entry) => !looksLikeScopeEntry(entry));
-}
-
-function looksLikeScopeEntry(entry: string): boolean {
- if (entry.includes(":")) {
- return true;
- }
- const [address, prefix] = entry.split("/");
- if (!isIpv4Address(address)) {
- return false;
- }
- if (prefix === undefined) {
- return true;
- }
- if (!/^\d{1,2}$/.test(prefix)) {
- return false;
- }
- const value = Number(prefix);
- return value >= 0 && value <= 32;
-}
-
-function parseArrayParam(value: string, field: ParamField): unknown[] | undefined {
- const entries = splitLines(value);
- if (entries.length === 0) {
- return undefined;
- }
- const itemType = field.items?.type ?? "string";
- if (itemType === "integer" || itemType === "number") {
- const numericEntries = entries.map((entry) => Number(entry));
- return numericEntries.every((entry) => Number.isFinite(entry)) ? numericEntries : entries;
- }
- return entries;
-}
-
-function isEmptyParamValue(value: unknown): boolean {
- return value === undefined || value === "" || (Array.isArray(value) && value.length === 0);
-}
-
-function moduleScopeWarning(
- module: ModuleMeta | undefined,
- campaign: Campaign | undefined,
- values: Record<string, unknown>,
- dryRun: boolean
-): string {
- if (!module || !campaign || dryRun || !("target" in (module.param_schema ?? {}))) {
- return "";
- }
- const target = typeof values.target === "string" ? values.target.trim() : "";
- if (!target) {
- return "";
- }
- const scope = campaignScopeEntries(campaign);
- if (scope.length === 0) {
- return "Selected campaign has no scope CIDRs. Add a scoped campaign such as 127.0.0.1/32 before running target modules.";
- }
- if (isIpv4Address(target) && scope.every(looksLikeScopeEntry) && !scope.some((entry) => ipv4InScope(target, entry))) {
- return `Target ${target} is outside the selected campaign scope (${scope.join(", ")}).`;
- }
- return "";
-}
-
-function campaignScopeEntries(campaign: Campaign): string[] {
- if (Array.isArray(campaign.scope_cidrs)) {
- return campaign.scope_cidrs.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
- }
- const rawScope = campaign.scope;
- if (Array.isArray(rawScope)) {
- return rawScope
- .map((entry) => {
- if (typeof entry === "string") {
- return entry;
- }
- if (entry && typeof entry === "object" && "cidr" in entry && typeof entry.cidr === "string") {
- return entry.cidr;
- }
- return "";
- })
- .filter(Boolean);
- }
- if (typeof campaign.scope_json === "string" && campaign.scope_json.trim()) {
- try {
- const parsed = JSON.parse(campaign.scope_json) as unknown;
- if (Array.isArray(parsed)) {
- return parsed
- .map((entry) => {
- if (typeof entry === "string") {
- return entry;
- }
- if (entry && typeof entry === "object" && "cidr" in entry && typeof entry.cidr === "string") {
- return entry.cidr;
- }
- return "";
- })
- .filter(Boolean);
- }
- } catch {
- return [];
- }
- }
- return [];
-}
-
-function campaignTargets(campaign: Campaign): string[] {
- if (Array.isArray(campaign.targets)) {
- return campaign.targets.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
- }
- if (typeof campaign.targets_json === "string" && campaign.targets_json.trim()) {
- try {
- const parsed = JSON.parse(campaign.targets_json) as unknown;
- if (Array.isArray(parsed)) {
- return parsed.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
- }
- } catch {
- return [];
- }
- }
- return [];
-}
-
-function campaignExcludedHosts(campaign: Campaign): string[] {
- const explicit = campaign as { excluded_hosts?: unknown; excluded?: unknown };
- if (Array.isArray(explicit.excluded_hosts)) {
- return explicit.excluded_hosts.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
- }
- if (Array.isArray(explicit.excluded)) {
- return explicit.excluded.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
- }
- if (typeof campaign.scope_json === "string" && campaign.scope_json.trim()) {
- try {
- const parsed = JSON.parse(campaign.scope_json) as Record<string, unknown>;
- if (parsed && Array.isArray(parsed.excluded_hosts)) {
- return parsed.excluded_hosts.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
- }
- if (parsed && Array.isArray(parsed.excluded)) {
- return parsed.excluded.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
- }
- } catch {
- return [];
- }
- }
- return [];
-}
-
-function ipv4InScope(ip: string, cidr: string): boolean {
- const [network, prefixText = "32"] = cidr.split("/");
- if (!isIpv4Address(network) || !/^\d{1,2}$/.test(prefixText)) {
- return false;
- }
- const prefix = Number(prefixText);
- if (prefix < 0 || prefix > 32) {
- return false;
- }
- const mask = prefix === 0 ? 0 : (0xffffffff << (32 - prefix)) >>> 0;
- return (ipv4ToNumber(ip) & mask) === (ipv4ToNumber(network) & mask);
-}
-
-function ipv4ToNumber(ip: string): number {
- return ip.split(".").reduce((acc, part) => ((acc << 8) + Number(part)) >>> 0, 0);
-}
-
-function isIpv4Address(value: string): boolean {
- const parts = value.split(".");
- return parts.length === 4 && parts.every((part) => {
- if (!/^\d{1,3}$/.test(part)) {
- return false;
- }
- const number = Number(part);
- return number >= 0 && number <= 255;
- });
-}
-
-function unique(values: string[]): string[] {
- return [...new Set(values.filter(Boolean))].sort();
-}
-
-function safeJson(value: string): Record<string, unknown> {
- try {
- const parsed = JSON.parse(value) as unknown;
- return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed as Record<string, unknown> : {};
- } catch {
- return {};
- }
-}
-
-function isJsonObject(value: string): boolean {
- try {
- const parsed = JSON.parse(value) as unknown;
- return Boolean(parsed && typeof parsed === "object" && !Array.isArray(parsed));
- } catch {
- return false;
- }
-}
-
-function isSensitiveModule(module?: ModuleMeta): boolean {
- if (!module) {
- return false;
- }
- const text = `${module.id} ${module.category ?? ""} ${module.opsec_level ?? ""}`.toLowerCase();
- return (
- text.includes("high_noise") ||
- text.includes("credential") ||
- text.includes("persistence") ||
- text.includes("edr") ||
- text.includes("dcsync")
- );
-}
-
-function statusBadge(status?: string): string {
- const normalized = String(status ?? "").toLowerCase();
- if (["active", "running", "ready", "restored", "complete", "completed"].some((item) => normalized.includes(item))) {
- return "badge badge-low";
- }
- if (["failed", "deleted", "blocked", "error"].some((item) => normalized.includes(item))) {
- return "badge badge-high";
- }
- if (["paused", "pending", "draft", "created"].some((item) => normalized.includes(item))) {
- return "badge badge-medium";
- }
- return "badge";
-}
-
-export function opsecBadge(level?: string): string {
- const normalized = String(level ?? "").toLowerCase().trim();
- if (!normalized || normalized === "n/a" || normalized === "none" || normalized === "unknown") {
- return "badge";
- }
- if (normalized.includes("high") || normalized.includes("critical") || normalized.includes("alarm")) {
- return "badge badge-high";
- }
- if (normalized.includes("medium") || normalized.includes("moderate") || normalized.includes("warn")) {
- return "badge badge-medium";
- }
- if (normalized.includes("low") || normalized.includes("safe") || normalized.includes("info") || normalized.includes("stealth") || normalized.includes("minimal")) {
- return "badge badge-low";
- }
- return "badge";
-}
-
-function serializeError(value: unknown): unknown {
- if (value instanceof ApiError) {
- const idempotencyKey = "idempotencyKey" in value
- && typeof value.idempotencyKey === "string"
- ? value.idempotencyKey
- : undefined;
- return {
- name: value.name,
- status: value.status,
- detail: value.detail,
- ...(idempotencyKey ? { idempotency_key: idempotencyKey } : {})
- };
- }
- if (value instanceof Error) {
- const idempotencyKey = "idempotencyKey" in value
- && typeof value.idempotencyKey === "string"
- ? value.idempotencyKey
- : undefined;
- return {
- name: value.name,
- message: value.message,
- ...(idempotencyKey ? { idempotency_key: idempotencyKey } : {})
- };
- }
- return value;
-}
-
-function readableError(value: unknown, fallback: string): string {
- if (value instanceof ApiError) {
- if (typeof value.detail === "string") {
- return value.detail;
- }
- return value.message || fallback;
- }
- if (value instanceof Error) {
- return value.message || fallback;
- }
- if (typeof value === "string") {
- return value;
- }
- return fallback;
-}
-
-function pdfFailureHint(value: unknown): string {
- if (!value) return "";
- const serialized = serializeError(value);
- const text = typeof serialized === "string"
- ? serialized
- : JSON.stringify(serialized);
- const normalized = text.toLowerCase();
- if (normalized.includes("elevated windows") || normalized.includes("administrator powershell")) {
- return "PDF export is blocked from this elevated Windows session. Run PowerShell normally, or set ARES_PDF_BROWSER to a working non-Edge browser.";
- }
- if (
- normalized.includes("gtk")
- || normalized.includes("pango")
- || normalized.includes("libgobject")
- ) {
- return "WeasyPrint needs native GTK/Pango libraries on Windows. Use the browser fallback from normal PowerShell or install those native libraries.";
- }
- if (normalized.includes("no downloadable pdf") || normalized.includes("pdf smoke")) {
- return "PDF export did not create a valid artifact. Run ares doctor --pdf-smoke to verify the local PDF backend and browser fallback.";
- }
- return "";
-}
+export { OverviewPage } from "./pages/OverviewPage";
+export { CampaignsPage } from "./pages/CampaignsPage";
+export { ModulesPage } from "./pages/ModulesPage";
+export { ReportsPage } from "./pages/ReportsPage";
+export { TemplatesPage } from "./pages/TemplatesPage";
+export { StrategyPage } from "./pages/StrategyPage";
+export { SecurityPage } from "./pages/SecurityPage";
+export { EdrPage } from "./pages/EdrPage";
+export { LivePage } from "./pages/LivePage";
diff --git a/frontend/src/features/dashboard/DashboardRouter.tsx b/frontend/src/features/dashboard/DashboardRouter.tsx
index c61f359..c264ac3 100644
--- a/frontend/src/features/dashboard/DashboardRouter.tsx
+++ b/frontend/src/features/dashboard/DashboardRouter.tsx
@@ -1,23 +1,29 @@
import { Loader2 } from "lucide-react";
-import { lazy, Suspense } from "react";
-import { useEffect } from "react";
+import { lazy, Suspense, useEffect } from "react";
import { Navigate, Route, Routes, useNavigate } from "react-router-dom";
-import {
- CampaignsPage,
- DashboardShell,
- EdrPage,
- LivePage,
- ModulesPage,
- OverviewPage,
- ReportsPage,
- SecurityPage,
- StrategyPage,
- TemplatesPage
-} from "./DashboardPages";
+import { DashboardShell } from "./DashboardPages";
import { LoginPage } from "../auth/LoginPage";
import { useDashboardUi } from "./dashboardUiState";
+const OverviewPage = lazy(() => import("./pages/OverviewPage"));
+const CampaignsPage = lazy(() => import("./pages/CampaignsPage"));
+const ModulesPage = lazy(() => import("./pages/ModulesPage"));
+const ReportsPage = lazy(() => import("./pages/ReportsPage"));
const GraphPage = lazy(() => import("../graph/GraphPage"));
+const TemplatesPage = lazy(() => import("./pages/TemplatesPage"));
+const StrategyPage = lazy(() => import("./pages/StrategyPage"));
+const SecurityPage = lazy(() => import("./pages/SecurityPage"));
+const EdrPage = lazy(() => import("./pages/EdrPage"));
+const LivePage = lazy(() => import("./pages/LivePage"));
+
+function PageFallback({ label }: { label?: string }) {
+ return (
+ <div className="panel p-4 loading-row" role="status" aria-live="polite">
+ <Loader2 className="spin" size={18} />
+ <span>Loading {label || "view"}…</span>
+ </div>
+ );
+}
function DashboardRoutes() {
const { selectedCampaignId, setSelectedCampaignId } = useDashboardUi();
@@ -28,26 +34,26 @@ function DashboardRoutes() {
}, [navigate]);
return (
- <Routes>
- <Route path="/" element={<OverviewPage />} />
- <Route path="/playbooks" element={<Navigate to="/modules" replace />} />
- <Route path="/campaigns" element={<CampaignsPage />} />
- <Route path="/modules" element={<ModulesPage />} />
- <Route path="/reports" element={<ReportsPage />} />
- <Route
- path="/graph"
- element={(
- <Suspense fallback={<div className="panel p-4 loading-row"><Loader2 className="spin" size={18} /> Loading graph renderer…</div>}>
+ <Suspense fallback={<PageFallback />}>
+ <Routes>
+ <Route path="/" element={<OverviewPage />} />
+ <Route path="/playbooks" element={<Navigate to="/modules" replace />} />
+ <Route path="/campaigns" element={<CampaignsPage />} />
+ <Route path="/modules" element={<ModulesPage />} />
+ <Route path="/reports" element={<ReportsPage />} />
+ <Route
+ path="/graph"
+ element={(
<GraphPage campaignId={selectedCampaignId} onCampaignIdChange={setSelectedCampaignId} />
- </Suspense>
- )}
- />
- <Route path="/templates" element={<TemplatesPage />} />
- <Route path="/strategy" element={<StrategyPage />} />
- <Route path="/security" element={<SecurityPage />} />
- <Route path="/edr" element={<EdrPage />} />
- <Route path="/live" element={<LivePage />} />
- </Routes>
+ )}
+ />
+ <Route path="/templates" element={<TemplatesPage />} />
+ <Route path="/strategy" element={<StrategyPage />} />
+ <Route path="/security" element={<SecurityPage />} />
+ <Route path="/edr" element={<EdrPage />} />
+ <Route path="/live" element={<LivePage />} />
+ </Routes>
+ </Suspense>
);
}
diff --git a/frontend/src/features/dashboard/dashboardComponents.tsx b/frontend/src/features/dashboard/dashboardComponents.tsx
new file mode 100644
index 0000000..e8dc2ae
--- /dev/null
+++ b/frontend/src/features/dashboard/dashboardComponents.tsx
@@ -0,0 +1,2659 @@
+import {
+ AlertTriangle,
+ ArrowRight,
+ Check,
+ CheckCircle2,
+ ChevronDown,
+ Copy,
+ Eye,
+ EyeOff,
+ FileText,
+ Info,
+ Key,
+ Loader2,
+ MinusCircle,
+ Radio,
+ ShieldCheck,
+ Target,
+ Terminal,
+ X,
+} from "lucide-react";
+import {
+ ChangeEvent,
+ FormEvent,
+ KeyboardEvent,
+ ReactNode,
+ useCallback,
+ useState,
+} from "react";
+import {
+ ApiError,
+} from "../../api/client";
+import type {
+ Campaign,
+ Finding,
+ ModuleMeta,
+ MonthlyFindingStats,
+ ParamField,
+} from "../../api/types";
+import { StructuredJsonViewer } from "../../components/common/StructuredJsonViewer";
+
+export interface PersistedResult {
+ key: string;
+ payload: unknown;
+ isError?: boolean;
+}
+
+export interface ModuleRunRecord {
+ campaignId: string;
+ moduleId: string;
+ payload: unknown;
+ isError?: boolean;
+}
+
+export interface GeneratedApiKey {
+ id?: string;
+ key: string;
+ note?: string;
+ prefix?: string;
+}
+
+export type ApiKeyCopyStatus = "idle" | "copied" | "manual";
+
+export const REQUIRED_FIELD_MESSAGE = "This field is required.";
+
+export type ValidatableElement = HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
+export type TelemetryMetricMap = Record<string, boolean | number | string | null | undefined>;
+export interface TelemetrySnapshot {
+ modules?: TelemetryMetricMap;
+ queue?: TelemetryMetricMap;
+ workers?: TelemetryMetricMap;
+ latency_ms?: TelemetryMetricMap;
+ throughput?: TelemetryMetricMap;
+ findings?: number;
+ credentials?: number;
+ hosts?: TelemetryMetricMap;
+ campaign_id?: string;
+ timestamp?: number;
+ [key: string]: unknown;
+}
+
+export interface TemplatePlanStage {
+ name?: string;
+ modules?: string[];
+ params?: Record<string, unknown>;
+}
+
+export interface TemplatePlanResponse {
+ template?: string;
+ description?: string;
+ plan?: {
+ stages?: TemplatePlanStage[];
+ };
+ global_params?: Record<string, unknown>;
+ note?: string;
+}
+
+export const pageMeta: Record<string, { eyebrow: string; description: string }> = {
+ Overview: {
+ eyebrow: "Dashboard",
+ description: "Health, telemetry, campaigns, and activity."
+ },
+ Campaigns: {
+ eyebrow: "Operations",
+ description: "Scopes, status, findings, and comparisons."
+ },
+ Modules: {
+ eyebrow: "Operations",
+ description: "Catalog, OPSEC, and authorized runs."
+ },
+ Reports: {
+ eyebrow: "Operations",
+ description: "Evidence packages and artifacts."
+ },
+ Graph: {
+ eyebrow: "Intelligence",
+ description: "Entities, relationships, and attack paths."
+ },
+ Templates: {
+ eyebrow: "Intelligence",
+ description: "Reusable campaign plans."
+ },
+ Strategy: {
+ eyebrow: "Intelligence",
+ description: "Authorized objective planning."
+ },
+ Security: {
+ eyebrow: "Control",
+ description: "Account, API keys, audit, and users."
+ },
+ "EDR/OPSEC": {
+ eyebrow: "Control",
+ description: "Detection outcomes and OPSEC feedback."
+ },
+ "Live Events": {
+ eyebrow: "Control",
+ description: "Campaign events as they arrive."
+ }
+};
+
+export function formatDateTime(value: string): string {
+ const date = new Date(value);
+ return Number.isNaN(date.getTime()) ? value : date.toLocaleString();
+}
+
+export function setRequiredMessage<T extends ValidatableElement>(event: FormEvent<T>) {
+ event.currentTarget.setCustomValidity(REQUIRED_FIELD_MESSAGE);
+}
+
+export function clearValidationMessage<T extends ValidatableElement>(event: ChangeEvent<T>) {
+ event.currentTarget.setCustomValidity("");
+}
+
+export function Page({
+ title,
+ subtitle,
+ actions,
+ tabs,
+ activeTab,
+ onTabChange,
+ children
+}: {
+ title: string;
+ subtitle?: ReactNode;
+ actions?: ReactNode;
+ tabs?: string[];
+ activeTab?: string;
+ onTabChange?: (tab: string) => void;
+ children: ReactNode;
+}) {
+ const [fallbackTab, setFallbackTab] = useState(tabs?.[0] ?? "");
+ const meta = pageMeta[title] ?? {
+ eyebrow: "ARES",
+ description: "Security dashboard workspace."
+ };
+ const selectedTab = activeTab ?? fallbackTab;
+ const setTab = useCallback((tab: string) => {
+ if (onTabChange) {
+ onTabChange(tab);
+ } else {
+ setFallbackTab(tab);
+ }
+ }, [onTabChange]);
+
+ function handleTabKeyDown(event: KeyboardEvent<HTMLDivElement>) {
+ if (!tabs || tabs.length === 0 || !["ArrowLeft", "ArrowRight", "Home", "End"].includes(event.key)) {
+ return;
+ }
+ event.preventDefault();
+ const currentIndex = Math.max(0, tabs.indexOf(selectedTab));
+ if (event.key === "Home") {
+ setTab(tabs[0]);
+ return;
+ }
+ if (event.key === "End") {
+ setTab(tabs[tabs.length - 1]);
+ return;
+ }
+ const offset = event.key === "ArrowRight" ? 1 : -1;
+ const nextIndex = (currentIndex + offset + tabs.length) % tabs.length;
+ setTab(tabs[nextIndex]);
+ }
+
+ return (
+ <div className="page">
+ <section className="page-header">
+ <div className="page-heading">
+ <div>
+ <p className="page-eyebrow">{meta.eyebrow}</p>
+ <h1>{title}</h1>
+ <p className="page-subtitle">{subtitle ?? meta.description}</p>
+ </div>
+ </div>
+ {actions ? <div className="page-actions">{actions}</div> : null}
+ </section>
+ {tabs ? (
+ <div className="page-tabs" aria-label={`${title} sections`} onKeyDown={handleTabKeyDown} role="tablist">
+ {tabs.map((tab) => (
+ <button
+ aria-selected={tab === selectedTab}
+ className={tab === selectedTab ? "active" : ""}
+ key={tab}
+ onClick={() => setTab(tab)}
+ role="tab"
+ tabIndex={tab === selectedTab ? 0 : -1}
+ type="button"
+ >
+ {tab}
+ </button>
+ ))}
+ </div>
+ ) : null}
+ <div className="page-content">{children}</div>
+ </div>
+ );
+}
+
+export function SectionHeader({
+ title,
+ eyebrow,
+ description,
+ action
+}: {
+ title: string;
+ eyebrow?: string;
+ description?: string;
+ action?: ReactNode;
+}) {
+ return (
+ <div className="section-header">
+ <div>
+ {eyebrow ? <p className="section-eyebrow">{eyebrow}</p> : null}
+ <h2>{title}</h2>
+ {description ? <p>{description}</p> : null}
+ </div>
+ {action ? <div className="section-action">{action}</div> : null}
+ </div>
+ );
+}
+
+export function MiniStat({ title, value, detail, icon }: { title: string; value: string; detail?: string; icon?: ReactNode }) {
+ return (
+ <div className="mini-stat">
+ <div>
+ <span>{title}</span>
+ <strong>{value}</strong>
+ {detail ? <small>{detail}</small> : null}
+ </div>
+ {icon ? <div className="mini-stat-icon">{icon}</div> : null}
+ </div>
+ );
+}
+
+export function HighlightRow({
+ label,
+ value,
+ detail,
+ tone = "neutral"
+}: {
+ label: string;
+ value: string;
+ detail: string;
+ tone?: "low" | "medium" | "high" | "neutral";
+}) {
+ return (
+ <div className="highlight-row">
+ <div>
+ <strong>{label}</strong>
+ <span>{detail}</span>
+ </div>
+ <span className={`highlight-value highlight-${tone}`}>{value}</span>
+ </div>
+ );
+}
+
+export function SparklineBars({ values }: { values: MonthlyFindingStats["series"] }) {
+ const max = Math.max(...values.map((value) => value.count), 1);
+ const labelDays = new Set([1, 7, 14, 21, 28, values.length]);
+ return (
+ <>
+ <div className="sparkline" aria-hidden="true">
+ {values.map((value) => (
+ <span
+ key={value.date}
+ title={`${formatMonthlyDate(value.date)} - ${value.count} ${value.count === 1 ? "security signal" : "security signals"}`}
+ style={{ height: value.count > 0 ? `${Math.max(6, (value.count / max) * 100)}%` : "0%" }}
+ />
+ ))}
+ </div>
+ <div className="sparkline-axis" aria-hidden="true">
+ {values.map((value) => {
+ const day = Number(value.date.slice(-2));
+ return <span key={value.date}>{labelDays.has(day) ? formatMonthlyDate(value.date) : null}</span>;
+ })}
+ </div>
+ </>
+ );
+}
+
+export function formatMonthlyDate(date: string): string {
+ const [year, month, day] = date.split("-").map(Number);
+ return new Intl.DateTimeFormat("en-GB", { day: "numeric", month: "short", timeZone: "UTC" }).format(
+ new Date(Date.UTC(year, month - 1, day))
+ );
+}
+
+export function metricNumber(map: TelemetryMetricMap | undefined, key: string): number {
+ return metricNumberOrNull(map, key) ?? 0;
+}
+
+export function metricNumberOrNull(map: TelemetryMetricMap | undefined, key: string): number | null {
+ const value = map?.[key];
+ if (typeof value === "number" && Number.isFinite(value)) return value;
+ if (typeof value === "string" && value.trim()) {
+ const parsed = Number(value);
+ return Number.isFinite(parsed) ? parsed : null;
+ }
+ return null;
+}
+
+export function formatMetric(value: number, suffix = ""): string {
+ if (!Number.isFinite(value)) return `0${suffix}`;
+ if (Number.isInteger(value)) return `${value}${suffix}`;
+ return `${value.toFixed(1)}${suffix}`;
+}
+
+export function formatRate(value: unknown): string {
+ if (typeof value !== "number" || !Number.isFinite(value)) {
+ return "not enough data";
+ }
+ const normalized = value <= 1 ? value * 100 : value;
+ return `${Math.round(normalized)}%`;
+}
+
+export function formatTimestamp(value: number | undefined): string {
+ if (!value) return "No runtime sample yet";
+ const ms = value > 1e11 ? value : value * 1000;
+ return new Date(ms).toLocaleString();
+}
+
+export function formatBytes(value: number): string {
+ if (!Number.isFinite(value)) return "n/a";
+ if (value < 1024) return `${value} B`;
+ const units = ["KB", "MB", "GB", "TB"];
+ let size = value / 1024;
+ let unitIndex = 0;
+ while (size >= 1024 && unitIndex < units.length - 1) {
+ size /= 1024;
+ unitIndex += 1;
+ }
+ return `${size >= 10 ? size.toFixed(0) : size.toFixed(1)} ${units[unitIndex]}`;
+}
+
+export function formatReportDate(value: number): string {
+ if (!Number.isFinite(value)) return "n/a";
+ const timestamp = value > 10_000_000_000 ? value : value * 1000;
+ return new Date(timestamp).toLocaleString();
+}
+
+export function formatReportTime(value: number): string {
+ if (!Number.isFinite(value)) return "n/a";
+ const timestamp = value > 10_000_000_000 ? value : value * 1000;
+ return new Date(timestamp).toLocaleTimeString([], { hour: "2-digit", minute: "2-digit", second: "2-digit" });
+}
+
+export function TelemetryPanel({ snapshot, loading, confirmedFindings }: { snapshot?: TelemetrySnapshot; loading: boolean; confirmedFindings: number }) {
+ const total = metricNumber(snapshot?.modules, "total");
+ const success = metricNumber(snapshot?.modules, "success");
+ const failed = metricNumber(snapshot?.modules, "failed");
+ const findings = confirmedFindings;
+ const successRate = total > 0 ? Math.round((success / total) * 100) : null;
+ const errorRate = total > 0 ? Math.min(100, Math.round(metricNumber(snapshot?.modules, "error_rate") * 100)) : null;
+ const p95 = metricNumberOrNull(snapshot?.latency_ms, "p95");
+ const queueDepth = metricNumber(snapshot?.queue, "depth");
+ const activeWorkers = metricNumber(snapshot?.workers, "active");
+ const unhealthyWorkers = metricNumber(snapshot?.workers, "unhealthy");
+ const hostsDiscovered = metricNumber(snapshot?.hosts, "discovered");
+ const hostsOwned = metricNumberOrNull(snapshot?.hosts, "owned");
+ const tasksPerMin = metricNumberOrNull(snapshot?.throughput, "tasks_per_min");
+ const workerTotal = activeWorkers + unhealthyWorkers;
+ const workerCapacity = workerTotal > 0 ? Math.round((activeWorkers / workerTotal) * 100) : null;
+ const hostsAvailable = snapshot?.hosts?.available === true;
+ const hostOwnership = hostsAvailable && hostsDiscovered > 0 && hostsOwned !== null
+ ? Math.round((hostsOwned / hostsDiscovered) * 100)
+ : null;
+ const throughputValue = tasksPerMin === null ? "n/a" : `${formatMetric(tasksPerMin)}/min`;
+ const latencyDetail = p95 === null ? "no run timing data" : `${formatMetric(p95, " ms")} p95`;
+
+ const isIngestionActive = Boolean(snapshot && snapshot.timestamp);
+ const ingestionDotClass = loading ? "pending" : isIngestionActive ? "active" : "pending";
+ const ingestionText = loading ? "Connecting..." : isIngestionActive ? "Ingestion Active" : "Awaiting Data";
+
+ return (
+ <section className="panel telemetry-panel">
+ <SectionHeader
+ title="Telemetry Report"
+ description={loading ? "Waiting for metrics." : `Last sample: ${formatTimestamp(snapshot?.timestamp)}`}
+ action={
+ <div className="telemetry-live-status" title="Real-time telemetry ingestion pipeline">
+ <span className={`status-indicator-dot ${ingestionDotClass}`} />
+ <span className="status-indicator-text">{ingestionText}</span>
+ {snapshot?.timestamp ? (
+ <span className="status-indicator-time font-mono">{formatReportTime(snapshot.timestamp)}</span>
+ ) : null}
+ </div>
+ }
+ />
+
+ <div className="telemetry-chart" aria-label="Runtime telemetry chart">
+ <TelemetryBar label="Success rate" value={successRate} />
+ <TelemetryBar label="Error rate" value={errorRate} tone="danger" />
+ <TelemetryBar label="Worker capacity" value={workerCapacity} />
+ <TelemetryBar label="Host ownership" value={hostOwnership} tone={hostsOwned !== null && hostsOwned > 0 ? "danger" : "ok"} />
+ </div>
+
+ <div className="mini-stat-grid mt-4">
+ <MiniStat title="Module runs" value={formatMetric(total)} detail={`${success} success / ${failed} failed`} />
+ <MiniStat title="Findings" value={formatMetric(findings)} />
+ <MiniStat title="Queue" value={formatMetric(queueDepth)} detail={`${activeWorkers} active workers`} />
+ <MiniStat title="Throughput" value={throughputValue} detail={latencyDetail} />
+ </div>
+
+ <div className="telemetry-footer">
+ <span>Scope: {snapshot?.campaign_id ? `campaign ${snapshot.campaign_id}` : "global"}</span>
+ <span>{hostsAvailable ? `${hostsDiscovered} discovered / ${hostsOwned ?? 0} owned hosts` : "Host ownership unavailable"}</span>
+ <span>{workerTotal === 0 ? "no worker sample" : unhealthyWorkers === 0 ? "workers healthy" : `${unhealthyWorkers} unhealthy workers`}</span>
+ </div>
+
+ <details className="advanced-details">
+ <summary className="text-xs text-zinc-400 hover:text-zinc-200 cursor-pointer mb-2">Telemetry Engine Payload</summary>
+ <StructuredJsonViewer data={snapshot ?? {}} title="Telemetry Engine Snapshot" maxHeightClass="max-h-64" />
+ </details>
+ </section>
+ );
+}
+
+export function TelemetryBar({ label, value, tone = "ok" }: { label: string; value: number | null; tone?: "ok" | "danger" }) {
+ const isNa = value === null;
+ const isZero = value === 0;
+ const clamped = isNa ? 0 : Math.max(0, Math.min(100, value));
+ const trackClass = `telemetry-bar-track ${isNa ? "is-na" : isZero ? "is-zero" : ""}`;
+ const valueLabel = isNa ? "n/a" : `${clamped}%`;
+ const valueClass = isNa ? "is-na font-mono" : isZero ? "is-zero font-mono" : "font-mono";
+
+ return (
+ <div className="telemetry-bar" title={isNa ? "No data yet" : isZero ? "0% (measured baseline)" : `${label}: ${clamped}%`}>
+ <span>{label}</span>
+ <div className={trackClass}>
+ <div className={tone === "danger" ? "telemetry-bar-fill danger" : "telemetry-bar-fill"} style={{ width: `${clamped}%` }} />
+ </div>
+ <strong className={valueClass}>{valueLabel}</strong>
+ </div>
+ );
+}
+
+export function CvssScoreCard({ data }: { data?: Record<string, unknown> }) {
+ if (!data) return null;
+ const score = data.base_score ?? data.score ?? data.overall;
+ const severity = String(data.severity ?? (typeof score === "number" && score >= 9 ? "critical" : typeof score === "number" && score >= 7 ? "high" : typeof score === "number" && score >= 4 ? "medium" : "low")).toLowerCase();
+ const vector = data.vector_string ?? data.vector;
+ return (
+ <section className="panel p-4 cvss-card">
+ <div className="flex items-start justify-between gap-4 mb-3">
+ <div>
+ <div className="text-[11px] font-semibold text-zinc-400 uppercase tracking-wider">Risk Assessment</div>
+ <h3 className="text-base font-semibold text-white">CVSS Metrics</h3>
+ </div>
+ <span className={`${opsecBadge(severity)} font-semibold uppercase text-xs px-2.5 py-1`}>
+ {severity}
+ </span>
+ </div>
+ <div className="grid grid-cols-1 sm:grid-cols-3 gap-3 mb-3">
+ <div className="bg-[#18181c] border border-[#27272a] rounded-lg p-3">
+ <div className="text-[11px] text-zinc-400">Base Score</div>
+ <div className="text-2xl font-bold font-mono text-white mt-1">{score !== undefined ? String(score) : "N/A"}</div>
+ </div>
+ <div className="bg-[#18181c] border border-[#27272a] rounded-lg p-3 sm:col-span-2">
+ <div className="text-[11px] text-zinc-400">Vector String</div>
+ <div className="text-xs font-mono text-zinc-300 mt-1.5 break-all">{vector ? String(vector) : "Vector string not calculated"}</div>
+ </div>
+ </div>
+ <details className="advanced-details">
+ <summary className="text-xs text-zinc-400 hover:text-zinc-200 cursor-pointer mb-2">Inspect Raw CVSS Payload</summary>
+ <StructuredJsonViewer data={data} title="CVSS Risk Metrics" maxHeightClass="max-h-64" />
+ </details>
+ </section>
+ );
+}
+
+export function CampaignDiffCard({ data }: { data?: Record<string, unknown> }) {
+ if (!data) return null;
+ return (
+ <section className="panel p-4 diff-card">
+ <div className="flex items-center justify-between mb-3">
+ <div>
+ <div className="text-[11px] font-semibold text-zinc-400 uppercase tracking-wider">Delta Analysis</div>
+ <h3 className="text-base font-semibold text-white">Campaign Comparison</h3>
+ </div>
+ <span className="badge badge-low text-xs">Compared</span>
+ </div>
+ <details className="advanced-details" open>
+ <summary className="text-xs text-zinc-400 hover:text-zinc-200 cursor-pointer mb-2">Detailed Delta Metrics</summary>
+ <StructuredJsonViewer data={data} title="Campaign Delta Metrics" maxHeightClass="max-h-72" />
+ </details>
+ </section>
+ );
+}
+
+export function DataPanel({
+ title,
+ data,
+ onClear
+}: {
+ title: string;
+ data: unknown;
+ onClear?: () => void;
+}) {
+ if (!data) {
+ return null;
+ }
+ const isError = data instanceof Error || data instanceof ApiError;
+ if (isError) {
+ const errorMsg = data instanceof ApiError ? String(data.detail) : data instanceof Error ? data.message : "The request failed.";
+ return (
+ <div className="rounded-lg border border-rose-500/30 bg-rose-500/10 p-3.5 text-xs text-rose-300 flex items-start justify-between gap-3 mb-3">
+ <div className="flex items-start gap-2.5">
+ <AlertTriangle size={16} className="text-rose-400 shrink-0 mt-0.5" />
+ <div>
+ <strong className="font-semibold text-rose-200 block mb-0.5">{title}</strong>
+ <span className="leading-relaxed">{errorMsg}</span>
+ </div>
+ </div>
+ <div className="flex items-center gap-2 shrink-0">
+ {onClear && (
+ <button
+ className="btn btn-compact text-[11px] py-0.5 px-2 flex items-center gap-1 text-rose-300 hover:text-white border-rose-500/30 hover:bg-rose-500/20"
+ onClick={onClear}
+ type="button"
+ title="Dismiss error"
+ >
+ <X size={12} />
+ <span>Dismiss</span>
+ </button>
+ )}
+ <span className="badge badge-high shrink-0 text-[10px] uppercase font-mono">Error</span>
+ </div>
+ </div>
+ );
+ }
+
+ return (
+ <section className="panel detail-panel mb-3">
+ <div className="flex items-center justify-between mb-2">
+ <strong className="text-xs font-semibold text-zinc-200">{title}</strong>
+ {onClear && (
+ <button
+ className="btn btn-compact text-[11px] py-0.5 px-2 flex items-center gap-1 text-zinc-400 hover:text-rose-400 hover:border-rose-900/50"
+ onClick={onClear}
+ type="button"
+ title="Clear payload preview"
+ >
+ <X size={12} />
+ <span>Clear</span>
+ </button>
+ )}
+ </div>
+ <StructuredJsonViewer data={data} title={`${title} Telemetry`} maxHeightClass="max-h-96" defaultExpandedDepth={1} />
+ </section>
+ );
+}
+
+export function getTailoredFindingDetails(finding: Finding) {
+ const title = String(finding.title ?? "").toUpperCase();
+ const desc = String(finding.description ?? "");
+ const evidence = (finding.evidence ?? {}) as Record<string, unknown>;
+ const rawPort = evidence.port ?? desc.match(/port\s+(\d+)/i)?.[1];
+ const port = rawPort ? Number(rawPort) : null;
+ const isKerberos = title.includes("KERBEROS") || port === 88;
+ const isLdaps = title.includes("LDAPS") || port === 636;
+ const isLdap = !isLdaps && (title.includes("LDAP") || port === 389);
+ const isSmb = title.includes("SMB") || port === 445;
+ const isWinrm = title.includes("WINRM") || port === 5985 || port === 5986;
+ const isDns = title.includes("DNS") || port === 53;
+ const isRpc = title.includes("RPC") || port === 135;
+ const isMssql = title.includes("MSSQL") || port === 1433;
+ const isRdp = title.includes("RDP") || port === 3389;
+ const isDocker = title.includes("DOCKER") || port === 2375;
+ const isRedis = title.includes("REDIS") || port === 6379;
+ const isAttackSurface = title.includes("ATTACK SURFACE");
+
+ let serviceTag = typeof evidence.role === "string" && evidence.role ? evidence.role : "";
+ let serviceCategory = typeof evidence.service === "string" && evidence.service ? String(evidence.service).toUpperCase() : "";
+ let tailoredRemediation = String(finding.remediation ?? "");
+
+ if (isKerberos) {
+ serviceTag = serviceTag || "PORT 88 / KERBEROS KDC / TIER-0 DC";
+ serviceCategory = serviceCategory || "Active Directory Authentication";
+ tailoredRemediation = tailoredRemediation || "Enforce AES-256 Kerberos encryption (disable RC4-HMAC), audit service accounts for SPNs to mitigate Kerberoasting, and monitor Event ID 4769 for abnormal TGS requests.";
+ } else if (isLdaps) {
+ serviceTag = serviceTag || "PORT 636 / LDAPS SECURE / TIER-0 DC";
+ serviceCategory = serviceCategory || "Encrypted Directory Service";
+ tailoredRemediation = tailoredRemediation || "Enforce strong TLS cipher suites, validate CA trust chains, and ensure LDAP channel binding is strictly enforced (LdapEnforceChannelBinding=2).";
+ } else if (isLdap) {
+ serviceTag = serviceTag || "PORT 389 / LDAP DIRECTORY";
+ serviceCategory = serviceCategory || "Active Directory Service";
+ tailoredRemediation = tailoredRemediation || "Require LDAP signing (LDAPServerIntegrity=2) and upgrade clients to LDAPS (port 636) to prevent NTLM relay and credential harvesting.";
+ } else if (isSmb) {
+ serviceTag = serviceTag || "PORT 445 / SMB SERVICE";
+ serviceCategory = serviceCategory || "Core Windows File Sharing & Remote Admin";
+ tailoredRemediation = tailoredRemediation || "Require SMB signing (RequireSecuritySignature=1), disable legacy SMBv1, and restrict port 445 inbound access to management subnets.";
+ } else if (isWinrm) {
+ serviceTag = serviceTag || `PORT ${port || 5985} / WINRM REMOTE MGMT`;
+ serviceCategory = serviceCategory || "Windows Remote Management (PowerShell Remoting)";
+ tailoredRemediation = tailoredRemediation || "Disable WinRM plaintext HTTP listeners, transition management traffic to WinRM HTTPS (port 5986), and enforce GPO firewall restrictions.";
+ } else if (isMssql) {
+ serviceTag = serviceTag || "PORT 1433 / MSSQL DATABASE";
+ serviceCategory = serviceCategory || "Enterprise Relational Database";
+ tailoredRemediation = tailoredRemediation || "Disable 'sa' account, enforce Windows Authentication only, and keep xp_cmdshell disabled in configuration.";
+ } else if (isRdp) {
+ serviceTag = serviceTag || "PORT 3389 / RDP REMOTE DESKTOP";
+ serviceCategory = serviceCategory || "Interactive Terminal Services";
+ tailoredRemediation = tailoredRemediation || "Enforce Network Level Authentication (NLA) and restrict RDP access to management VPN jump hosts.";
+ } else if (isDocker) {
+ serviceTag = serviceTag || "PORT 2375 / DOCKER DAEMON API";
+ serviceCategory = serviceCategory || "Unauthenticated Container Engine";
+ tailoredRemediation = tailoredRemediation || "Disable unauthenticated TCP socket; bind to local Unix socket or require mutual TLS authentication on port 2376.";
+ } else if (isRedis) {
+ serviceTag = serviceTag || "PORT 6379 / REDIS MEMORY STORE";
+ serviceCategory = serviceCategory || "In-Memory Cache & Key-Value Store";
+ tailoredRemediation = tailoredRemediation || "Enable requirepass authentication and bind Redis listener strictly to 127.0.0.1.";
+ } else if (isDns) {
+ serviceTag = serviceTag || "PORT 53 / MICROSOFT DNS";
+ serviceCategory = serviceCategory || "Domain Name Resolution";
+ tailoredRemediation = tailoredRemediation || "Restrict DNS zone transfers (AXFR) to designated secondary nameservers only, and enable DNSSEC validation.";
+ } else if (isRpc) {
+ serviceTag = serviceTag || "PORT 135 / MSRPC ENDPOINT";
+ serviceCategory = serviceCategory || "RPC Endpoint Mapper";
+ tailoredRemediation = tailoredRemediation || "Restrict RPC endpoint mapper via host-based firewall to prevent unauthenticated RPC enumeration and coercions.";
+ } else if (isAttackSurface) {
+ serviceTag = "HOST ATTACK SURFACE SUMMARY";
+ serviceCategory = "Exposed Network Services";
+ tailoredRemediation = tailoredRemediation || "Audit all listening ports against the enterprise baseline and enforce host-based micro-segmentation with Windows Defender Firewall.";
+ }
+
+ const rawConf = typeof finding.confidence === "number" ? finding.confidence : 1.0;
+ const isHighConf = rawConf >= 0.85 || finding.validated === true;
+ const confidenceText = rawConf >= 0.95
+ ? "100% Confirmed"
+ : formatRate(rawConf);
+
+ const nextModules = Array.isArray(evidence.next_modules)
+ ? (evidence.next_modules as string[])
+ : isKerberos
+ ? ["ad.asreproast", "ad.kerberoast", "ad.enum_spn"]
+ : isLdaps
+ ? ["ad.enum_users", "ad.adcs", "ad.ghost_forge"]
+ : isLdap
+ ? ["ad.enum_users", "ad.enum_spn", "ad.enum_acl"]
+ : isSmb
+ ? ["ad.coerce", "windows.secretsdump"]
+ : isWinrm
+ ? ["lateral.winrm"]
+ : [];
+
+ return {
+ port,
+ serviceTag,
+ serviceCategory,
+ tailoredRemediation,
+ isHighConf,
+ confidenceText,
+ nextModules
+ };
+}
+
+export function DiscoveredPerimeterCard({
+ rawOutput,
+ onSelectModule,
+ findingsCount = 0
+}: {
+ rawOutput?: Record<string, unknown>;
+ onSelectModule?: (moduleId: string, params?: Record<string, unknown>) => void;
+ findingsCount?: number;
+}) {
+ const [copiedLootIdx, setCopiedLootIdx] = useState<number | null>(null);
+ const [showLoot, setShowLoot] = useState(false);
+ if (!rawOutput) return null;
+
+ const target = String(rawOutput.target ?? rawOutput.host ?? "");
+ const openPorts = Array.isArray(rawOutput.open_ports) ? (rawOutput.open_ports as (number | string)[]) : [];
+ const serviceMap = (rawOutput.service_map ?? {}) as Record<string, string>;
+ const serviceVersions = (rawOutput.service_versions ?? {}) as Record<string, Record<string, unknown> | string>;
+ const loot = Array.isArray(rawOutput.loot) ? (rawOutput.loot as Record<string, unknown>[]) : [];
+ const scanMs = typeof rawOutput.scan_ms === "number" ? rawOutput.scan_ms : null;
+ const totalScanned = typeof rawOutput.total_scanned === "number" ? rawOutput.total_scanned : null;
+
+ const hasPerimeter = openPorts.length > 0 || Object.keys(serviceVersions).length > 0;
+ if (!hasPerimeter && loot.length === 0) return null;
+
+ return (
+ <div className="space-y-2 mt-3">
+ {/* 1. Defensive Telemetry & Purple Loot (Collapsible Progressive Disclosure) */}
+ {loot.length > 0 && (
+ <div className="border border-zinc-800 bg-zinc-950/80 rounded-sm overflow-hidden text-xs">
+ <button
+ type="button"
+ onClick={() => setShowLoot((prev) => !prev)}
+ className="w-full p-2.5 px-3 flex items-center justify-between hover:bg-zinc-900/60 transition-colors text-left font-sans"
+ >
+ <div className="flex items-center gap-2">
+ <ShieldCheck size={14} className="text-emerald-400 shrink-0" />
+ <span className="font-semibold text-zinc-200 text-xs">
+ Synthesized Detection Rules ({loot.length})
+ </span>
+ <span className="text-[10px] px-1.5 py-0.2 bg-zinc-900 border border-zinc-800 text-zinc-400 rounded font-mono">
+ KQL & Sigma
+ </span>
+ </div>
+ <div className="flex items-center gap-1.5 text-xs text-zinc-400">
+ <span className="text-[11px]">{showLoot ? "Hide Rules" : "Show Rules"}</span>
+ <ChevronDown size={14} className={`transform transition-transform duration-200 ${showLoot ? "rotate-180" : ""}`} />
+ </div>
+ </button>
+
+ {showLoot && (
+ <div className="p-3 border-t border-zinc-800/80 space-y-2.5 bg-zinc-950/50 font-mono">
+ {loot.map((item, idx) => {
+ const name = String(item.name ?? `Artifact #${idx + 1}`);
+ const lootType = String(item.loot_type ?? "rule");
+ const content = item.content as Record<string, unknown> | undefined;
+ const ruleText = typeof content?.kql === "string"
+ ? content.kql
+ : typeof content?.sigma === "string"
+ ? content.sigma
+ : typeof item.content === "string"
+ ? item.content
+ : JSON.stringify(item.content ?? item, null, 2);
+
+ const handleCopyRule = () => {
+ void navigator.clipboard.writeText(ruleText);
+ setCopiedLootIdx(idx);
+ setTimeout(() => setCopiedLootIdx(null), 1500);
+ };
+
+ return (
+ <div key={idx} className="p-2.5 rounded-sm border border-zinc-800 bg-zinc-900/60 space-y-1.5">
+ <div className="flex items-center justify-between gap-2">
+ <div className="flex items-center gap-2 truncate">
+ <Terminal size={12} className="text-zinc-400 shrink-0" />
+ <strong className="text-zinc-200 text-xs truncate">{name}</strong>
+ <span className="badge text-[10px] py-0 px-1.5 uppercase">{lootType}</span>
+ </div>
+ <button
+ type="button"
+ onClick={handleCopyRule}
+ className="btn btn-compact text-[10px] py-0.5 px-2 flex items-center gap-1 shrink-0"
+ title="Copy detection rule query"
+ >
+ {copiedLootIdx === idx ? (
+ <>
+ <CheckCircle2 size={11} className="text-emerald-400" />
+ <span className="text-emerald-400">Copied</span>
+ </>
+ ) : (
+ <>
+ <Copy size={11} />
+ <span>Copy Rule</span>
+ </>
+ )}
+ </button>
+ </div>
+ <pre className="text-[11px] font-mono text-zinc-300 bg-zinc-950 p-2 rounded-sm overflow-x-auto max-h-36 border border-zinc-800/60 leading-relaxed select-all">
+ {ruleText}
+ </pre>
+ </div>
+ );
+ })}
+ </div>
+ )}
+ </div>
+ )}
+
+ {/* 2. Perimeter Inventory Bar (Clean, non-redundant when findings are present) */}
+ {hasPerimeter && findingsCount > 0 && (
+ <div className="border border-zinc-800 bg-zinc-950/80 rounded-sm p-2.5 px-3 flex flex-wrap items-center justify-between gap-2 text-xs font-mono">
+ <div className="flex items-center gap-2">
+ <Radio size={13} className="text-emerald-400 shrink-0" />
+ <span className="font-semibold text-zinc-300 text-[11px]">
+ Surface Inventory:
+ </span>
+ {target && (
+ <span className="text-zinc-400">
+ Host <strong className="text-zinc-100">{target}</strong>
+ </span>
+ )}
+ </div>
+ <div className="flex items-center gap-3 text-zinc-400 text-[11px]">
+ {totalScanned !== null && <span>Scanned: {totalScanned} ports</span>}
+ {scanMs !== null && <span>Latency: {scanMs}ms</span>}
+ <div className="flex items-center gap-1.5">
+ {openPorts.map((port) => (
+ <span key={String(port)} className="px-1.5 py-0.5 rounded-sm bg-zinc-900 border border-zinc-700/80 text-emerald-400 font-semibold text-[10px]">
+ {String(port)}/TCP ({serviceMap[String(port)] ?? "active"})
+ </span>
+ ))}
+ </div>
+ </div>
+ </div>
+ )}
+
+ {/* 3. Discovered Services Grid (Rendered only if no findings exist, avoiding duplicate cards) */}
+ {hasPerimeter && findingsCount === 0 && (
+ <div className="border border-zinc-800 bg-zinc-950/80 rounded-sm p-3 space-y-2.5 font-mono text-xs">
+ <div className="flex flex-wrap items-center justify-between gap-2 border-b border-zinc-800/60 pb-2">
+ <div className="flex items-center gap-2">
+ <Radio size={14} className="text-emerald-400 shrink-0" />
+ <span className="font-semibold text-zinc-200 text-xs">
+ Discovered Target Services
+ </span>
+ {target && (
+ <span className="text-zinc-400 bg-zinc-900 px-2 py-0.5 border border-zinc-800 rounded-sm text-[11px]">
+ Host: <strong className="text-zinc-100">{target}</strong>
+ </span>
+ )}
+ </div>
+ <div className="flex items-center gap-3 text-[11px] text-zinc-400">
+ {totalScanned !== null && <span>Scanned: {totalScanned} ports</span>}
+ {scanMs !== null && <span>Latency: {scanMs}ms</span>}
+ </div>
+ </div>
+
+ <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-2">
+ {openPorts.map((port) => {
+ const portStr = String(port);
+ const service = serviceMap[portStr] ?? "unknown";
+ const versionInfo = serviceVersions[portStr];
+ const banner = typeof versionInfo === "object" && versionInfo !== null
+ ? String(versionInfo.banner ?? versionInfo.version ?? "")
+ : typeof versionInfo === "string" ? versionInfo : "";
+
+ return (
+ <div
+ key={portStr}
+ className="p-2.5 rounded-sm border border-zinc-800 bg-zinc-900/60 hover:border-zinc-700 space-y-1.5 transition-colors"
+ >
+ <div className="flex items-center justify-between">
+ <span className="font-bold text-zinc-100 bg-zinc-950 px-2 py-0.5 border border-zinc-800 rounded-sm">
+ PORT {portStr}/TCP
+ </span>
+ <span className="text-[10px] text-emerald-400 uppercase font-semibold flex items-center gap-1">
+ <span className="w-1.5 h-1.5 rounded-full bg-emerald-400 inline-block" />
+ OPEN ({service})
+ </span>
+ </div>
+
+ {banner && (
+ <div className="text-[10px] text-zinc-400 truncate bg-zinc-950/70 p-1 rounded-sm border border-zinc-800/40">
+ <span className="text-zinc-500 font-semibold">Banner: </span>
+ <span className="text-zinc-300 font-mono">{banner}</span>
+ </div>
+ )}
+
+ {onSelectModule && (
+ <div className="pt-1 flex items-center gap-1 flex-wrap">
+ {portStr === "22" && (
+ <>
+ <button
+ type="button"
+ onClick={() => onSelectModule("network.service_detect", { target, ports: "22" })}
+ className="text-[10px] px-2 py-0.5 rounded-sm border border-zinc-700 bg-zinc-800 hover:bg-zinc-700 text-zinc-200 transition-colors"
+ >
+ Fingerprint SSH
+ </button>
+ <button
+ type="button"
+ onClick={() => onSelectModule("lateral.ssh_pivot", { target, port: 22 })}
+ className="text-[10px] px-2 py-0.5 rounded-sm border border-zinc-700 bg-zinc-800 hover:bg-zinc-700 text-zinc-200 transition-colors"
+ >
+ SSH Pivot
+ </button>
+ <button
+ type="button"
+ onClick={() => onSelectModule("linux.privesc", { target })}
+ className="text-[10px] px-2 py-0.5 rounded-sm border border-zinc-700 bg-zinc-800 hover:bg-zinc-700 text-zinc-200 transition-colors"
+ >
+ Privesc Audit
+ </button>
+ </>
+ )}
+ </div>
+ )}
+ </div>
+ );
+ })}
+ </div>
+ </div>
+ )}
+ </div>
+ );
+}
+
+export function maskSecret(val: string): string {
+ if (!val) return "••••";
+ if (val.length <= 4) return "••••";
+ if (val.length <= 8) return val.slice(0, 2) + "••••" + val.slice(-1);
+ return val.slice(0, 3) + "••••••••" + val.slice(-3);
+}
+
+export function getPatternBadgeClass(pattern: string): string {
+ const p = pattern.toLowerCase();
+ if (p.includes("aws") || p.includes("cloud")) {
+ return "bg-amber-950/40 text-amber-300 border-amber-800/60";
+ }
+ if (p.includes("conn") || p.includes("sql") || p.includes("db")) {
+ return "bg-cyan-950/40 text-cyan-300 border-cyan-800/60";
+ }
+ if (p.includes("cert") || p.includes("private") || p.includes("rsa")) {
+ return "bg-emerald-950/40 text-emerald-300 border-emerald-800/60";
+ }
+ if (p.includes("pass") || p.includes("pwd") || p.includes("shadow")) {
+ return "bg-rose-950/40 text-rose-300 border-rose-800/60";
+ }
+ if (p.includes("key") || p.includes("token") || p.includes("api")) {
+ return "bg-purple-950/40 text-purple-300 border-purple-800/60";
+ }
+ return "bg-zinc-900 text-zinc-300 border-zinc-700/80";
+}
+
+export interface DiscoveredSecretHit {
+ file?: string;
+ line?: number;
+ pattern?: string;
+ snippet?: string;
+ extracted_secret?: string;
+ secret_value?: string;
+ entropy?: number;
+ confidence?: number;
+ is_placeholder?: boolean;
+ [key: string]: unknown;
+}
+
+export function DiscoveredSecretsEvidenceViewer({
+ hits,
+ title = "Discovered Secrets & Hardcoded Credentials"
+}: {
+ hits: DiscoveredSecretHit[];
+ title?: string;
+}) {
+ const [isExpanded, setIsExpanded] = useState(hits.length <= 6);
+ const [revealedIdxs, setRevealedIdxs] = useState<Record<number, boolean>>({});
+ const [copiedIdx, setCopiedIdx] = useState<number | null>(null);
+ const [copiedFileIdx, setCopiedFileIdx] = useState<number | null>(null);
+ const [revealAll, setRevealAll] = useState(false);
+
+ if (!hits || hits.length === 0) return null;
+
+ const toggleReveal = (idx: number) => {
+ setRevealedIdxs((prev) => ({
+ ...prev,
+ [idx]: !prev[idx]
+ }));
+ };
+
+ const handleToggleRevealAll = (e: React.MouseEvent) => {
+ e.stopPropagation();
+ const next = !revealAll;
+ setRevealAll(next);
+ const updated: Record<number, boolean> = {};
+ hits.forEach((_, i) => {
+ updated[i] = next;
+ });
+ setRevealedIdxs(updated);
+ };
+
+ const copySecret = (text: string, idx: number) => {
+ void navigator.clipboard.writeText(text);
+ setCopiedIdx(idx);
+ setTimeout(() => setCopiedIdx(null), 1500);
+ };
+
+ const copyFile = (path: string, idx: number) => {
+ void navigator.clipboard.writeText(path);
+ setCopiedFileIdx(idx);
+ setTimeout(() => setCopiedFileIdx(null), 1500);
+ };
+
+ return (
+ <div className="mt-2.5 rounded-sm border border-zinc-800/90 bg-zinc-950/90 overflow-hidden font-mono text-xs">
+ {/* Header */}
+ <div
+ role="button"
+ tabIndex={0}
+ onClick={() => setIsExpanded((prev) => !prev)}
+ onKeyDown={(e) => {
+ if (e.key === "Enter" || e.key === " ") {
+ e.preventDefault();
+ setIsExpanded((prev) => !prev);
+ }
+ }}
+ className="w-full p-2.5 px-3 flex items-center justify-between hover:bg-zinc-900/60 transition-colors text-left cursor-pointer select-none"
+ >
+ <div className="flex items-center gap-2 flex-wrap">
+ <Key size={13} className="text-amber-400 shrink-0" />
+ <strong className="text-zinc-200 text-xs font-sans tracking-tight">
+ {title} ({hits.length})
+ </strong>
+ <span className="text-[10px] uppercase tracking-wider px-1.5 py-0.5 rounded bg-amber-950/50 border border-amber-800/60 text-amber-300 font-semibold">
+ LOOT EXTRACTED
+ </span>
+ {hits.some((h) => h.is_placeholder) && (
+ <span className="text-[10px] px-1.5 py-0.5 rounded bg-zinc-900 border border-zinc-800 text-zinc-400">
+ SAMPLE / TEST IDENTIFIED
+ </span>
+ )}
+ </div>
+
+ <div className="flex items-center gap-2 text-xs">
+ <button
+ type="button"
+ onClick={handleToggleRevealAll}
+ className="text-[11px] font-mono px-2 py-0.5 rounded border border-zinc-700 bg-zinc-900 text-zinc-300 hover:text-zinc-100 hover:bg-zinc-800 transition-colors flex items-center gap-1 shrink-0"
+ title={revealAll ? "Mask all discovered secret values" : "Reveal all discovered secret values"}
+ >
+ {revealAll ? <EyeOff size={11} className="text-zinc-400" /> : <Eye size={11} className="text-zinc-400" />}
+ <span>{revealAll ? "Mask All" : "Reveal All"}</span>
+ </button>
+ <div className="flex items-center gap-1 text-zinc-400 text-xs">
+ <span className="text-[11px] font-sans">{isExpanded ? "Hide Details" : "Show Details"}</span>
+ <ChevronDown size={14} className={`transform transition-transform duration-200 ${isExpanded ? "rotate-180" : ""}`} />
+ </div>
+ </div>
+ </div>
+
+ {/* Expanded Table */}
+ {isExpanded && (
+ <div className="border-t border-zinc-800/80 overflow-x-auto">
+ <table className="w-full text-left text-xs border-collapse">
+ <thead>
+ <tr className="bg-zinc-900/80 border-b border-zinc-800/70 text-[10px] uppercase text-zinc-400 tracking-wider">
+ <th className="py-2 px-3 font-medium">Source File & Line</th>
+ <th className="py-2 px-3 font-medium">Pattern</th>
+ <th className="py-2 px-3 font-medium">Discovered Credential / Value</th>
+ <th className="py-2 px-3 font-medium">Shannon Entropy</th>
+ <th className="py-2 px-3 font-medium">Confidence</th>
+ </tr>
+ </thead>
+ <tbody className="divide-y divide-zinc-800/50">
+ {hits.map((hit, idx) => {
+ const isRevealed = Boolean(revealedIdxs[idx]);
+ const secretVal = String(hit.secret_value || hit.extracted_secret || hit.snippet || "");
+ const displayVal = isRevealed ? secretVal : maskSecret(secretVal);
+ const entropyVal = typeof hit.entropy === "number" ? hit.entropy : null;
+ const confVal = typeof hit.confidence === "number" ? hit.confidence : null;
+ const patternName = String(hit.pattern ?? "credential");
+ const filePath = String(hit.file ?? "");
+ const lineNo = hit.line;
+
+ return (
+ <tr key={idx} className="hover:bg-zinc-900/40 transition-colors">
+ {/* File Path & Line */}
+ <td className="py-2.5 px-3 max-w-[240px]">
+ <div className="flex items-center gap-1.5 truncate" title={filePath}>
+ <FileText size={12} className="text-zinc-500 shrink-0" />
+ <span className="text-zinc-200 truncate text-[11px] font-mono">
+ {filePath.split(/\\|\//).slice(-2).join("/") || filePath}
+ </span>
+ {lineNo !== undefined && (
+ <span className="text-[10px] text-amber-400 bg-zinc-900 px-1 py-0.2 border border-zinc-800 rounded shrink-0">
+ :{lineNo}
+ </span>
+ )}
+ <button
+ type="button"
+ onClick={() => copyFile(filePath, idx)}
+ className="text-zinc-500 hover:text-zinc-300 p-0.5 rounded transition-colors shrink-0"
+ title="Copy file path"
+ >
+ {copiedFileIdx === idx ? <Check size={11} className="text-emerald-400" /> : <Copy size={11} />}
+ </button>
+ </div>
+ </td>
+
+ {/* Pattern Badge */}
+ <td className="py-2.5 px-3 whitespace-nowrap">
+ <span className={`text-[10px] px-2 py-0.5 rounded border uppercase font-medium ${getPatternBadgeClass(patternName)}`}>
+ {patternName.replace(/_/g, " ")}
+ </span>
+ </td>
+
+ {/* Secret Value & Show/Hide + Copy */}
+ <td className="py-2.5 px-3">
+ <div className="flex items-center gap-1.5 max-w-sm">
+ <div
+ className="bg-zinc-900/90 border border-zinc-800/80 rounded px-2 py-1 font-mono text-[11px] text-zinc-100 truncate select-all flex-1 tracking-wider"
+ title={isRevealed ? secretVal : "Value masked. Click Eye icon to reveal."}
+ >
+ {displayVal}
+ </div>
+ <button
+ type="button"
+ onClick={() => toggleReveal(idx)}
+ className="p-1 rounded bg-zinc-900 border border-zinc-700/80 text-zinc-400 hover:text-zinc-200 hover:bg-zinc-800 transition-colors shrink-0"
+ title={isRevealed ? "Mask secret" : "Reveal full secret value"}
+ >
+ {isRevealed ? <EyeOff size={12} /> : <Eye size={12} />}
+ </button>
+ <button
+ type="button"
+ onClick={() => copySecret(secretVal, idx)}
+ className="p-1 rounded bg-zinc-900 border border-zinc-700/80 text-zinc-400 hover:text-zinc-200 hover:bg-zinc-800 transition-colors shrink-0"
+ title="Copy secret value"
+ >
+ {copiedIdx === idx ? <Check size={12} className="text-emerald-400" /> : <Copy size={12} />}
+ </button>
+ </div>
+ {hit.snippet && hit.snippet !== hit.extracted_secret && isRevealed && (
+ <div className="mt-1 text-[10px] font-mono text-zinc-500 bg-zinc-950/70 p-1 rounded border border-zinc-900 truncate" title={hit.snippet}>
+ Context: <code className="text-zinc-400">{hit.snippet}</code>
+ </div>
+ )}
+ </td>
+
+ {/* Shannon Entropy */}
+ <td className="py-2.5 px-3 whitespace-nowrap">
+ {entropyVal !== null ? (
+ <div className="flex items-center gap-1.5">
+ <span
+ className={`font-semibold ${
+ entropyVal >= 3.5
+ ? "text-emerald-400"
+ : entropyVal >= 2.5
+ ? "text-amber-400"
+ : "text-zinc-500"
+ }`}
+ >
+ {entropyVal.toFixed(2)}
+ </span>
+ <span className="text-[10px] text-zinc-500">bits</span>
+ <span
+ className="text-[9px] px-1 py-0.2 rounded uppercase border text-zinc-400 border-zinc-800"
+ title={
+ entropyVal >= 3.5
+ ? "High entropy (Likely true random credential/key)"
+ : entropyVal >= 2.5
+ ? "Moderate entropy (Standard passphrase)"
+ : "Low entropy (Dictionary word or placeholder)"
+ }
+ >
+ {entropyVal >= 3.5 ? "HIGH" : entropyVal >= 2.5 ? "MED" : "LOW"}
+ </span>
+ </div>
+ ) : (
+ <span className="text-zinc-600">n/a</span>
+ )}
+ </td>
+
+ {/* Confidence & Placeholder Pill */}
+ <td className="py-2.5 px-3 whitespace-nowrap">
+ <div className="flex items-center gap-1.5">
+ {confVal !== null ? (
+ <span
+ className={`px-1.5 py-0.5 rounded border text-[10px] font-medium font-mono ${
+ confVal >= 0.85
+ ? "text-emerald-300 bg-emerald-950/50 border-emerald-800/60"
+ : confVal >= 0.60
+ ? "text-amber-300 bg-amber-950/50 border-amber-800/60"
+ : "text-rose-300 bg-rose-950/50 border-rose-800/60"
+ }`}
+ >
+ {confVal >= 0.95 ? "100% Confirmed" : `${Math.round(confVal * 100)}%`}
+ </span>
+ ) : (
+ <span className="text-zinc-500 text-[10px]">Standard</span>
+ )}
+
+ {hit.is_placeholder && (
+ <span
+ className="text-[9px] px-1.5 py-0.2 rounded bg-zinc-900 border border-zinc-700 text-zinc-400 uppercase tracking-tight"
+ title="Identified as test sample or mock placeholder"
+ >
+ Placeholder
+ </span>
+ )}
+ </div>
+ </td>
+ </tr>
+ );
+ })}
+ </tbody>
+ </table>
+ </div>
+ )}
+ </div>
+ );
+}
+
+export function DiscoveredHashesEvidenceViewer({
+ hashes,
+ title = "Discovered Hashes & Account Secrets"
+}: {
+ hashes: Record<string, unknown>[];
+ title?: string;
+}) {
+ const [isExpanded, setIsExpanded] = useState(hashes.length <= 6);
+ const [copiedIdx, setCopiedIdx] = useState<number | null>(null);
+
+ if (!hashes || hashes.length === 0) return null;
+
+ const copyHash = (hash: string, idx: number) => {
+ void navigator.clipboard.writeText(hash);
+ setCopiedIdx(idx);
+ setTimeout(() => setCopiedIdx(null), 1500);
+ };
+
+ return (
+ <div className="mt-2 rounded-sm border border-zinc-800/90 bg-zinc-950/90 overflow-hidden font-mono text-xs">
+ <button
+ type="button"
+ onClick={() => setIsExpanded((p) => !p)}
+ className="w-full p-2.5 px-3 flex items-center justify-between hover:bg-zinc-900/60 transition-colors text-left"
+ >
+ <div className="flex items-center gap-2">
+ <Key size={13} className="text-purple-400 shrink-0" />
+ <strong className="text-zinc-200 text-xs font-sans tracking-tight">
+ {title} ({hashes.length})
+ </strong>
+ <span className="text-[10px] uppercase tracking-wider px-1.5 py-0.5 rounded bg-purple-950/50 border border-purple-800/60 text-purple-300 font-semibold">
+ HASH REPOSITORY
+ </span>
+ </div>
+ <div className="flex items-center gap-1 text-zinc-400 text-xs">
+ <span className="text-[11px] font-sans">{isExpanded ? "Hide" : "Show"}</span>
+ <ChevronDown size={14} className={`transform transition-transform duration-200 ${isExpanded ? "rotate-180" : ""}`} />
+ </div>
+ </button>
+
+ {isExpanded && (
+ <div className="border-t border-zinc-800/80 overflow-x-auto">
+ <table className="w-full text-left text-xs border-collapse">
+ <thead>
+ <tr className="bg-zinc-900/80 border-b border-zinc-800/70 text-[10px] uppercase text-zinc-400 tracking-wider">
+ <th className="py-2 px-3">Principal / Account</th>
+ <th className="py-2 px-3">Type</th>
+ <th className="py-2 px-3">Extracted Hash</th>
+ <th className="py-2 px-3">Privilege</th>
+ </tr>
+ </thead>
+ <tbody className="divide-y divide-zinc-800/50">
+ {hashes.map((item, idx) => {
+ const user = String(item.username || item.account || item.user || "unknown");
+ const hash = String(item.hash || item.ntlm_hash || item.value || "");
+ const type = String(item.hash_type || item.type || "crypt");
+ const isAdmin = Boolean(item.is_admin || item.is_domain_admin || item.privilege === "Domain Admin");
+
+ return (
+ <tr key={idx} className="hover:bg-zinc-900/40">
+ <td className="py-2 px-3 font-semibold text-zinc-200">{user}</td>
+ <td className="py-2 px-3">
+ <span className="text-[10px] px-1.5 py-0.5 rounded bg-zinc-900 border border-zinc-800 text-zinc-400 uppercase">
+ {type}
+ </span>
+ </td>
+ <td className="py-2 px-3">
+ <div className="flex items-center gap-1.5 max-w-md">
+ <code className="text-zinc-300 bg-zinc-900 px-2 py-0.5 rounded border border-zinc-800 truncate text-[11px] select-all flex-1">
+ {hash}
+ </code>
+ <button
+ type="button"
+ onClick={() => copyHash(hash, idx)}
+ className="p-1 rounded bg-zinc-900 border border-zinc-700/80 text-zinc-400 hover:text-zinc-200"
+ title="Copy hash"
+ >
+ {copiedIdx === idx ? <Check size={11} className="text-emerald-400" /> : <Copy size={11} />}
+ </button>
+ </div>
+ </td>
+ <td className="py-2 px-3 whitespace-nowrap">
+ {isAdmin ? (
+ <span className="text-[10px] px-1.5 py-0.5 rounded bg-rose-950/50 border border-rose-800/60 text-rose-300 font-semibold">
+ Domain Admin
+ </span>
+ ) : (
+ <span className="text-zinc-500 text-[10px]">Standard User</span>
+ )}
+ </td>
+ </tr>
+ );
+ })}
+ </tbody>
+ </table>
+ </div>
+ )}
+ </div>
+ );
+}
+
+export function DiscoveredTicketsEvidenceViewer({
+ tickets,
+ title = "Discovered Kerberos Tickets & TGTs"
+}: {
+ tickets: Record<string, unknown>[];
+ title?: string;
+}) {
+ const [isExpanded, setIsExpanded] = useState(tickets.length <= 6);
+
+ if (!tickets || tickets.length === 0) return null;
+
+ return (
+ <div className="mt-2 rounded-sm border border-zinc-800/90 bg-zinc-950/90 overflow-hidden font-mono text-xs">
+ <button
+ type="button"
+ onClick={() => setIsExpanded((p) => !p)}
+ className="w-full p-2.5 px-3 flex items-center justify-between hover:bg-zinc-900/60 transition-colors text-left"
+ >
+ <div className="flex items-center gap-2">
+ <Key size={13} className="text-cyan-400 shrink-0" />
+ <strong className="text-zinc-200 text-xs font-sans tracking-tight">
+ {title} ({tickets.length})
+ </strong>
+ <span className="text-[10px] uppercase tracking-wider px-1.5 py-0.5 rounded bg-cyan-950/50 border border-cyan-800/60 text-cyan-300 font-semibold">
+ KERBEROS CREDENTIAL CACHE
+ </span>
+ </div>
+ <div className="flex items-center gap-1 text-zinc-400 text-xs">
+ <span className="text-[11px] font-sans">{isExpanded ? "Hide" : "Show"}</span>
+ <ChevronDown size={14} className={`transform transition-transform duration-200 ${isExpanded ? "rotate-180" : ""}`} />
+ </div>
+ </button>
+
+ {isExpanded && (
+ <div className="border-t border-zinc-800/80 overflow-x-auto">
+ <table className="w-full text-left text-xs border-collapse">
+ <thead>
+ <tr className="bg-zinc-900/80 border-b border-zinc-800/70 text-[10px] uppercase text-zinc-400 tracking-wider">
+ <th className="py-2 px-3">Client Principal</th>
+ <th className="py-2 px-3">Service Principal</th>
+ <th className="py-2 px-3">Expiry</th>
+ <th className="py-2 px-3">Cache Path / Origin</th>
+ </tr>
+ </thead>
+ <tbody className="divide-y divide-zinc-800/50">
+ {tickets.map((t, idx) => {
+ const client = String(t.client || t.client_principal || "n/a");
+ const server = String(t.server || t.service_principal || "krbtgt");
+ const expiry = String(t.endtime || t.expiry || t.expires || "valid");
+ const path = String(t.path || t.ccache_path || t.source || "/tmp/krb5cc_*");
+
+ return (
+ <tr key={idx} className="hover:bg-zinc-900/40">
+ <td className="py-2 px-3 font-semibold text-zinc-200">{client}</td>
+ <td className="py-2 px-3 text-zinc-300">{server}</td>
+ <td className="py-2 px-3 text-zinc-400 text-[11px]">{expiry}</td>
+ <td className="py-2 px-3 text-zinc-500 font-mono text-[11px]">{path}</td>
+ </tr>
+ );
+ })}
+ </tbody>
+ </table>
+ </div>
+ )}
+ </div>
+ );
+}
+
+export function ModuleRunSummary({
+ result,
+ error,
+ onSelectModule
+}: {
+ result?: Record<string, unknown>;
+ error?: unknown;
+ onSelectModule?: (moduleId: string, params?: Record<string, unknown>) => void;
+}) {
+ if (!result && !error) {
+ return null;
+ }
+ if (error) {
+ return (
+ <div className="border border-rose-900/60 bg-rose-950/20 p-3.5 rounded mt-4 font-mono text-xs text-rose-300" role="alert">
+ <div className="flex items-center gap-2 font-semibold text-rose-400 mb-1">
+ <AlertTriangle size={15} />
+ <span>[EXECUTION_FAILED]</span>
+ </div>
+ <p>{error instanceof ApiError ? String(error.detail) : error instanceof Error ? error.message : "Module run failed."}</p>
+ </div>
+ );
+ }
+
+ const findings = Array.isArray(result?.findings) ? result.findings as Finding[] : [];
+ const validationCount = Array.isArray(result?.validation_results) ? result.validation_results.length : 0;
+ const duration = typeof result?.duration_ms === "number" ? formatMetric(result.duration_ms, " ms") : "n/a";
+ const status = String(result?.status ?? "unknown");
+ const moduleId = String(result?.module_id ?? "module");
+ const rawOutput = (result?.raw_output ?? result?.raw) as Record<string, unknown> | undefined;
+ const rawError = typeof rawOutput?.error === "string" ? rawOutput.error : "";
+ const rawHint = typeof rawOutput?.hint === "string" ? rawOutput.hint : "";
+ const auditProv = rawOutput?._audit_provenance as Record<string, unknown> | undefined;
+ const provenanceHash = typeof auditProv?.provenance_hash === "string" ? auditProv.provenance_hash : "";
+
+ const runError = typeof result?.error === "string" ? result.error : "";
+ const outcome = String(result?.outcome ?? "");
+ const outcomeMessage = String(result?.outcome_message ?? "");
+ const displayOutcome = outcome || status;
+ const dryRun = result?.dry_run === true || status.startsWith("dry_run_");
+ const warnings = Array.isArray(result?.warnings) ? result.warnings.map(String) : [];
+ const nextSteps = Array.isArray(result?.operator_next_steps) ? result.operator_next_steps.map(String) : [];
+ const hasOutcomeError = ["operator_error", "dependency_error", "network_error", "unsupported", "module_error", "failed", "timeout"].includes(displayOutcome);
+ const openPorts = Array.isArray(rawOutput?.open_ports) ? (rawOutput.open_ports as (number | string)[]) : [];
+ const hasPerimeter = openPorts.length > 0 || Object.keys((rawOutput?.service_versions ?? {}) as object).length > 0;
+ const filteredFindings = (result?.filtered_findings as { count?: number; reasons?: Record<string, number> } | undefined) ?? {};
+ const filteredCount = typeof filteredFindings.count === "number" ? filteredFindings.count : 0;
+ const filteredReasons = filteredFindings.reasons && typeof filteredFindings.reasons === "object" ? filteredFindings.reasons : {};
+ let topReasonLabel = "below reporting threshold";
+ const reasonEntries = Object.entries(filteredReasons).sort((a, b) => b[1] - a[1]);
+ if (reasonEntries.length > 0) {
+ const topKey = reasonEntries[0][0];
+ if (topKey === "below_confidence_threshold") {
+ topReasonLabel = "below reporting threshold";
+ } else if (topKey === "no_evidence") {
+ topReasonLabel = "no evidence";
+ } else if (topKey === "validator_rejected") {
+ topReasonLabel = "validator rejected";
+ } else {
+ topReasonLabel = topKey.replace(/_/g, " ");
+ }
+ }
+ const emptyText = dryRun
+ ? "No live execution was performed."
+ : rawError
+ ? `Module halted with status '${rawError}'. See execution notice above.`
+ : hasPerimeter
+ ? `Target perimeter active: ${openPorts.length} port(s) identified. Review reconnaissance telemetry below.`
+ : outcome === "completed_no_findings"
+ ? "No confirmed findings. The module completed without observing an exploitable condition."
+ : runError
+ ? "No findings recorded because execution failed."
+ : "No findings returned.";
+
+ return (
+ <section className="mt-4 space-y-3 font-sans">
+ {/* Tactical Telemetry Strip (Replacing bulky cards & notice clutter) */}
+ <div className="grid grid-cols-2 md:grid-cols-4 gap-px bg-zinc-800/80 border border-zinc-800 rounded-sm overflow-hidden text-xs font-mono">
+ <div className="bg-zinc-950 p-2.5">
+ <span className="text-[10px] text-zinc-500 uppercase tracking-wider block">MODULE / OPERATION</span>
+ <span className="font-semibold text-zinc-200">{moduleId}</span>
+ </div>
+ <div className="bg-zinc-950 p-2.5">
+ <span className="text-[10px] text-zinc-500 uppercase tracking-wider block">EXECUTION OUTCOME</span>
+ <span className={hasOutcomeError ? "text-rose-400 font-semibold" : "text-emerald-400 font-semibold"}>
+ {displayOutcome}
+ </span>
+ </div>
+ <div className="bg-zinc-950 p-2.5">
+ <span className="text-[10px] text-zinc-500 uppercase tracking-wider block">OBSERVATIONS / AUDIT</span>
+ <span className="font-semibold text-zinc-100">
+ {findings.length} findings <span className="text-zinc-500 text-[11px]">({validationCount} verified)</span>
+ </span>
+ </div>
+ <div className="bg-zinc-950 p-2.5">
+ <span className="text-[10px] text-zinc-500 uppercase tracking-wider block">DURATION</span>
+ <span className="font-semibold text-zinc-300">{duration}</span>
+ </div>
+ </div>
+
+ {provenanceHash && (
+ <div className="px-3 py-1.5 rounded-sm border border-zinc-800/80 bg-zinc-950/80 flex items-center justify-between gap-3 text-xs font-mono">
+ <div className="flex items-center gap-2 text-zinc-400 truncate">
+ <ShieldCheck size={13} className="text-emerald-400 shrink-0" />
+ <span className="text-zinc-500 font-semibold">AUDIT PROVENANCE:</span>
+ <code className="text-zinc-300 truncate text-[11px] select-all">{provenanceHash}</code>
+ </div>
+ <span className="text-[10px] text-emerald-400/90 uppercase tracking-wider shrink-0 font-semibold">[IMMUTABLE RECORD]</span>
+ </div>
+ )}
+
+ {rawError && (
+ <div className="p-3 rounded-sm border border-amber-900/50 bg-amber-950/20 text-xs font-mono text-amber-300 flex items-start gap-2" role="alert">
+ <AlertTriangle size={14} className="shrink-0 mt-0.5 text-amber-400" />
+ <div>
+ <span className="font-semibold">[EXECUTION NOTICE: {rawError.replace(/_/g, " ").toUpperCase()}]</span>
+ {rawHint && <p className="mt-0.5 text-zinc-400">{rawHint}</p>}
+ </div>
+ </div>
+ )}
+
+ {(outcomeMessage || runError) && !rawError && hasOutcomeError && (
+ <div className="p-3 rounded-sm border border-rose-900/60 bg-rose-950/20 text-xs font-mono text-rose-300 flex items-center gap-2" role="alert">
+ <AlertTriangle size={14} className="shrink-0 text-rose-400" />
+ <span>{outcomeMessage || runError}</span>
+ </div>
+ )}
+
+ {warnings.length > 0 && (
+ <div className="p-3 rounded-sm border border-zinc-800 bg-zinc-950/60 text-xs font-mono text-zinc-400">
+ <span className="text-zinc-300 uppercase tracking-wider font-semibold block mb-1">
+ [{dryRun ? "SIMULATION NOTES" : "OPERATION NOTES"}]
+ </span>
+ <ul className="list-disc pl-4 space-y-0.5">
+ {warnings.map((warning) => <li key={warning}>{warning}</li>)}
+ </ul>
+ </div>
+ )}
+
+ {nextSteps.length > 0 && (
+ <div className="p-3 rounded-sm border border-zinc-800 bg-zinc-950/60 text-xs font-mono text-zinc-400">
+ <span className="text-zinc-300 uppercase tracking-wider font-semibold block mb-1">
+ [OPERATOR NEXT STEPS]
+ </span>
+ <ul className="list-disc pl-4 space-y-0.5">
+ {nextSteps.map((step) => <li key={step}>{step}</li>)}
+ </ul>
+ </div>
+ )}
+
+ {/* Discovered Target Perimeter Matrix & Purple Team Loot */}
+ <DiscoveredPerimeterCard rawOutput={rawOutput} onSelectModule={onSelectModule} findingsCount={findings.length} />
+
+ {/* Findings Telemetry Stream (High-Density Tactical Matrix) */}
+ {findings.length > 0 ? (
+ <div className="space-y-2 mt-2">
+ {findings.map((finding, index) => {
+ const details = getTailoredFindingDetails(finding);
+ const normSev = String(finding.severity ?? "info").toLowerCase();
+ const borderAccent =
+ normSev.includes("high") || normSev.includes("crit")
+ ? "border-l-rose-500"
+ : normSev.includes("med")
+ ? "border-l-amber-500"
+ : "border-l-zinc-700";
+
+ const evidence = (finding.evidence ?? {}) as Record<string, unknown>;
+ const rawSecretHits = (
+ Array.isArray(evidence.hits)
+ ? evidence.hits
+ : Array.isArray(evidence.discovered_secrets)
+ ? evidence.discovered_secrets
+ : Array.isArray(rawOutput?.discovered_secrets) &&
+ (finding.module_id === "exfil.secrets_scan" ||
+ String(finding.title ?? "").toLowerCase().includes("secrets"))
+ ? rawOutput.discovered_secrets
+ : []
+ ) as DiscoveredSecretHit[];
+
+ const hashes = Array.isArray(evidence.hashes) ? (evidence.hashes as Record<string, unknown>[]) : [];
+ const tickets = Array.isArray(evidence.tickets) ? (evidence.tickets as Record<string, unknown>[]) : [];
+
+ return (
+ <div
+ className={`border border-zinc-800/80 border-l-[3px] ${borderAccent} bg-zinc-950/70 hover:bg-zinc-900/40 hover:border-zinc-700 transition-colors p-3.5 space-y-2.5 rounded-sm`}
+ key={finding.id ?? index}
+ >
+ {/* Header Row: Endpoint Port, Mitre, Host, Severity & Confidence */}
+ <div className="flex flex-wrap items-center justify-between gap-2 text-xs font-mono pb-2 border-b border-zinc-800/50">
+ <div className="flex items-center gap-2 flex-wrap">
+ {details.port ? (
+ <span className="font-bold text-zinc-100 bg-zinc-900 px-2 py-0.5 border border-zinc-800 rounded-sm">
+ PORT {details.port}/TCP
+ </span>
+ ) : details.serviceTag ? (
+ <span className="font-bold text-zinc-100 bg-zinc-900 px-2 py-0.5 border border-zinc-800 rounded-sm">
+ {details.serviceTag}
+ </span>
+ ) : null}
+ {details.serviceCategory && (
+ <span className="text-[11px] text-zinc-400 font-sans">
+ {details.serviceCategory}
+ </span>
+ )}
+ {finding.host && (
+ <span className="text-[11px] text-zinc-500">
+ TARGET: <strong className="text-zinc-300 font-mono">{finding.host}</strong>
+ </span>
+ )}
+ {finding.mitre_technique && (
+ <span className="text-[10px] text-zinc-500 border border-zinc-800 px-1.5 py-0.5 rounded-sm">
+ {finding.mitre_technique}
+ </span>
+ )}
+ </div>
+
+ <div className="flex items-center gap-2.5 shrink-0">
+ <span className={details.isHighConf ? "text-emerald-400 font-mono text-[11px] flex items-center gap-1 font-medium" : "text-zinc-400 font-mono text-[11px]"}>
+ {details.isHighConf && <CheckCircle2 size={12} className="text-emerald-400" />}
+ {details.confidenceText}
+ </span>
+ <span className={opsecBadge(finding.severity)}>
+ {finding.severity ? String(finding.severity).toUpperCase() : "INFO"}
+ </span>
+ </div>
+ </div>
+
+ {/* Finding Title & Concise Narrative */}
+ <div>
+ <h3 className="font-sans font-semibold text-sm text-zinc-100 tracking-tight">
+ {finding.title ?? `Observation #${index + 1}`}
+ </h3>
+ <p className="mt-1 text-xs text-zinc-400 leading-relaxed font-sans whitespace-pre-line">
+ {String(finding.description ?? "")}
+ </p>
+ </div>
+
+ {/* Discovered Secrets Evidence (Hardcoded Credentials, Keys & Tokens) */}
+ {rawSecretHits.length > 0 && (
+ <DiscoveredSecretsEvidenceViewer hits={rawSecretHits} />
+ )}
+
+ {/* Discovered Hashes Evidence Repository */}
+ {hashes.length > 0 && (
+ <DiscoveredHashesEvidenceViewer hashes={hashes} />
+ )}
+
+ {/* Discovered Kerberos Tickets Evidence Repository */}
+ {tickets.length > 0 && (
+ <DiscoveredTicketsEvidenceViewer tickets={tickets} />
+ )}
+
+ {/* Technical Remediation */}
+ {details.tailoredRemediation && (
+ <div className="pt-2 border-t border-zinc-800/50 text-xs font-mono text-zinc-400 flex items-start gap-2">
+ <span className="text-zinc-500 shrink-0 text-[10px] uppercase font-semibold">[MITIGATION]</span>
+ <span className="font-sans text-xs text-zinc-300 leading-relaxed">
+ {details.tailoredRemediation}
+ </span>
+ </div>
+ )}
+
+ {/* Next Actions */}
+ {details.nextModules.length > 0 && onSelectModule && (
+ <div className="pt-2 border-t border-zinc-800/50 flex items-center gap-2 flex-wrap">
+ <span className="text-[10px] font-mono text-zinc-500 uppercase tracking-wider shrink-0">
+ Next Actions:
+ </span>
+ <div className="flex items-center gap-1.5 flex-wrap">
+ {details.nextModules.map((nextMod) => (
+ <button
+ key={nextMod}
+ type="button"
+ onClick={() => onSelectModule(nextMod, { target: finding.host })}
+ className="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-sm border border-zinc-700/80 bg-zinc-900/90 hover:border-zinc-500 hover:bg-zinc-800 text-zinc-200 font-mono text-[11px] transition-colors"
+ title={`Arm and execute ${nextMod} on ${finding.host}`}
+ >
+ <Terminal size={11} className="text-zinc-400" />
+ <span>Execute: <strong className="text-zinc-100">{nextMod}</strong></span>
+ <ArrowRight size={11} className="text-zinc-400" />
+ </button>
+ ))}
+ </div>
+ </div>
+ )}
+ </div>
+ );
+ })}
+ </div>
+ ) : (
+ <EmptyState text={emptyText} />
+ )}
+
+ {filteredCount > 0 && (
+ <div
+ data-testid="filtered-findings-notice"
+ className="flex items-center gap-2 px-3 py-2 rounded-sm border border-zinc-800 bg-zinc-900/60 text-xs font-mono text-zinc-400 mt-2"
+ >
+ <Info size={13} className="text-zinc-500 shrink-0" />
+ <span>
+ {filteredCount} finding{filteredCount === 1 ? "" : "s"} filtered as low-confidence ({topReasonLabel})
+ </span>
+ </div>
+ )}
+ </section>
+ );
+}
+
+export function TemplatePlanSummary({ plan }: { plan?: TemplatePlanResponse }) {
+ const stages = plan?.plan?.stages ?? [];
+ if (!plan || stages.length === 0) {
+ return null;
+ }
+ const moduleCount = stages.reduce((total, stage) => total + (stage.modules?.length ?? 0), 0);
+ return (
+ <section className="inline-summary mt-4">
+ <SectionHeader
+ title={plan.template ?? "Generated Plan"}
+ description={plan.description}
+ action={(
+ <div className="flex flex-wrap gap-2">
+ <span className="badge">{stages.length} stages</span>
+ <span className="badge">{moduleCount} modules</span>
+ </div>
+ )}
+ />
+ <div className="compact-list">
+ {stages.map((stage, index) => (
+ <div className="compact-row" key={`${stage.name ?? "stage"}-${index}`}>
+ <div className="flex flex-wrap items-center justify-between gap-2">
+ <span className="font-bold">{index + 1}. {stage.name ?? "stage"}</span>
+ <span className="text-xs font-semibold text-zinc-400">{stage.modules?.length ?? 0} modules</span>
+ </div>
+ <div className="mt-2 flex flex-wrap gap-1">
+ {(stage.modules ?? []).map((moduleId) => <span className="badge" key={moduleId}>{moduleId}</span>)}
+ </div>
+ </div>
+ ))}
+ </div>
+ <p className="mt-3 text-sm text-zinc-400">Ready for campaign dry-run structure.</p>
+ </section>
+ );
+}
+
+export function CampaignScopeSummary({ campaign, loading }: { campaign?: Campaign; loading?: boolean }) {
+ const [copied, setCopied] = useState(false);
+ const [showRaw, setShowRaw] = useState(false);
+ if (loading) {
+ return (
+ <div className="detail-summary mt-3">
+ <div className="loading-row">
+ <Loader2 className="spin" size={16} /> Loading campaign...
+ </div>
+ </div>
+ );
+ }
+ if (!campaign) {
+ return <EmptyState text="Select a campaign to review scope and findings." />;
+ }
+ const targets = campaignTargets(campaign);
+ const scope = campaignScopeEntries(campaign);
+ const excluded = campaignExcludedHosts(campaign);
+
+ const copyScope = () => {
+ void navigator.clipboard.writeText(JSON.stringify(campaign, null, 2));
+ setCopied(true);
+ setTimeout(() => setCopied(false), 1500);
+ };
+
+ return (
+ <div className="detail-summary mt-3">
+ <div className="mb-3 flex flex-wrap items-start justify-between gap-3">
+ <div>
+ <h3 className="text-base font-bold text-white tracking-tight">{campaign.name}</h3>
+ <p className="text-xs text-zinc-400 mt-0.5">{campaign.client ?? "No client"} &middot; <span className="text-emerald-400 uppercase font-mono text-[11px]">{campaign.status ?? "created"}</span></p>
+ </div>
+ <div className="flex items-center gap-2">
+ <button
+ type="button"
+ onClick={copyScope}
+ className="btn btn-compact text-[11px] py-1 px-2.5 flex items-center gap-1.5"
+ title="Copy campaign JSON"
+ >
+ {copied ? <CheckCircle2 size={12} className="text-emerald-400" /> : <Copy size={12} />}
+ <span>{copied ? "Copied" : "Copy Scope"}</span>
+ </button>
+ <span className="badge font-mono text-[11px]">{campaign.operator ?? "operator"}</span>
+ </div>
+ </div>
+ <div className="mini-stat-grid">
+ <MiniStat title="Targets" value={String(targets.length)} detail={targets.slice(0, 3).join(", ") || "none declared"} />
+ <MiniStat title="Scope CIDRs" value={String(scope.length)} detail={scope.slice(0, 3).join(", ") || "none declared"} />
+ <MiniStat title="Excluded Hosts" value={String(excluded.length)} detail={excluded.length > 0 ? excluded.slice(0, 2).join(", ") : "none"} />
+ <MiniStat title="Noise Profile" value={String(campaign.noise_profile ?? "stealth")} detail="OPSEC guardrail" />
+ </div>
+
+ <div className="mt-4 space-y-3">
+ <div>
+ <div className="flex items-center justify-between mb-1.5">
+ <span className="text-xs font-semibold text-zinc-200 uppercase tracking-wider">Authorized IP Ranges &amp; CIDRs</span>
+ <span className="badge font-mono text-[10px]">{scope.length} range{scope.length === 1 ? "" : "s"}</span>
+ </div>
+ {scope.length > 0 ? (
+ <div className="flex flex-wrap gap-1.5">
+ {scope.map((cidr) => (
+ <span
+ key={cidr}
+ className="badge badge-info font-mono text-xs px-2.5 py-1 flex items-center gap-1.5"
+ >
+ <Radio size={11} className="text-cyan-400" />
+ <span>{cidr}</span>
+ </span>
+ ))}
+ </div>
+ ) : (
+ <p className="text-xs text-zinc-500 italic">No network CIDRs declared for this campaign.</p>
+ )}
+ </div>
+
+ {targets.length > 0 && (
+ <div>
+ <div className="flex items-center justify-between mb-1.5">
+ <span className="text-xs font-semibold text-zinc-200 uppercase tracking-wider">Target Hosts</span>
+ <span className="badge font-mono text-[10px]">{targets.length} host{targets.length === 1 ? "" : "s"}</span>
+ </div>
+ <div className="flex flex-wrap gap-1.5">
+ {targets.map((tgt) => (
+ <span
+ key={tgt}
+ className="badge font-mono text-xs px-2 py-0.5 flex items-center gap-1 text-zinc-200"
+ >
+ <Target size={11} className="text-emerald-400" />
+ <span>{tgt}</span>
+ </span>
+ ))}
+ </div>
+ </div>
+ )}
+
+ <div>
+ <div className="flex items-center justify-between mb-1.5">
+ <span className="text-xs font-semibold text-zinc-200 uppercase tracking-wider">Excluded Hosts / Out-of-Scope</span>
+ <span className="badge font-mono text-[10px]">{excluded.length} excluded</span>
+ </div>
+ {excluded.length > 0 ? (
+ <div className="flex flex-wrap gap-1.5">
+ {excluded.map((host) => (
+ <span
+ key={host}
+ className="badge badge-high font-mono text-xs px-2.5 py-1 flex items-center gap-1.5 border-rose-500/30 bg-rose-950/20 text-rose-300"
+ >
+ <MinusCircle size={12} className="text-rose-400" />
+ <span>{host}</span>
+ </span>
+ ))}
+ </div>
+ ) : (
+ <div className="text-xs text-zinc-500 italic flex items-center gap-1.5">
+ <ShieldCheck size={13} className="text-zinc-600" />
+ <span>None declared (all addresses within defined CIDRs are active scope)</span>
+ </div>
+ )}
+ </div>
+ </div>
+
+ <div className="mt-4 pt-3 border-t border-zinc-800/80">
+ <button
+ type="button"
+ onClick={() => setShowRaw(!showRaw)}
+ className="btn btn-compact text-[11px] py-1 px-2.5 text-zinc-400 hover:text-zinc-200 flex items-center gap-1.5"
+ >
+ <FileText size={12} />
+ <span>{showRaw ? "Hide Raw Scope JSON" : "View Raw Scope JSON"}</span>
+ <ChevronDown size={12} className={`transition-transform duration-200 ${showRaw ? "rotate-180" : ""}`} />
+ </button>
+ {showRaw && (
+ <div className="mt-2">
+ <StructuredJsonViewer data={campaign} title="Campaign Scope & Target Configuration" maxHeightClass="max-h-72" />
+ </div>
+ )}
+ </div>
+ </div>
+ );
+}
+
+export function CampaignPicker({
+ campaigns,
+ value,
+ onChange,
+ id,
+ hasError,
+ className
+}: {
+ campaigns: Campaign[];
+ value: string;
+ onChange: (id: string) => void;
+ id?: string;
+ hasError?: boolean;
+ className?: string;
+}) {
+ const safeValue = value && campaigns.some((c) => c.id === value) ? value : "";
+ return (
+ <select
+ id={id}
+ className={`field ${hasError ? "border-rose-500/70 focus:border-rose-500" : ""} ${className ?? ""}`.trim()}
+ value={safeValue}
+ onChange={(event) => onChange(event.target.value)}
+ >
+ <option value="">Select campaign</option>
+ {campaigns.map((campaign) => (
+ <option key={campaign.id} value={campaign.id}>
+ {campaign.name || campaign.id}
+ </option>
+ ))}
+ </select>
+ );
+}
+
+export function StatusBadge({ status }: { status?: string }) {
+ const normalized = String(status ?? "").toLowerCase();
+ const isOk = ["active", "running", "ready", "restored", "complete", "completed"].some((item) => normalized.includes(item));
+ const isWarn = ["paused", "pending", "draft", "created"].some((item) => normalized.includes(item));
+ const isDanger = ["failed", "deleted", "blocked", "error"].some((item) => normalized.includes(item));
+ const toneClass = isOk ? "badge badge-low" : isDanger ? "badge badge-high" : isWarn ? "badge badge-medium" : "badge";
+ const dotColor = isOk ? "bg-emerald-400" : isDanger ? "bg-rose-400" : isWarn ? "bg-amber-400" : "bg-zinc-400";
+ return (
+ <span className={toneClass}>
+ <span className={`inline-block h-1.5 w-1.5 rounded-full ${dotColor}`} />
+ <span>{status ?? "created"}</span>
+ </span>
+ );
+}
+
+export function NoiseProfileBadge({ noise }: { noise?: string }) {
+ const normalized = String(noise ?? "stealth").toLowerCase();
+ const isNoisy = normalized.includes("noisy") || normalized.includes("critical") || normalized.includes("high");
+ const isEvasive = normalized.includes("evasive") || normalized.includes("medium");
+ const isStealth = normalized.includes("stealth") || normalized.includes("low");
+ const badgeClass = isNoisy ? "badge badge-high" : isEvasive ? "badge badge-medium" : isStealth ? "badge badge-low" : "badge";
+ return (
+ <span className={`${badgeClass} font-mono text-[11px] uppercase tracking-wider`}>
+ {noise ?? "stealth"}
+ </span>
+ );
+}
+
+export function CampaignTable({
+ campaigns,
+ scopedCampaignId,
+ onClearScope,
+ onSelectCampaign
+}: {
+ campaigns: Campaign[];
+ scopedCampaignId?: string;
+ onClearScope?: () => void;
+ onSelectCampaign?: (id: string) => void;
+}) {
+ return (
+ <section className="panel table-panel">
+ <SectionHeader
+ title={scopedCampaignId ? "Scoped Campaign Activity" : "Campaign Activity"}
+ action={
+ <div className="flex items-center gap-2">
+ {scopedCampaignId && onClearScope ? (
+ <button
+ type="button"
+ onClick={onClearScope}
+ className="btn btn-compact text-xs font-mono"
+ title="Reset scope filter to display all campaigns"
+ >
+ Show All Campaigns
+ </button>
+ ) : null}
+ <span className="badge">{campaigns.length} record{campaigns.length === 1 ? "" : "s"}</span>
+ </div>
+ }
+ />
+ {campaigns.length > 0 ? (
+ <div className="table-scroll">
+ <table className="table">
+ <thead><tr><th>#</th><th>Name</th><th>Client</th><th>Status</th><th>Noise</th><th>Operator</th></tr></thead>
+ <tbody>
+ {campaigns.map((campaign, index) => (
+ <tr
+ key={campaign.id}
+ className={`campaign-table-row ${campaign.id === scopedCampaignId ? "is-selected" : ""} ${onSelectCampaign ? "cursor-pointer" : ""}`}
+ onClick={() => onSelectCampaign?.(campaign.id)}
+ title={onSelectCampaign ? `Filter dashboard to ${campaign.name}` : undefined}
+ >
+ <td className="muted-cell">#{String(index + 1).padStart(2, "0")}</td>
+ <td>
+ <div className="font-semibold text-zinc-100 text-sm tracking-tight">{campaign.name}</div>
+ <div className="mt-1 flex items-center gap-1.5 text-xs">
+ <span className="font-mono text-[11px] text-zinc-400 bg-zinc-900/90 px-1.5 py-0.5 rounded border border-zinc-800/80">
+ {campaign.id.slice(0, 12)}
+ </span>
+ </div>
+ </td>
+ <td className="text-zinc-300 text-sm">{campaign.client || "Internal"}</td>
+ <td><StatusBadge status={campaign.status} /></td>
+ <td><NoiseProfileBadge noise={campaign.noise_profile} /></td>
+ <td className="text-zinc-400 text-sm font-mono">{campaign.operator || "operator"}</td>
+ </tr>
+ ))}
+ </tbody>
+ </table>
+ </div>
+ ) : (
+ <EmptyState text="No campaigns yet. Create one from the Campaigns page to unlock modules, reports, and graph views." />
+ )}
+ </section>
+ );
+}
+
+export function FindingsTable({ findings }: { findings: any[] }) {
+ return (
+ <section className="panel table-panel">
+ <SectionHeader
+ title="Findings"
+ action={<span className="badge">{findings.length} records</span>}
+ />
+ {findings.length > 0 ? (
+ <div className="table-scroll">
+ <table className="table">
+ <thead><tr><th>Severity</th><th>Title</th><th>Module</th><th>MITRE</th><th>Host</th></tr></thead>
+ <tbody>
+ {findings.map((finding, index) => (
+ <tr key={finding.id ?? index}>
+ <td><span className={opsecBadge(finding.severity)}>{finding.severity ?? "info"}</span></td>
+ <td className="font-semibold text-zinc-100 text-sm">{finding.title ?? `Finding ${index + 1}`}</td>
+ <td className="text-zinc-300 font-mono text-xs">{finding.module_id ?? "n/a"}</td>
+ <td className="text-zinc-300 font-mono text-xs">{finding.mitre_technique ?? "n/a"}</td>
+ <td className="text-zinc-400 text-sm">{finding.host ?? "n/a"}</td>
+ </tr>
+ ))}
+ </tbody>
+ </table>
+ </div>
+ ) : (
+ <EmptyState text="No findings recorded for this campaign." />
+ )}
+ </section>
+ );
+}
+
+export function LiveEventCard({
+ event,
+ index,
+ campaigns
+}: {
+ event: unknown;
+ index: number;
+ campaigns?: Campaign[];
+}) {
+ const record = event && typeof event === "object" && !Array.isArray(event) ? event as Record<string, unknown> : null;
+ const type = String(record?.type ?? record?.event ?? record?.name ?? `event.${index + 1}`);
+ const message = String(record?.message ?? record?.status ?? record?.detail ?? "Campaign event received.");
+ const campaign = typeof record?.campaign_id === "string" ? record.campaign_id : "";
+ const matchedCampaign = campaigns?.find((c) => c.id === campaign);
+ const campaignLabel = matchedCampaign?.name ? matchedCampaign.name : (campaign ? `Campaign ${campaign.slice(0, 8)}` : "");
+ const moduleId = typeof record?.module_id === "string" ? record.module_id : "";
+ const created = typeof record?.timestamp === "number"
+ ? formatTimestamp(record.timestamp)
+ : typeof record?.created_at === "string"
+ ? formatDateTime(record.created_at)
+ : "";
+
+ return (
+ <article className="event-card">
+ <div className="event-marker" aria-hidden="true" />
+ <div className="min-w-0">
+ <div className="flex flex-wrap items-center gap-2">
+ <strong>{type}</strong>
+ {campaignLabel ? <span className="badge">{campaignLabel}</span> : null}
+ {moduleId ? <span className="badge">{moduleId}</span> : null}
+ </div>
+ <p>{message}</p>
+ {created ? <small>{created}</small> : null}
+ <details className="advanced-details compact mt-2">
+ <summary className="text-[11px] font-mono text-zinc-400 hover:text-zinc-200 cursor-pointer">Telemetry Details</summary>
+ <div className="mt-1.5">
+ <StructuredJsonViewer
+ data={serializeError(event)}
+ title="Event Telemetry"
+ defaultExpandedDepth={1}
+ maxHeightClass="max-h-56"
+ showSummaryStrip={false}
+ />
+ </div>
+ </details>
+ </div>
+ </article>
+ );
+}
+
+export function ParamForm({
+ schema,
+ values,
+ onChange,
+ requiredOverrides
+}: {
+ schema: ModuleMeta["param_schema"];
+ values: Record<string, unknown>;
+ onChange: (values: Record<string, unknown>) => void;
+ requiredOverrides?: Record<string, boolean>;
+}) {
+ const entries = Object.entries(schema ?? {});
+ if (entries.length === 0) {
+ return <EmptyState text="No parameters" />;
+ }
+ return (
+ <div className="grid gap-3">
+ {entries.map(([name, field]) => {
+ const required = requiredOverrides?.[name] ?? field.required;
+ const inputField = required === field.required ? field : { ...field, required };
+ const description = fieldDescription(name, field);
+ const isBool = field.type === "boolean";
+
+ const inputId = `param_${name}`;
+ if (isBool) {
+ return (
+ <div className="flex items-center gap-2.5 py-1 text-xs text-zinc-300" key={name}>
+ <input
+ id={inputId}
+ name={inputId}
+ type="checkbox"
+ checked={Boolean(values[name] ?? field.default)}
+ onChange={(event) => {
+ onChange({ ...values, [name]: event.target.checked });
+ }}
+ />
+ <label htmlFor={inputId} className="font-mono text-xs text-zinc-200 cursor-pointer select-none">
+ {name}
+ </label>
+ {!required && <span className="text-[10px] font-mono text-zinc-500">(optional)</span>}
+ {description && <span className="text-[11px] text-zinc-500">({description})</span>}
+ </div>
+ );
+ }
+
+ return (
+ <div className="block" key={name}>
+ <div className="flex items-center justify-between gap-2 mb-1">
+ <label htmlFor={inputId} className="font-mono text-xs text-zinc-300 cursor-pointer select-none">
+ {name}
+ {required && <span className="text-rose-500 font-sans ml-1">*</span>}
+ </label>
+ {!required && <span className="text-[10px] font-mono text-zinc-500">optional</span>}
+ </div>
+ <ParamInput
+ id={inputId}
+ name={name}
+ field={inputField}
+ value={values[name]}
+ onChange={(value) => {
+ const next = { ...values };
+ if (!required && isEmptyParamValue(value)) {
+ delete next[name];
+ } else {
+ next[name] = value;
+ }
+ onChange(next);
+ }}
+ />
+ {description && (
+ <span className="mt-1 block text-[11px] text-zinc-500 leading-snug">
+ {description}
+ </span>
+ )}
+ </div>
+ );
+ })}
+ </div>
+ );
+}
+
+export function ParamInput({
+ id,
+ name,
+ field,
+ value,
+ onChange
+}: {
+ id?: string;
+ name: string;
+ field: ParamField;
+ value: unknown;
+ onChange: (value: unknown) => void;
+}) {
+ const inputId = id ?? `param_${name}`;
+ if (field.type === "boolean") {
+ return (
+ <input
+ id={inputId}
+ name={inputId}
+ className="ml-2 cursor-pointer"
+ type="checkbox"
+ checked={Boolean(value)}
+ required={field.required}
+ onChange={(event) => onChange(event.target.checked)}
+ />
+ );
+ }
+ if (field.type === "array") {
+ return (
+ <textarea
+ id={inputId}
+ name={inputId}
+ className="field mt-1 min-h-20"
+ value={Array.isArray(value) ? value.join(", ") : String(value ?? "")}
+ placeholder={paramPlaceholder(name, field)}
+ required={field.required}
+ autoComplete="off"
+ spellCheck={false}
+ onInvalid={setRequiredMessage}
+ onChange={(event) => {
+ clearValidationMessage(event);
+ onChange(parseArrayParam(event.target.value, field));
+ }}
+ />
+ );
+ }
+ const type = field.secret ? "password" : field.type === "integer" || field.type === "number" ? "number" : "text";
+ return (
+ <input
+ id={inputId}
+ name={inputId}
+ className="field mt-1"
+ type={type}
+ value={String(value ?? "")}
+ min={field.min}
+ max={field.max}
+ placeholder={paramPlaceholder(name, field)}
+ required={field.required}
+ autoComplete={field.secret ? "new-password" : "off"}
+ autoCorrect="off"
+ autoCapitalize="off"
+ spellCheck={false}
+ data-lpignore="true"
+ data-form-type="other"
+ onInvalid={setRequiredMessage}
+ onChange={(event) => {
+ clearValidationMessage(event);
+ if (type === "number") {
+ onChange(event.target.value === "" ? undefined : Number(event.target.value));
+ return;
+ }
+ onChange(event.target.value === "" ? undefined : event.target.value);
+ }}
+ />
+ );
+}
+
+export function fieldDefaultHint(field: ParamField): string {
+ if (field.secret || field.default === undefined) {
+ return "";
+ }
+ const value = formatDefaultValue(field.default);
+ return value ? `Default: ${value}` : "";
+}
+
+export function paramPlaceholder(name: string, field: ParamField): string {
+ if (!field.secret) {
+ const value = formatDefaultValue(field.default);
+ if (value) {
+ return value;
+ }
+ }
+ const lower = name.toLowerCase();
+ if (lower === "target_user" && field.description === "Required target user or SPN; run ad.enum_spn first") {
+ return "svc-sql or MSSQLSvc/sql01.lab.local:1433";
+ }
+ if (lower.includes("target")) {
+ return "127.0.0.1";
+ }
+ if (lower.includes("port")) {
+ return "80, 443, 8080, 8443, 8888";
+ }
+ if (lower.includes("domain")) {
+ return "corp.local";
+ }
+ return field.required ? "" : "Leave blank to use the module default";
+}
+
+export function fieldDescription(name: string, field: ParamField): string | undefined {
+ if (name === "target_user" && field.description === "Required target user or SPN; run ad.enum_spn first") {
+ return "Required target user or SPN; run ad.enum_spn first.";
+ }
+ if (name === "timeout") {
+ return (field.description ? `${field.description}. ` : "") + "Recommendation: use 2.5s - 3.0s for virtual lab / VM targets.";
+ }
+ if (name === "ports" && (!field.description || field.description.includes("Port spec"))) {
+ return "Comma-separated ports (e.g. 88, 389, 445) or presets (top1000). Required for service detection.";
+ }
+ return field.description;
+}
+
+export function formatDefaultValue(value: unknown): string {
+ if (value === undefined || value === null || value === "") {
+ return "";
+ }
+ if (Array.isArray(value)) {
+ return value.join(", ");
+ }
+ if (typeof value === "boolean") {
+ return value ? "true" : "false";
+ }
+ if (typeof value === "object") {
+ return JSON.stringify(value);
+ }
+ return String(value);
+}
+
+export function ScreenMessage({ title, body }: { title: string; body: string }) {
+ return (
+ <div className="grid min-h-screen place-items-center bg-zinc-950 p-4 text-zinc-100">
+ <div className="rounded-xl border border-zinc-800 bg-zinc-900/60 p-6 text-center shadow-sm">
+ <h1 className="text-lg font-semibold tracking-tight text-zinc-100">{title}</h1>
+ <p className="mt-1 text-xs text-zinc-400">{body}</p>
+ </div>
+ </div>
+ );
+}
+
+export function EmptyState({ text }: { text: string }) {
+ return <div className="empty-state">{text}</div>;
+}
+
+export function strategyBackendHint(backend: string): string {
+ if (backend === "openai") {
+ return "OpenAI planning requires OPENAI_API_KEY in the ARES server environment. Security-page API keys do not count as LLM provider keys.";
+ }
+ if (backend === "local") {
+ return "Local planning uses Ollama from the ARES server host, usually http://localhost:11434. No cloud LLM key is required.";
+ }
+ return "Claude planning requires ANTHROPIC_API_KEY in the ARES server environment. Security-page API keys only authenticate callers to ARES.";
+}
+
+export function moduleRunHint(
+ campaignId: string,
+ module: ModuleMeta | undefined,
+ campaign: Campaign | undefined,
+ sensitive: boolean,
+ confirmed: boolean,
+ dryRun: boolean
+): string {
+ if (!campaignId) {
+ return "Select a campaign before running a module.";
+ }
+ if (!module) {
+ return "Select a module from the catalog.";
+ }
+ if (!campaign) {
+ return "Campaign details are still loading.";
+ }
+ if (sensitive && !confirmed) {
+ return "Confirm authorization before running high-noise or sensitive modules.";
+ }
+ if (!dryRun && "target" in (module.param_schema ?? {}) && campaignScopeEntries(campaign).length === 0) {
+ return "Live target modules require campaign scope CIDRs. Add a scope such as 127.0.0.1/32 before running.";
+ }
+ return "";
+}
+
+export function splitLines(value: string): string[] {
+ return value
+ .split(/\r?\n|,/)
+ .map((item) => item.trim())
+ .filter(Boolean);
+}
+
+export function findInvalidScopeEntries(value: string): string[] {
+ return splitLines(value).filter((entry) => !looksLikeScopeEntry(entry));
+}
+
+export function looksLikeScopeEntry(entry: string): boolean {
+ if (entry.includes(":")) {
+ return true;
+ }
+ const [address, prefix] = entry.split("/");
+ if (!isIpv4Address(address)) {
+ return false;
+ }
+ if (prefix === undefined) {
+ return true;
+ }
+ if (!/^\d{1,2}$/.test(prefix)) {
+ return false;
+ }
+ const value = Number(prefix);
+ return value >= 0 && value <= 32;
+}
+
+export function parseArrayParam(value: string, field: ParamField): unknown[] | undefined {
+ const entries = splitLines(value);
+ if (entries.length === 0) {
+ return undefined;
+ }
+ const itemType = field.items?.type ?? "string";
+ if (itemType === "integer" || itemType === "number") {
+ const numericEntries = entries.map((entry) => Number(entry));
+ return numericEntries.every((entry) => Number.isFinite(entry)) ? numericEntries : entries;
+ }
+ return entries;
+}
+
+export function isEmptyParamValue(value: unknown): boolean {
+ return value === undefined || value === "" || (Array.isArray(value) && value.length === 0);
+}
+
+export function moduleScopeWarning(
+ module: ModuleMeta | undefined,
+ campaign: Campaign | undefined,
+ values: Record<string, unknown>,
+ dryRun: boolean
+): string {
+ if (!module || !campaign || dryRun || !("target" in (module.param_schema ?? {}))) {
+ return "";
+ }
+ const target = typeof values.target === "string" ? values.target.trim() : "";
+ if (!target) {
+ return "";
+ }
+ const scope = campaignScopeEntries(campaign);
+ if (scope.length === 0) {
+ return "Selected campaign has no scope CIDRs. Add a scoped campaign such as 127.0.0.1/32 before running target modules.";
+ }
+ if (isIpv4Address(target) && scope.every(looksLikeScopeEntry) && !scope.some((entry) => ipv4InScope(target, entry))) {
+ return `Target ${target} is outside the selected campaign scope (${scope.join(", ")}).`;
+ }
+ return "";
+}
+
+export function campaignScopeEntries(campaign: Campaign): string[] {
+ if (Array.isArray(campaign.scope_cidrs)) {
+ return campaign.scope_cidrs.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
+ }
+ const rawScope = campaign.scope;
+ if (Array.isArray(rawScope)) {
+ return rawScope
+ .map((entry) => {
+ if (typeof entry === "string") {
+ return entry;
+ }
+ if (entry && typeof entry === "object" && "cidr" in entry && typeof entry.cidr === "string") {
+ return entry.cidr;
+ }
+ return "";
+ })
+ .filter(Boolean);
+ }
+ if (typeof campaign.scope_json === "string" && campaign.scope_json.trim()) {
+ try {
+ const parsed = JSON.parse(campaign.scope_json) as unknown;
+ if (Array.isArray(parsed)) {
+ return parsed
+ .map((entry) => {
+ if (typeof entry === "string") {
+ return entry;
+ }
+ if (entry && typeof entry === "object" && "cidr" in entry && typeof entry.cidr === "string") {
+ return entry.cidr;
+ }
+ return "";
+ })
+ .filter(Boolean);
+ }
+ } catch {
+ return [];
+ }
+ }
+ return [];
+}
+
+export function campaignTargets(campaign: Campaign): string[] {
+ if (Array.isArray(campaign.targets)) {
+ return campaign.targets.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
+ }
+ if (typeof campaign.targets_json === "string" && campaign.targets_json.trim()) {
+ try {
+ const parsed = JSON.parse(campaign.targets_json) as unknown;
+ if (Array.isArray(parsed)) {
+ return parsed.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
+ }
+ } catch {
+ return [];
+ }
+ }
+ return [];
+}
+
+export function campaignExcludedHosts(campaign: Campaign): string[] {
+ const explicit = campaign as { excluded_hosts?: unknown; excluded?: unknown };
+ if (Array.isArray(explicit.excluded_hosts)) {
+ return explicit.excluded_hosts.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
+ }
+ if (Array.isArray(explicit.excluded)) {
+ return explicit.excluded.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
+ }
+ if (typeof campaign.scope_json === "string" && campaign.scope_json.trim()) {
+ try {
+ const parsed = JSON.parse(campaign.scope_json) as Record<string, unknown>;
+ if (parsed && Array.isArray(parsed.excluded_hosts)) {
+ return parsed.excluded_hosts.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
+ }
+ if (parsed && Array.isArray(parsed.excluded)) {
+ return parsed.excluded.filter((entry): entry is string => typeof entry === "string" && entry.trim() !== "");
+ }
+ } catch {
+ return [];
+ }
+ }
+ return [];
+}
+
+export function ipv4InScope(ip: string, cidr: string): boolean {
+ const [network, prefixText = "32"] = cidr.split("/");
+ if (!isIpv4Address(network) || !/^\d{1,2}$/.test(prefixText)) {
+ return false;
+ }
+ const prefix = Number(prefixText);
+ if (prefix < 0 || prefix > 32) {
+ return false;
+ }
+ const mask = prefix === 0 ? 0 : (0xffffffff << (32 - prefix)) >>> 0;
+ return (ipv4ToNumber(ip) & mask) === (ipv4ToNumber(network) & mask);
+}
+
+export function ipv4ToNumber(ip: string): number {
+ return ip.split(".").reduce((acc, part) => ((acc << 8) + Number(part)) >>> 0, 0);
+}
+
+export function isIpv4Address(value: string): boolean {
+ const parts = value.split(".");
+ return parts.length === 4 && parts.every((part) => {
+ if (!/^\d{1,3}$/.test(part)) {
+ return false;
+ }
+ const number = Number(part);
+ return number >= 0 && number <= 255;
+ });
+}
+
+export function unique(values: string[]): string[] {
+ return [...new Set(values.filter(Boolean))].sort();
+}
+
+export function safeJson(value: string): Record<string, unknown> {
+ try {
+ const parsed = JSON.parse(value) as unknown;
+ return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed as Record<string, unknown> : {};
+ } catch {
+ return {};
+ }
+}
+
+export function isJsonObject(value: string): boolean {
+ try {
+ const parsed = JSON.parse(value) as unknown;
+ return Boolean(parsed && typeof parsed === "object" && !Array.isArray(parsed));
+ } catch {
+ return false;
+ }
+}
+
+export function isSensitiveModule(module?: ModuleMeta): boolean {
+ if (!module) {
+ return false;
+ }
+ const text = `${module.id} ${module.category ?? ""} ${module.opsec_level ?? ""}`.toLowerCase();
+ return (
+ text.includes("high_noise") ||
+ text.includes("credential") ||
+ text.includes("persistence") ||
+ text.includes("edr") ||
+ text.includes("dcsync")
+ );
+}
+
+export function statusBadge(status?: string): string {
+ const normalized = String(status ?? "").toLowerCase();
+ if (["active", "running", "ready", "restored", "complete", "completed"].some((item) => normalized.includes(item))) {
+ return "badge badge-low";
+ }
+ if (["failed", "deleted", "blocked", "error"].some((item) => normalized.includes(item))) {
+ return "badge badge-high";
+ }
+ if (["paused", "pending", "draft", "created"].some((item) => normalized.includes(item))) {
+ return "badge badge-medium";
+ }
+ return "badge";
+}
+
+export function opsecBadge(level?: string): string {
+ const normalized = String(level ?? "").toLowerCase().trim();
+ if (!normalized || normalized === "n/a" || normalized === "none" || normalized === "unknown") {
+ return "badge";
+ }
+ if (normalized.includes("high") || normalized.includes("critical") || normalized.includes("alarm")) {
+ return "badge badge-high";
+ }
+ if (normalized.includes("medium") || normalized.includes("moderate") || normalized.includes("warn")) {
+ return "badge badge-medium";
+ }
+ if (normalized.includes("low") || normalized.includes("safe") || normalized.includes("info") || normalized.includes("stealth") || normalized.includes("minimal")) {
+ return "badge badge-low";
+ }
+ return "badge";
+}
+
+export function serializeError(value: unknown): unknown {
+ if (value instanceof ApiError) {
+ const idempotencyKey = "idempotencyKey" in value
+ && typeof value.idempotencyKey === "string"
+ ? value.idempotencyKey
+ : undefined;
+ return {
+ name: value.name,
+ status: value.status,
+ detail: value.detail,
+ ...(idempotencyKey ? { idempotency_key: idempotencyKey } : {})
+ };
+ }
+ if (value instanceof Error) {
+ const idempotencyKey = "idempotencyKey" in value
+ && typeof value.idempotencyKey === "string"
+ ? value.idempotencyKey
+ : undefined;
+ return {
+ name: value.name,
+ message: value.message,
+ ...(idempotencyKey ? { idempotency_key: idempotencyKey } : {})
+ };
+ }
+ return value;
+}
+
+export function readableError(value: unknown, fallback: string): string {
+ if (value instanceof ApiError) {
+ if (typeof value.detail === "string") {
+ return value.detail;
+ }
+ return value.message || fallback;
+ }
+ if (value instanceof Error) {
+ return value.message || fallback;
+ }
+ if (typeof value === "string") {
+ return value;
+ }
+ return fallback;
+}
+
+export function pdfFailureHint(value: unknown): string {
+ if (!value) return "";
+ const serialized = serializeError(value);
+ const text = typeof serialized === "string"
+ ? serialized
+ : JSON.stringify(serialized);
+ const normalized = text.toLowerCase();
+ if (normalized.includes("elevated windows") || normalized.includes("administrator powershell")) {
+ return "PDF export is blocked from this elevated Windows session. Run PowerShell normally, or set ARES_PDF_BROWSER to a working non-Edge browser.";
+ }
+ if (
+ normalized.includes("gtk")
+ || normalized.includes("pango")
+ || normalized.includes("libgobject")
+ ) {
+ return "WeasyPrint needs native GTK/Pango libraries on Windows. Use the browser fallback from normal PowerShell or install those native libraries.";
+ }
+ if (normalized.includes("no downloadable pdf") || normalized.includes("pdf smoke")) {
+ return "PDF export did not create a valid artifact. Run ares doctor --pdf-smoke to verify the local PDF backend and browser fallback.";
+ }
+ return "";
+}
diff --git a/frontend/src/features/dashboard/pages/CampaignsPage.tsx b/frontend/src/features/dashboard/pages/CampaignsPage.tsx
new file mode 100644
index 0000000..629a13d
--- /dev/null
+++ b/frontend/src/features/dashboard/pages/CampaignsPage.tsx
@@ -0,0 +1,349 @@
+import {
+ Loader2,
+} from "lucide-react";
+import {
+ useState,
+} from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import {
+ api,
+} from "../../../api/client";
+import type {
+ ApiErrorPayload,
+ Campaign,
+ LiveExecutionResponse,
+ TemplatePlanResult,
+ VaultRestoreResult,
+} from "../../../api/types";
+import { ConfirmModal } from "../../../components/ui/ConfirmModal";
+import {
+ useDashboardUi,
+ useSessionState,
+ useTabParam,
+} from "../dashboardUiState";
+import {
+ CampaignDiffCard,
+ CampaignPicker,
+ CampaignScopeSummary,
+ CampaignTable,
+ CvssScoreCard,
+ DataPanel,
+ EmptyState,
+ FindingsTable,
+ Page,
+ SectionHeader,
+ clearValidationMessage,
+ findInvalidScopeEntries,
+ setRequiredMessage,
+ splitLines,
+} from "../dashboardComponents";
+
+const VALID_TABS_CAMPAIGNS = ["List", "Scope", "Findings"] as const;
+type CampaignsTab = typeof VALID_TABS_CAMPAIGNS[number];
+
+export function CampaignsPage() {
+ const queryClient = useQueryClient();
+ const {
+ selectedCampaignId: selected,
+ setSelectedCampaignId: setSelected,
+ campaigns: campaignList,
+ deleteCampaign,
+ isDeletingCampaign,
+ pushLiveEvent
+ } = useDashboardUi();
+ const [name, setName] = useSessionState("ares.dashboard.campaigns.create.name", "");
+ const [client, setClient] = useSessionState("ares.dashboard.campaigns.create.client", "Internal");
+ const [targets, setTargets] = useSessionState("ares.dashboard.campaigns.create.targets", "");
+ const [scope, setScope] = useSessionState("ares.dashboard.campaigns.create.scope", "");
+ const [noiseProfile, setNoiseProfile] = useSessionState("ares.dashboard.campaigns.create.noiseProfile", "stealth");
+ const [createWarning, setCreateWarning] = useState("");
+ const [otherId, setOtherId] = useSessionState("ares.dashboard.campaigns.compareId", "");
+ const [rawTab, setActiveTab] = useTabParam("List");
+ const activeTab = (VALID_TABS_CAMPAIGNS as readonly string[]).includes(rawTab)
+ ? (rawTab as CampaignsTab)
+ : "List";
+ const [deleteError, setDeleteError] = useState<unknown>(null);
+ const [deleteTarget, setDeleteTarget] = useState<string | null>(null);
+ const [localDeleting, setLocalDeleting] = useState(false);
+ const isDeleting = localDeleting || Boolean(isDeletingCampaign);
+ const detail = useQuery({
+ queryKey: ["campaign", selected],
+ queryFn: () => api.campaign(selected),
+ enabled: Boolean(selected)
+ });
+ const findings = useQuery({
+ queryKey: ["findings", selected],
+ queryFn: () => api.findings(selected),
+ enabled: Boolean(selected)
+ });
+ const cvss = useQuery({
+ queryKey: ["cvss", selected],
+ queryFn: () => api.cvss(selected),
+ enabled: Boolean(selected)
+ });
+ const diff = useQuery({
+ queryKey: ["diff", selected, otherId],
+ queryFn: () => api.diffCampaign(selected, otherId),
+ enabled: Boolean(selected && otherId)
+ });
+ const create = useMutation({
+ mutationFn: () =>
+ api.createCampaign({
+ name: name.trim(),
+ client: client.trim(),
+ targets: splitLines(targets),
+ scope_cidrs: splitLines(scope),
+ noise_profile: noiseProfile
+ }),
+ onSuccess: (campaign) => {
+ setSelected(campaign.id);
+ setName("");
+ setTargets("");
+ setScope("");
+ setNoiseProfile("stealth");
+ setCreateWarning("");
+ setActiveTab("Scope");
+ queryClient.setQueryData<Campaign[]>(["campaigns"], (old) => [campaign, ...(old ?? [])]);
+ void queryClient.invalidateQueries({ queryKey: ["campaigns"], refetchType: "all" });
+ }
+ });
+ const restore = useMutation({
+ mutationFn: () => api.restoreVault(selected),
+ onSuccess: (data) => {
+ const result = data as VaultRestoreResult;
+ const count = result?.restored ?? 0;
+ const campaignName = (detail.data ?? campaignList.find((c) => c.id === selected))?.name || selected;
+ pushLiveEvent({
+ type: "vault.restored",
+ campaign_id: selected,
+ message: `Credential vault synchronized: ${count} credential${count === 1 ? "" : "s"} rehydrated into runtime memory for '${campaignName}'.`,
+ timestamp: Date.now(),
+ restored: count
+ });
+ },
+ onError: (err) => {
+ const errorPayload = err as ApiErrorPayload;
+ const msg = errorPayload?.detail || (err as Error)?.message || "The request failed.";
+ pushLiveEvent({
+ type: "vault.restore_failed",
+ campaign_id: selected,
+ message: `Credential vault synchronization failed: ${msg}`,
+ timestamp: Date.now(),
+ error: msg
+ });
+ }
+ });
+ const run = useMutation<TemplatePlanResult | LiveExecutionResponse>({
+ mutationFn: () => {
+ const selectedCampaign = detail.data ?? campaignList.find((item) => item.id === selected);
+ const targetHost = selectedCampaign?.targets?.[0] || "10.0.0.1";
+ return api.runCampaign(selected, {
+ plan: {
+ stages: [
+ {
+ name: "Stage 1: Perimeter Recon & Fingerprint",
+ modules: ["recon.fingerprint", "network.service_detect"],
+ params: {
+ "recon.fingerprint": { target: targetHost },
+ "network.service_detect": { target: targetHost }
+ }
+ },
+ {
+ name: "Stage 2: Defense Feasibility & Coverage",
+ modules: ["opsec.coverage_predictor"],
+ params: {
+ "opsec.coverage_predictor": { target: targetHost }
+ }
+ }
+ ]
+ },
+ global_params: {
+ target: targetHost,
+ noise_profile: selectedCampaign?.noise_profile || "stealth"
+ },
+ dry_run: true
+ });
+ },
+ onSuccess: (data) => {
+ const planResult = data as TemplatePlanResult;
+ const isReady = planResult?.summary?.ready_to_run !== false;
+ const stageCount = Array.isArray(planResult?.plan)
+ ? planResult.plan.length
+ : (planResult?.summary?.total_stages ?? 2);
+ const campaignName = (detail.data ?? campaignList.find((c) => c.id === selected))?.name || selected;
+ pushLiveEvent({
+ type: isReady ? "campaign.dry_run_ready" : "campaign.dry_run_warning",
+ campaign_id: selected,
+ message: `Plan pre-flight check ${isReady ? "passed" : "completed with warnings"}: ${stageCount} stages verified for '${campaignName}'. Status: ${isReady ? "READY" : "WARNING"}.`,
+ timestamp: Date.now(),
+ plan: planResult?.plan,
+ summary: planResult?.summary
+ });
+ },
+ onError: (err) => {
+ const errorPayload = err as ApiErrorPayload;
+ const msg = errorPayload?.detail || (err as Error)?.message || "The request failed.";
+ pushLiveEvent({
+ type: "campaign.dry_run_failed",
+ campaign_id: selected,
+ message: `Dry-run plan validation failed: ${msg}`,
+ timestamp: Date.now(),
+ error: msg
+ });
+ }
+ });
+
+ const handleDelete = async (targetId: string) => {
+ if (!targetId || isDeleting) return;
+ setLocalDeleting(true);
+ setDeleteError(null);
+ try {
+ const ok = await deleteCampaign(targetId);
+ if (ok) {
+ setSelected("");
+ setOtherId("");
+ setActiveTab("List");
+ } else {
+ setDeleteError("Failed to delete campaign");
+ }
+ } catch (err) {
+ setDeleteError(err);
+ } finally {
+ setLocalDeleting(false);
+ }
+ };
+
+ return (
+ <Page
+ title="Campaigns"
+ actions={<span className="status-pill">{campaignList.length} campaigns</span>}
+ tabs={["List", "Scope", "Findings"]}
+ activeTab={activeTab}
+ onTabChange={setActiveTab}
+ >
+ {activeTab === "List" && (
+ <>
+ <section className="panel p-4">
+ <SectionHeader title="Create Campaign" />
+ <form className="grid gap-3" onSubmit={(e) => {
+ e.preventDefault();
+ if (!e.currentTarget.reportValidity()) return;
+ const invalidScopeEntries = findInvalidScopeEntries(scope);
+ if (invalidScopeEntries.length > 0) {
+ setCreateWarning(`Scope CIDRs must be valid IPv4 CIDR/IP entries. Invalid: ${invalidScopeEntries.slice(0, 3).join(", ")}. Example: 10.0.0.0/24`);
+ return;
+ }
+ setCreateWarning("");
+ create.mutate();
+ }}>
+ <div className="grid gap-3 sm:grid-cols-2">
+ <input className="field" required placeholder="Name" value={name} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setCreateWarning(""); setName(e.target.value); }} />
+ <input className="field" required placeholder="Client" value={client} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setCreateWarning(""); setClient(e.target.value); }} />
+ </div>
+ <select className="field" value={noiseProfile} onChange={(e) => { setCreateWarning(""); setNoiseProfile(e.target.value); }}>
+ <option value="stealth">Stealth</option>
+ <option value="normal">Normal</option>
+ <option value="aggressive">Aggressive</option>
+ </select>
+ <textarea className="field min-h-20" required placeholder="Targets" value={targets} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setCreateWarning(""); setTargets(e.target.value); }} />
+ <textarea className="field min-h-20" required placeholder="Scope CIDRs" value={scope} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setCreateWarning(""); setScope(e.target.value); }} />
+ {createWarning && <p className="notice notice-danger">{createWarning}</p>}
+ <button className="btn btn-primary" disabled={create.isPending} type="submit">
+ Create Campaign
+ </button>
+ </form>
+ <DataPanel title="Create Error" data={create.error} />
+ </section>
+ <CampaignTable campaigns={campaignList} />
+ </>
+ )}
+ {activeTab === "Scope" && (
+ <>
+ <section className="panel p-4">
+ <SectionHeader title="Campaign Detail" />
+ <div>
+ <label htmlFor="scope-campaign-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
+ Target Campaign
+ </label>
+ <CampaignPicker id="scope-campaign-select" campaigns={campaignList} value={selected} onChange={setSelected} />
+ </div>
+ <CampaignScopeSummary campaign={detail.data ?? campaignList.find((item) => item.id === selected)} loading={detail.isFetching} />
+ <div className="mt-3 flex flex-wrap gap-2 items-center">
+ <button
+ className="btn"
+ disabled={!selected || restore.isPending}
+ onClick={() => restore.mutate()}
+ type="button"
+ >
+ {restore.isPending && <Loader2 className="spin" size={14} />}
+ <span>{restore.isPending ? "Restoring Vault…" : "Restore Vault"}</span>
+ </button>
+ <button
+ className="btn"
+ disabled={!selected || run.isPending}
+ onClick={() => run.mutate()}
+ type="button"
+ >
+ {run.isPending && <Loader2 className="spin" size={14} />}
+ <span>{run.isPending ? "Simulating Dry Run…" : "Dry Run Plan"}</span>
+ </button>
+ <button
+ className="btn btn-danger"
+ disabled={!selected || isDeleting}
+ onClick={() => setDeleteTarget(selected)}
+ >
+ {isDeleting ? "Deleting…" : "Delete"}
+ </button>
+ <input className="field max-w-xs" placeholder="Compare campaign ID" value={otherId} onChange={(e) => setOtherId(e.target.value)} />
+ </div>
+ </section>
+
+ <DataPanel title="Vault Restore Error" data={restore.error} />
+ <DataPanel title="Dry Run Error" data={run.error} />
+ <DataPanel title="Delete Error" data={deleteError} />
+ <DataPanel title="Campaign Detail Error" data={detail.error} />
+ <DataPanel title="CVSS Error" data={cvss.error} />
+ <DataPanel title="Campaign Diff Error" data={diff.error} />
+ {cvss.data && <CvssScoreCard data={cvss.data} />}
+ {diff.data && <CampaignDiffCard data={diff.data} />}
+ </>
+ )}
+ {activeTab === "Findings" && (
+ <section className="grid gap-4">
+ <section className="panel p-4">
+ <SectionHeader title="Campaign Findings" />
+ <div>
+ <label htmlFor="findings-campaign-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
+ Target Campaign
+ </label>
+ <CampaignPicker id="findings-campaign-select" campaigns={campaignList} value={selected} onChange={setSelected} />
+ </div>
+ {!selected ? <EmptyState text="Select a campaign to review findings." /> : null}
+ </section>
+ {selected ? <DataPanel title="Findings Error" data={findings.error} /> : null}
+ {selected ? <FindingsTable findings={findings.data ?? []} /> : null}
+ </section>
+ )}
+ <ConfirmModal
+ open={deleteTarget !== null}
+ title="Delete Campaign"
+ description="Permanently delete this campaign and all its stored findings, hosts, credentials, and loot artifacts. This action cannot be undone."
+ confirmLabel="Delete Campaign"
+ cancelLabel="Cancel"
+ variant="danger"
+ onConfirm={() => {
+ if (deleteTarget) {
+ const target = deleteTarget;
+ setDeleteTarget(null);
+ void handleDelete(target);
+ }
+ }}
+ onCancel={() => setDeleteTarget(null)}
+ />
+ </Page>
+ );
+}
+
+
+
+export default CampaignsPage;
diff --git a/frontend/src/features/dashboard/pages/EdrPage.tsx b/frontend/src/features/dashboard/pages/EdrPage.tsx
new file mode 100644
index 0000000..cffc167
--- /dev/null
+++ b/frontend/src/features/dashboard/pages/EdrPage.tsx
@@ -0,0 +1,261 @@
+import {
+ ChevronDown,
+ FileText,
+ Loader2,
+ ShieldCheck,
+} from "lucide-react";
+import { useState } from "react";
+import { useMutation, useQuery } from "@tanstack/react-query";
+import { api } from "../../../api/client";
+import { StructuredJsonViewer } from "../../../components/common/StructuredJsonViewer";
+import {
+ useSessionState,
+ useTabParam,
+} from "../dashboardUiState";
+import {
+ DataPanel,
+ MiniStat,
+ Page,
+ PersistedResult,
+ SectionHeader,
+ clearValidationMessage,
+ serializeError,
+ setRequiredMessage,
+} from "../dashboardComponents";
+
+function EdrStatsSummary({
+ statsData,
+ error
+}: {
+ statsData?: Record<string, unknown>;
+ error?: unknown;
+}) {
+ const [showRaw, setShowRaw] = useState(false);
+ const technique = typeof statsData?.technique_id === "string" && statsData.technique_id ? statsData.technique_id : "All Techniques";
+ const vendor = typeof statsData?.edr_vendor === "string" && statsData.edr_vendor ? statsData.edr_vendor : "All Vendors";
+ const rate = typeof statsData?.success_rate === "number" ? statsData.success_rate : null;
+ const message = typeof statsData?.message === "string" ? statsData.message : "Historical bypass knowledge base telemetry.";
+ const statsList = Array.isArray(statsData?.stats) ? (statsData.stats as Record<string, unknown>[]) : [];
+
+ const rateTone = rate != null ? (rate >= 0.8 ? "badge badge-low" : rate >= 0.5 ? "badge badge-medium" : "badge badge-high") : "badge";
+ const rateLabel = rate != null ? `${(rate * 100).toFixed(0)}%` : "N/A";
+ const evasionAssessment = rate != null ? (rate >= 0.8 ? "High Evasion" : rate >= 0.5 ? "Moderate Evasion" : "High Detection Risk") : "Insufficient Samples";
+
+ return (
+ <div className="grid gap-4">
+ {error ? (
+ <DataPanel title="Stats Error" data={error} />
+ ) : (
+ <>
+ <section className="panel p-4">
+ <SectionHeader
+ title="Bypass Knowledge Base"
+ description="Historical evasion success metrics calibrated against active endpoint detection agents."
+ action={<span className={rateTone}>{evasionAssessment}</span>}
+ />
+ <div className="mini-stat-grid mt-3">
+ <MiniStat
+ title="Technique Under Test"
+ value={technique}
+ detail="MITRE / ARES technique ID"
+ />
+ <MiniStat
+ title="Target EDR Vendor"
+ value={vendor}
+ detail="Security agent signature"
+ />
+ <MiniStat
+ title="Historical Bypass Rate"
+ value={rateLabel}
+ detail={rate != null ? `${evasionAssessment} probability` : "Min 3 samples required"}
+ />
+ <MiniStat
+ title="Telemetry Status"
+ value={rate != null ? "Calibrated" : "Sampling"}
+ detail={rate != null ? "Statistically valid" : "Pending further reports"}
+ />
+ </div>
+ <div className="mt-3 p-3 rounded border border-zinc-800 bg-zinc-900/60 text-xs text-zinc-300 flex items-center gap-2">
+ <ShieldCheck size={14} className="text-cyan-400 shrink-0" />
+ <span>{message}</span>
+ </div>
+ </section>
+
+ {statsList.length > 0 && (
+ <section className="panel table-panel">
+ <SectionHeader
+ title="Historical Technique Records"
+ action={<span className="badge">{statsList.length} records</span>}
+ />
+ <div className="table-scroll">
+ <table className="table">
+ <thead>
+ <tr>
+ <th>Technique</th>
+ <th>EDR Vendor</th>
+ <th>Success Rate</th>
+ <th>Samples</th>
+ </tr>
+ </thead>
+ <tbody>
+ {statsList.map((item, index) => {
+ const t = String(item.technique_id ?? `technique-${index}`);
+ const v = String(item.edr_vendor ?? "all");
+ const r = typeof item.success_rate === "number" ? item.success_rate : null;
+ const count = typeof item.sample_count === "number" ? item.sample_count : (item.count ?? "—");
+ return (
+ <tr key={`${t}-${v}-${index}`}>
+ <td className="font-mono text-xs font-semibold text-zinc-200">{t}</td>
+ <td>
+ <span className="badge font-mono text-[11px]">{v}</span>
+ </td>
+ <td>
+ <span className={r != null ? (r >= 0.8 ? "badge badge-low" : r >= 0.5 ? "badge badge-medium" : "badge badge-high") : "badge"}>
+ {r != null ? `${(r * 100).toFixed(0)}%` : "N/A"}
+ </span>
+ </td>
+ <td className="font-mono text-xs text-zinc-400">{String(count)}</td>
+ </tr>
+ );
+ })}
+ </tbody>
+ </table>
+ </div>
+ </section>
+ )}
+
+ {statsData && (
+ <section className="panel p-4">
+ <div className="flex items-center justify-between">
+ <span className="text-xs text-zinc-400">Raw telemetry dataset:</span>
+ <button
+ type="button"
+ onClick={() => setShowRaw(!showRaw)}
+ className="btn btn-compact text-[11px] py-1 px-2.5 text-zinc-400 hover:text-zinc-200 flex items-center gap-1.5"
+ >
+ <FileText size={12} />
+ <span>{showRaw ? "Hide Raw Stats JSON" : "View Raw Stats JSON"}</span>
+ <ChevronDown size={12} className={`transition-transform duration-200 ${showRaw ? "rotate-180" : ""}`} />
+ </button>
+ </div>
+ {showRaw && (
+ <div className="mt-3">
+ <StructuredJsonViewer data={statsData} title="Raw EDR Bypass Stats" maxHeightClass="max-h-72" />
+ </div>
+ )}
+ </section>
+ )}
+ </>
+ )}
+ </div>
+ );
+}
+
+const VALID_TABS_EDR = ["Knowledge Base", "Report Outcome", "Stats"] as const;
+type EdrTab = typeof VALID_TABS_EDR[number];
+
+export function EdrPage() {
+ const stats = useQuery({ queryKey: ["edr-stats"], queryFn: api.edrStats });
+ const [techniqueId, setTechniqueId] = useSessionState("ares.dashboard.edr.techniqueId", "");
+ const [vendor, setVendor] = useSessionState("ares.dashboard.edr.vendor", "");
+ const [version, setVersion] = useSessionState("ares.dashboard.edr.version", "");
+ const [success, setSuccess] = useSessionState("ares.dashboard.edr.success", false);
+ const [notes, setNotes] = useSessionState("ares.dashboard.edr.notes", "");
+ const [lastReportResult, setLastReportResult] = useSessionState<PersistedResult | null>("ares.dashboard.edr.lastReport", null);
+ const [rawTab, setActiveTab] = useTabParam("Knowledge Base");
+ const activeTab = (VALID_TABS_EDR as readonly string[]).includes(rawTab)
+ ? (rawTab as EdrTab)
+ : "Knowledge Base";
+ const edrReportKey = `${techniqueId.trim()}:${vendor.trim()}:${version.trim()}:${success}:${notes.trim()}`;
+ const report = useMutation({
+ mutationFn: () =>
+ api.reportBypass({
+ technique_id: techniqueId.trim(),
+ edr_vendor: vendor.trim(),
+ edr_version: version.trim(),
+ success,
+ notes: notes.trim()
+ }),
+ onSuccess: (payload) => setLastReportResult({ key: edrReportKey, payload }),
+ onError: (error) => setLastReportResult({ key: edrReportKey, payload: serializeError(error), isError: true })
+ });
+ const persistedReportResult = lastReportResult?.key === edrReportKey ? lastReportResult : null;
+ return (
+ <Page
+ title="EDR/OPSEC"
+ actions={<span className={success ? "status-pill status-low" : "status-pill status-medium"}>{success ? "Successful" : "Blocked / detected"}</span>}
+ tabs={["Knowledge Base", "Report Outcome"]}
+ activeTab={activeTab === "Stats" ? "Knowledge Base" : activeTab}
+ onTabChange={setActiveTab}
+ >
+ {(activeTab === "Knowledge Base" || (activeTab as string) === "Stats") && (
+ <EdrStatsSummary statsData={stats.data as Record<string, unknown> | undefined} error={stats.error} />
+ )}
+ {activeTab === "Report Outcome" && (
+ <>
+ <section className="panel p-4">
+ <SectionHeader title="Report Outcome" />
+ <form className="grid gap-3" onSubmit={(event) => {
+ event.preventDefault();
+ if (!event.currentTarget.reportValidity()) return;
+ report.mutate();
+ }}>
+ <div className="grid gap-3 md:grid-cols-2">
+ <div className="block">
+ <label htmlFor="edr-technique-id" className="block text-sm font-semibold mb-1 cursor-pointer">
+ Technique ID <span className="text-red-700">*</span>
+ </label>
+ <input id="edr-technique-id" className="field" required autoComplete="off" spellCheck={false} placeholder="edr.bypass_adaptive / amsi-patch-reflection" value={techniqueId} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setTechniqueId(e.target.value); }} />
+ </div>
+ <div className="block">
+ <label htmlFor="edr-vendor-name" className="block text-sm font-semibold mb-1 cursor-pointer">
+ EDR vendor <span className="text-red-700">*</span>
+ </label>
+ <input id="edr-vendor-name" className="field" required autoComplete="off" spellCheck={false} placeholder="crowdstrike, defender_atp, sentinelone" value={vendor} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setVendor(e.target.value); }} />
+ </div>
+ <div className="block">
+ <label htmlFor="edr-version-field" className="block text-sm font-semibold mb-1 cursor-pointer">
+ EDR version
+ </label>
+ <input id="edr-version-field" className="field" autoComplete="off" spellCheck={false} placeholder="optional" value={version} onChange={(e) => setVersion(e.target.value)} />
+ </div>
+ <div className="block">
+ <label htmlFor="edr-outcome-field" className="block text-sm font-semibold mb-1 cursor-pointer">
+ Outcome
+ </label>
+ <select id="edr-outcome-field" className="field" value={success ? "success" : "blocked"} onChange={(e) => setSuccess(e.target.value === "success")}>
+ <option value="blocked">Blocked / detected</option>
+ <option value="success">Successful</option>
+ </select>
+ </div>
+ </div>
+ <div className="block">
+ <label htmlFor="edr-notes-field" className="block text-sm font-semibold mb-1 cursor-pointer">
+ Notes
+ </label>
+ <textarea id="edr-notes-field" className="field min-h-24" autoComplete="off" spellCheck={false} placeholder="Signal observed, lab context, or detection notes" value={notes} onChange={(e) => setNotes(e.target.value)} />
+ </div>
+ <button className="btn btn-primary" disabled={report.isPending} type="submit">
+ {report.isPending ? (
+ <>
+ <Loader2 className="spin" size={16} /> Saving...
+ </>
+ ) : (
+ "Report Outcome"
+ )}
+ </button>
+ </form>
+ </section>
+ <DataPanel
+ title={(report.error ?? (persistedReportResult?.isError ? persistedReportResult.payload : undefined)) ? "Outcome Error" : "Outcome Result"}
+ data={report.data ?? report.error ?? persistedReportResult?.payload}
+ />
+ </>
+ )}
+ </Page>
+ );
+}
+
+
+
+export default EdrPage;
diff --git a/frontend/src/features/dashboard/pages/LivePage.tsx b/frontend/src/features/dashboard/pages/LivePage.tsx
new file mode 100644
index 0000000..2ced2be
--- /dev/null
+++ b/frontend/src/features/dashboard/pages/LivePage.tsx
@@ -0,0 +1,227 @@
+import { useMemo, useState } from "react";
+import type { LiveWebSocketEvent } from "../../../api/types";
+import {
+ useDashboardUi,
+ useTabParam,
+} from "../dashboardUiState";
+import {
+ CampaignPicker,
+ EmptyState,
+ LiveEventCard,
+ Page,
+ SectionHeader,
+} from "../dashboardComponents";
+
+const VALID_TABS_LIVE = ["Stream", "Buffer"] as const;
+type LiveTab = typeof VALID_TABS_LIVE[number];
+
+export function LivePage() {
+ const {
+ selectedCampaignId,
+ setSelectedCampaignId,
+ liveCampaignId,
+ setLiveCampaignId,
+ liveConnected,
+ setLiveConnected,
+ liveEvents,
+ clearLiveEvents,
+ campaigns: campaignList
+ } = useDashboardUi();
+ const campaignId = liveCampaignId || selectedCampaignId;
+ const [rawTab, setActiveTab] = useTabParam("Stream");
+ const activeTab = (VALID_TABS_LIVE as readonly string[]).includes(rawTab)
+ ? (rawTab as LiveTab)
+ : "Stream";
+ const [bufferViewScope, setBufferViewScope] = useState<"session" | "all">("session");
+
+ const currentCampaign = useMemo(() => {
+ return campaignList.find((c) => c.id === campaignId);
+ }, [campaignList, campaignId]);
+
+ // Session-isolated events for active campaign
+ const sessionEvents = useMemo(() => {
+ if (!campaignId) return [];
+ return liveEvents.filter((event) => {
+ const record = event && typeof event === "object" ? (event as Record<string, unknown>) : null;
+ return record?.campaign_id === campaignId;
+ });
+ }, [liveEvents, campaignId]);
+
+ // Stream uses campaign session events if a campaign is chosen, or global events if viewing all
+ const scopedEvents = useMemo(() => {
+ return campaignId ? sessionEvents : liveEvents;
+ }, [campaignId, sessionEvents, liveEvents]);
+
+ const streamEvents = useMemo(() => scopedEvents.slice(0, 10), [scopedEvents]);
+
+ const displayedBufferEvents = useMemo(() => {
+ if (!campaignId || bufferViewScope === "all") {
+ return liveEvents;
+ }
+ return sessionEvents;
+ }, [campaignId, bufferViewScope, liveEvents, sessionEvents]);
+
+ return (
+ <Page
+ title="Live Events"
+ actions={<span className={liveConnected ? "status-pill status-low" : "status-pill"}>{liveConnected ? "Listening" : "Offline"}</span>}
+ tabs={["Stream", "Buffer"]}
+ activeTab={activeTab}
+ onTabChange={setActiveTab}
+ >
+ {activeTab === "Stream" && (
+ <>
+ <div className="panel p-4">
+ <SectionHeader
+ title="Campaign Event Stream"
+ action={<span className="badge">{scopedEvents.length} buffered</span>}
+ description="Watch selected campaign events."
+ />
+ <CampaignPicker
+ campaigns={campaignList}
+ value={campaignId}
+ onChange={(id) => {
+ setLiveCampaignId(id);
+ setSelectedCampaignId(id);
+ if (!id && liveConnected) {
+ setLiveConnected(false);
+ }
+ }}
+ />
+ <div className="mt-3 flex flex-wrap items-center gap-2">
+ <button className="btn btn-primary" disabled={!campaignId || liveConnected} onClick={() => {
+ if (!liveCampaignId && campaignId) {
+ setLiveCampaignId(campaignId);
+ }
+ setLiveConnected(true);
+ }}>
+ {liveConnected ? "Connected" : "Connect Stream"}
+ </button>
+ {liveConnected && (
+ <button className="btn" onClick={() => setLiveConnected(false)}>
+ Disconnect
+ </button>
+ )}
+ <span className={liveConnected ? "badge badge-low" : "badge"}>{liveConnected ? "listening" : "offline"}</span>
+ </div>
+ </div>
+ <section className="panel p-4">
+ <SectionHeader
+ title="Current Stream"
+ action={
+ <div className="flex items-center gap-2">
+ <span className="badge">{streamEvents.length} newest</span>
+ {streamEvents.length > 0 && (
+ <button
+ className="btn"
+ onClick={() => {
+ if (campaignId) {
+ clearLiveEvents(campaignId);
+ } else {
+ clearLiveEvents();
+ }
+ }}
+ >
+ Clear Stream
+ </button>
+ )}
+ </div>
+ }
+ />
+ {streamEvents.length > 0 ? (
+ <div className="grid gap-2">
+ {streamEvents.map((event, index) => (
+ <LiveEventCard
+ event={event}
+ index={index}
+ key={(event as LiveWebSocketEvent)?.id || `${(event as LiveWebSocketEvent)?.timestamp || index}-${index}`}
+ campaigns={campaignList}
+ />
+ ))}
+ </div>
+ ) : (
+ <EmptyState
+ text={
+ !campaignId
+ ? "Select a campaign session to stream events, or view global buffer."
+ : liveConnected
+ ? `Connected to session '${currentCampaign?.name || campaignId}'. Waiting for incoming events...`
+ : `Session ready for '${currentCampaign?.name || campaignId}'. Click 'Connect Stream' to begin monitoring.`
+ }
+ />
+ )}
+ </section>
+ </>
+ )}
+ {activeTab === "Buffer" && (
+ <section className="panel p-4">
+ <SectionHeader
+ title="Buffered Events"
+ action={
+ <div className="flex items-center gap-2">
+ {campaignId && (
+ <div className="flex items-center gap-1 rounded bg-zinc-900/80 p-0.5 border border-zinc-800 text-xs">
+ <button
+ type="button"
+ className={`px-2 py-0.5 rounded transition ${bufferViewScope === "session" ? "bg-zinc-800 text-zinc-100 font-medium" : "text-zinc-400 hover:text-zinc-200"}`}
+ onClick={() => setBufferViewScope("session")}
+ >
+ Active Session ({sessionEvents.length})
+ </button>
+ <button
+ type="button"
+ className={`px-2 py-0.5 rounded transition ${bufferViewScope === "all" ? "bg-zinc-800 text-zinc-100 font-medium" : "text-zinc-400 hover:text-zinc-200"}`}
+ onClick={() => setBufferViewScope("all")}
+ >
+ All Sessions ({liveEvents.length})
+ </button>
+ </div>
+ )}
+ {displayedBufferEvents.length > 0 ? (
+ <button
+ className="btn"
+ onClick={() => {
+ if (campaignId && bufferViewScope === "session") {
+ clearLiveEvents(campaignId);
+ } else {
+ clearLiveEvents();
+ }
+ }}
+ >
+ {campaignId && bufferViewScope === "session" ? "Clear Session Events" : "Clear All Events"}
+ </button>
+ ) : (
+ <span className="badge">0 retained</span>
+ )}
+ </div>
+ }
+ />
+ {displayedBufferEvents.length > 0 ? (
+ <div className="grid gap-2">
+ {displayedBufferEvents.map((event, index) => (
+ <LiveEventCard
+ event={event}
+ index={index}
+ key={(event as LiveWebSocketEvent)?.id || `${(event as LiveWebSocketEvent)?.timestamp || index}-${index}`}
+ campaigns={campaignList}
+ />
+ ))}
+ </div>
+ ) : (
+ <EmptyState
+ text={
+ campaignId && bufferViewScope === "session"
+ ? `No events retained for session '${currentCampaign?.name || campaignId}'.`
+ : "No events retained in the buffer."
+ }
+ />
+ )}
+ </section>
+ )}
+ </Page>
+ );
+}
+
+
+
+export default LivePage;
diff --git a/frontend/src/features/dashboard/pages/ModulesPage.tsx b/frontend/src/features/dashboard/pages/ModulesPage.tsx
new file mode 100644
index 0000000..3c47250
--- /dev/null
+++ b/frontend/src/features/dashboard/pages/ModulesPage.tsx
@@ -0,0 +1,627 @@
+import {
+ AlertTriangle,
+ Info,
+ Loader2,
+ Lock,
+ Search,
+ Target,
+ X,
+} from "lucide-react";
+import {
+ useEffect,
+ useMemo,
+ useRef,
+ useState,
+} from "react";
+import { useLocation, useSearchParams } from "react-router-dom";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { api, buildModuleRunPayload } from "../../../api/client";
+import type {
+ ExecutionChain,
+} from "../../../api/types";
+import {
+ useDashboardUi,
+ useSessionState,
+ useTabParam,
+} from "../dashboardUiState";
+import {
+ CampaignPicker,
+ DataPanel,
+ EmptyState,
+ ModuleRunRecord,
+ ModuleRunSummary,
+ Page,
+ ParamForm,
+ SectionHeader,
+ isSensitiveModule,
+ moduleRunHint,
+ moduleScopeWarning,
+ opsecBadge,
+ serializeError,
+ unique,
+} from "../dashboardComponents";
+
+function ExecutionChainsPanel({
+ chains,
+ moduleIds,
+ onSelectModule
+}: {
+ chains: ExecutionChain[];
+ moduleIds: Set<string>;
+ onSelectModule: (moduleId: string) => void;
+}) {
+ if (chains.length === 0) {
+ return <EmptyState text="No execution chains are available." />;
+ }
+ return (
+ <section className="grid gap-3">
+ {chains.map((chain) => (
+ <article className="panel p-4" key={chain.id}>
+ <SectionHeader
+ title={chain.title}
+ eyebrow={chain.category}
+ description={chain.description}
+ action={<span className="badge">{chain.stages.length} stages</span>}
+ />
+ <div className="grid gap-3">
+ {chain.stages.map((stage) => (
+ <div className="compact-row" key={`${chain.id}-${stage.order}`}>
+ <div className="flex flex-wrap items-center justify-between gap-2">
+ <div className="flex flex-wrap items-center gap-2">
+ <span className="badge">Step {stage.order}</span>
+ <strong>{stage.title}</strong>
+ {stage.final_goal && <span className="badge badge-low">Final goal</span>}
+ </div>
+ <span className="text-xs font-medium text-zinc-400">
+ {stage.uses_previous_output ? "Uses prior output" : "Starts from campaign inputs"}
+ </span>
+ </div>
+ <p className="mt-2 text-sm text-zinc-300">{stage.purpose}</p>
+ {stage.module_ids.length > 0 && (
+ <div className="mt-3 flex flex-wrap items-center gap-2">
+ <strong className="text-sm">Run</strong>
+ {stage.module_ids.map((moduleId) => (
+ <button
+ className="btn btn-compact"
+ disabled={!moduleIds.has(moduleId)}
+ key={moduleId}
+ onClick={() => onSelectModule(moduleId)}
+ title={moduleIds.has(moduleId) ? `Open ${moduleId} in the run panel` : "Module is not available in the current catalog"}
+ type="button"
+ >
+ {moduleId}
+ </button>
+ ))}
+ </div>
+ )}
+ <div className="mt-3 grid gap-1 text-xs text-zinc-400">
+ <span><strong>Inputs:</strong> {stage.required_inputs.join(", ") || "none"}</span>
+ <span><strong>Produces:</strong> {stage.produces.join("; ") || "none"}</span>
+ <span><strong>Next:</strong> {stage.next_action}</span>
+ </div>
+ </div>
+ ))}
+ </div>
+ </article>
+ ))}
+ </section>
+ );
+}
+
+const VALID_TABS_MODULES = ["Catalog", "Execution Chains", "Run Panel", "Results"] as const;
+type ModulesTab = typeof VALID_TABS_MODULES[number];
+
+export function ModulesPage() {
+ const { selectedCampaignId: campaignId, setSelectedCampaignId: setCampaignId, campaigns: campaignList } = useDashboardUi();
+ const [searchParams] = useSearchParams();
+ const location = useLocation();
+ const queryClient = useQueryClient();
+ const modules = useQuery({ queryKey: ["modules"], queryFn: api.modules });
+ const executionChains = useQuery({ queryKey: ["executionChains"], queryFn: api.executionChains });
+ const [selectedId, setSelectedId] = useSessionState("ares.dashboard.modules.selectedId", "");
+ const [search, setSearch] = useSessionState("ares.dashboard.modules.search", "");
+ const [category, setCategory] = useSessionState("ares.dashboard.modules.category", "");
+ const [opsec, setOpsec] = useSessionState("ares.dashboard.modules.opsec", "");
+ const [dryRun, setDryRun] = useSessionState("ares.dashboard.modules.dryRun", true);
+ const [confirmed, setConfirmed] = useSessionState("ares.dashboard.modules.confirmed", false);
+ const [params, setParams] = useSessionState<Record<string, unknown>>("ares.dashboard.modules.params", {});
+ const [lastRunRecord, setLastRunRecord] = useSessionState<ModuleRunRecord | null>("ares.dashboard.modules.lastRun", null);
+ const [rawTab, setActiveTab] = useTabParam("Catalog");
+ const activeTab = (VALID_TABS_MODULES as readonly string[]).includes(rawTab)
+ ? (rawTab as ModulesTab)
+ : "Catalog";
+ const previousSelectedId = useRef(selectedId);
+
+ useEffect(() => {
+ const queryModule = searchParams.get("module") || (location.state as { moduleId?: string } | null)?.moduleId;
+
+ if (queryModule) {
+ setSelectedId(queryModule);
+ }
+ }, [searchParams, location.state, setSelectedId]);
+ const campaignDetail = useQuery({
+ queryKey: ["campaign", campaignId],
+ queryFn: () => api.campaign(campaignId),
+ enabled: Boolean(campaignId)
+ });
+ const run = useMutation({
+ mutationFn: () => api.runModule(selectedId, buildModuleRunPayload(campaignId, params, dryRun)),
+ onSuccess: (payload) => {
+ setLastRunRecord({ campaignId, moduleId: selectedId, payload });
+ setActiveTab("Results");
+ if (!dryRun) {
+ void queryClient.invalidateQueries({ queryKey: ["graph"] });
+ void queryClient.invalidateQueries({ queryKey: ["campaigns"] });
+ void queryClient.invalidateQueries({ queryKey: ["campaign", campaignId] });
+ void queryClient.invalidateQueries({ queryKey: ["attack-paths"] });
+ void queryClient.invalidateQueries({ queryKey: ["findings"] });
+ void queryClient.invalidateQueries({ queryKey: ["telemetry"] });
+ void queryClient.invalidateQueries({ queryKey: ["monthlyStats"] });
+ }
+ },
+ onError: (error) => {
+ setLastRunRecord({ campaignId, moduleId: selectedId, payload: serializeError(error), isError: true });
+ setActiveTab("Results");
+ if (!dryRun) {
+ void queryClient.invalidateQueries({ queryKey: ["graph"] });
+ void queryClient.invalidateQueries({ queryKey: ["campaigns"] });
+ void queryClient.invalidateQueries({ queryKey: ["campaign", campaignId] });
+ void queryClient.invalidateQueries({ queryKey: ["attack-paths"] });
+ void queryClient.invalidateQueries({ queryKey: ["findings"] });
+ void queryClient.invalidateQueries({ queryKey: ["telemetry"] });
+ void queryClient.invalidateQueries({ queryKey: ["monthlyStats"] });
+ }
+ }
+ });
+ const list = useMemo(() => modules.data ?? [], [modules.data]);
+ const moduleIds = useMemo(() => new Set(list.map((item) => item.id)), [list]);
+ const relatedChainsByModule = useMemo(() => {
+ const related = new Map<string, string[]>();
+ for (const chain of executionChains.data ?? []) {
+ for (const stage of chain.stages) {
+ for (const moduleId of stage.module_ids) {
+ const current = related.get(moduleId) ?? [];
+ if (!current.includes(chain.title)) {
+ current.push(chain.title);
+ }
+ related.set(moduleId, current);
+ }
+ }
+ }
+ return related;
+ }, [executionChains.data]);
+ const selected = list.find((item) => item.id === selectedId);
+ const selectedCampaign = campaignDetail.data ?? campaignList.find((item) => item.id === campaignId);
+ const scopeWarning = moduleScopeWarning(selected, selectedCampaign, params, dryRun);
+ const categories = unique(list.map((item) => item.category || ""));
+ const visible = list.filter((item) => {
+ const haystack = `${item.id} ${item.name ?? ""} ${item.description ?? ""} ${item.mitre ?? ""}`.toLowerCase();
+ return (
+ (!search || haystack.includes(search.toLowerCase())) &&
+ (!category || item.category === category) &&
+ (!opsec || item.opsec_level === opsec)
+ );
+ });
+ const sensitive = isSensitiveModule(selected);
+ const requiresConfirmation = sensitive;
+ const dryRunSupported = selected?.dry_run_supported !== false;
+ const kerberoastTargetMissing = selected?.id === "ad.kerberoast" && !String(params.target_user ?? "").trim();
+ const [attemptedRun, setAttemptedRun] = useState(false);
+ const executionConditionBlocked = (!requiresConfirmation || confirmed) && !run.isPending && (!dryRun || dryRunSupported) && !scopeWarning && !kerberoastTargetMissing;
+ const runHint = moduleRunHint(campaignId, selected, selectedCampaign, sensitive, confirmed, dryRun);
+ const activeRun = (run.data ? { campaignId, moduleId: selectedId, payload: run.data, isError: false } : null) ??
+ (lastRunRecord?.campaignId === campaignId ? lastRunRecord : null);
+ const runResult = (!activeRun?.isError ? activeRun?.payload : undefined) as Record<string, unknown> | undefined;
+ const runError = run.error ?? (activeRun?.isError ? activeRun.payload : undefined);
+
+ useEffect(() => {
+ let incomingParams: Record<string, unknown> | null = null;
+ try {
+ const stored = sessionStorage.getItem("ares.dashboard.modules.params");
+ if (stored) {
+ incomingParams = JSON.parse(stored);
+ sessionStorage.removeItem("ares.dashboard.modules.params");
+ }
+ } catch {
+ incomingParams = null;
+ }
+
+ const queryTarget = searchParams.get("target") || (location.state as { target?: string } | null)?.target;
+ const stateParams = (location.state as { params?: Record<string, unknown> } | null)?.params;
+ if (queryTarget || stateParams) {
+ incomingParams = {
+ ...(incomingParams ?? {}),
+ ...(queryTarget ? { target: queryTarget, host: queryTarget, dc: queryTarget, targets: [queryTarget] } : {}),
+ ...(stateParams ?? {})
+ };
+ }
+
+ if (previousSelectedId.current === selectedId && !incomingParams) {
+ return;
+ }
+ previousSelectedId.current = selectedId;
+
+ const currentTarget = String(
+ incomingParams?.target ||
+ incomingParams?.host ||
+ incomingParams?.dc ||
+ params.target ||
+ params.host ||
+ params.dc ||
+ params.target_host ||
+ params.rhost ||
+ selectedCampaign?.targets?.[0] ||
+ ""
+ ).trim();
+
+ const targetModule = list.find((item) => item.id === selectedId);
+ const schema = targetModule?.param_schema ?? {};
+ const schemaKeys = Object.keys(schema);
+
+ const nextParams: Record<string, unknown> = {};
+
+ // 1. Populate primary target/host/dc fields if supported by module schema
+ if (schemaKeys.includes("target") && currentTarget) {
+ nextParams.target = currentTarget;
+ }
+ if (schemaKeys.includes("host") && currentTarget) {
+ nextParams.host = currentTarget;
+ }
+ if (schemaKeys.includes("dc") && currentTarget) {
+ nextParams.dc = currentTarget;
+ }
+ if (schemaKeys.includes("targets") && currentTarget) {
+ nextParams.targets = [currentTarget];
+ }
+ if (schemaKeys.includes("target_host") && currentTarget) {
+ nextParams.target_host = currentTarget;
+ }
+ if (schemaKeys.includes("rhost") && currentTarget) {
+ nextParams.rhost = currentTarget;
+ }
+
+ // 2. Transfer standard parameters across chains and pivots if valid in schema
+ const contextualKeys = ["port", "ports", "service", "domain", "username", "target_user", "use_ldaps"];
+ for (const key of contextualKeys) {
+ if (schemaKeys.includes(key)) {
+ if (incomingParams && incomingParams[key] !== undefined) {
+ nextParams[key] = incomingParams[key];
+ } else if (params[key] !== undefined) {
+ nextParams[key] = params[key];
+ }
+ }
+ }
+
+ // 3. Merge any specific incoming params passed explicitly
+ if (incomingParams) {
+ for (const [k, v] of Object.entries(incomingParams)) {
+ if (v !== undefined) {
+ nextParams[k] = v;
+ }
+ }
+ }
+
+ setParams(nextParams);
+ setConfirmed(false);
+ setDryRun(true);
+ }, [selectedId, list, selectedCampaign, setConfirmed, setDryRun, setParams, searchParams, location.state]);
+
+ return (
+ <Page
+ title="Modules"
+ actions={<span className="status-pill">{visible.length} shown</span>}
+ tabs={["Catalog", "Execution Chains", "Run Panel", "Results"]}
+ activeTab={activeTab}
+ onTabChange={setActiveTab}
+ >
+ {activeTab === "Catalog" && (
+ <section className="panel p-4">
+ <SectionHeader title="Module Catalog" />
+ <div className="mb-3 grid gap-2 sm:grid-cols-3">
+ <label className="field-with-icon sm:col-span-3">
+ <Search size={15} />
+ <input placeholder="Search modules, MITRE, descriptions" value={search} onChange={(e) => setSearch(e.target.value)} />
+ </label>
+ <select className="field" value={category} onChange={(e) => setCategory(e.target.value)}>
+ <option value="">Category</option>
+ {categories.map((item) => <option key={item} value={item}>{item}</option>)}
+ </select>
+ <select className="field" value={opsec} onChange={(e) => setOpsec(e.target.value)}>
+ <option value="">OPSEC</option>
+ {unique(list.map((item) => item.opsec_level || "")).map((item) => <option key={item} value={item}>{item}</option>)}
+ </select>
+ </div>
+ <div className="grid max-h-[640px] gap-2 overflow-auto">
+ {visible.map((item) => (
+ <button
+ className={`catalog-card ${selectedId === item.id ? "active" : ""}`}
+ key={item.id}
+ onClick={() => {
+ setSelectedId(item.id);
+ setActiveTab("Run Panel");
+ }}
+ >
+ <div className="flex items-start justify-between gap-3">
+ <div>
+ <div className="font-bold">{item.id}</div>
+ <div className="text-sm text-zinc-400">{item.description}</div>
+ </div>
+ <span className={opsecBadge(item.opsec_level)}>{item.opsec_level || "n/a"}</span>
+ </div>
+ <div className="mt-2 flex flex-wrap gap-1">
+ {(item.mitre_list ?? []).slice(0, 4).map((technique) => <span className="badge" key={technique}>{technique}</span>)}
+ {(relatedChainsByModule.get(item.id) ?? []).slice(0, 2).map((chainTitle) => (
+ <span className="badge" key={chainTitle}>Chain: {chainTitle}</span>
+ ))}
+ </div>
+ </button>
+ ))}
+ {visible.length === 0 && (
+ <EmptyState text="No modules match the current search and filters." />
+ )}
+ </div>
+ <DataPanel title="Module Catalog Error" data={modules.error} />
+ </section>
+ )}
+ {activeTab === "Execution Chains" && (
+ <>
+ {executionChains.isPending && <EmptyState text="Loading execution chains..." />}
+ {executionChains.error && <DataPanel title="Execution Chain Error" data={executionChains.error} />}
+ {!executionChains.isPending && !executionChains.error && (
+ <ExecutionChainsPanel
+ chains={executionChains.data ?? []}
+ moduleIds={moduleIds}
+ onSelectModule={(moduleId) => {
+ setSelectedId(moduleId);
+ setActiveTab("Run Panel");
+ }}
+ />
+ )}
+ </>
+ )}
+ {activeTab === "Run Panel" && (
+ <section className="panel p-4">
+ <SectionHeader
+ title="Run Panel"
+ eyebrow={selected ? selected.id : "Select module"}
+ action={selected ? <span className={opsecBadge(selected.opsec_level)}>{selected.opsec_level || "n/a"}</span> : null}
+ />
+ {selected?.description && <p className="text-sm text-zinc-300">{selected.description}</p>}
+ {selected && (selected.capability_flags?.length || selected.supported_modes?.length) ? (
+ <div className="mt-2 flex flex-wrap gap-1">
+ {(selected.capability_flags ?? []).map((flag) => <span className="badge" key={flag}>{flag}</span>)}
+ {(selected.supported_modes ?? []).map((mode) => <span className="badge" key={mode}>mode: {mode}</span>)}
+ </div>
+ ) : null}
+ {selected?.dependency_notes?.length ? (
+ <p className="mt-2 text-xs text-zinc-400 flex items-center gap-1.5">
+ <Info size={13} className="text-zinc-500 shrink-0" />
+ <span className="text-zinc-400 font-medium">Dependencies:</span> {selected.dependency_notes.join("; ")}
+ </p>
+ ) : null}
+ {selected && !dryRunSupported && (
+ <p className="mt-1 text-xs text-amber-400/80 flex items-center gap-1.5">
+ <Info size={13} className="text-amber-400 shrink-0" />
+ <span>Dry-run preview is unavailable for this module.</span>
+ </p>
+ )}
+ <div className="mt-3 p-3.5 rounded-lg border border-zinc-800/80 bg-zinc-900/30">
+ <label htmlFor="module-campaign-select" className="block text-xs font-mono text-zinc-300 mb-1.5 font-medium">
+ Target Campaign
+ </label>
+ <CampaignPicker
+ id="module-campaign-select"
+ campaigns={campaignList}
+ value={campaignId}
+ hasError={attemptedRun && !campaignId}
+ onChange={(id) => {
+ setCampaignId(id);
+ if (id) {
+ setAttemptedRun(false);
+ }
+ }}
+ />
+ {attemptedRun && !campaignId && (
+ <p className="mt-1.5 flex items-center gap-1.5 text-xs text-rose-400" role="alert">
+ <AlertTriangle size={13} className="shrink-0 text-rose-400" />
+ Select a scoped campaign before executing this module.
+ </p>
+ )}
+ {campaignId && campaignDetail.isFetching && (
+ <div className="notice mt-3 text-xs">
+ <Loader2 className="spin" size={14} /> Loading campaign scope...
+ </div>
+ )}
+ <DataPanel title="Campaign Scope Error" data={campaignDetail.error} />
+ </div>
+
+ {selected ? (
+ <form
+ aria-busy={run.isPending}
+ className="mt-4 grid gap-4 p-3.5 rounded-lg border border-zinc-800/80 bg-zinc-900/30"
+ autoComplete="off"
+ data-lpignore="true"
+ data-form-type="other"
+ onSubmit={(e) => {
+ e.preventDefault();
+ if (!campaignId) {
+ setAttemptedRun(true);
+ return;
+ }
+ if (!executionConditionBlocked) {
+ return;
+ }
+ setAttemptedRun(false);
+ run.mutate();
+ }}
+ >
+ <div className="text-xs font-mono text-zinc-400 font-medium pb-2 border-b border-zinc-800/60 flex items-center justify-between">
+ <span>Module Parameters</span>
+ <span className="text-[11px] text-zinc-500 font-sans">{Object.keys(selected.param_schema || {}).length} field(s)</span>
+ </div>
+
+ {/* Quick Target Selector for In-Scope Campaign Hosts */}
+ {((selectedCampaign?.targets && selectedCampaign.targets.length > 0) || (selectedCampaign?.scope_cidrs && selectedCampaign.scope_cidrs.length > 0)) && (
+ <div className="p-2.5 rounded-sm bg-zinc-900/60 border border-zinc-800 space-y-1.5 text-xs font-mono">
+ <div className="flex items-center justify-between">
+ <span className="text-zinc-400 text-[11px] uppercase tracking-wider flex items-center gap-1.5 font-semibold">
+ <Target size={12} className="text-cyan-400 shrink-0" />
+ QUICK ENGAGEMENT TARGETS:
+ </span>
+ <span className="text-[10px] text-zinc-500 font-sans">1-click populate</span>
+ </div>
+ <div className="flex flex-wrap items-center gap-1.5">
+ {selectedCampaign?.targets?.map((tgt) => (
+ <button
+ key={tgt}
+ type="button"
+ onClick={() => setParams((prev) => ({ ...prev, target: tgt, host: tgt, dc: tgt, targets: [tgt] }))}
+ className={`px-2 py-0.5 rounded-sm border text-[11px] transition-colors ${
+ params.target === tgt || params.host === tgt || params.dc === tgt
+ ? "bg-cyan-950 border-cyan-700 text-cyan-200 font-bold"
+ : "bg-zinc-800 border-zinc-700 text-zinc-300 hover:bg-zinc-700 hover:text-zinc-100"
+ }`}
+ title={`Set target to ${tgt}`}
+ >
+ {tgt}
+ </button>
+ ))}
+ {selectedCampaign?.scope_cidrs?.map((cidr) => (
+ <button
+ key={cidr}
+ type="button"
+ onClick={() => setParams((prev) => ({ ...prev, target: cidr, cidr }))}
+ className="px-2 py-0.5 rounded-sm border border-zinc-800 bg-zinc-900 text-zinc-400 hover:bg-zinc-800 hover:text-zinc-200 text-[10px] transition-colors"
+ title={`Set scope to ${cidr}`}
+ >
+ {cidr}
+ </button>
+ ))}
+ </div>
+ </div>
+ )}
+
+ <ParamForm
+ schema={selected.param_schema}
+ values={params}
+ onChange={setParams}
+ requiredOverrides={selected.id === "ad.kerberoast" ? { target_user: true } : undefined}
+ />
+
+ {/* Execution Mode Controls */}
+ <div className="pt-2 border-t border-zinc-800/60 space-y-2.5">
+ <label className="toggle-row text-xs text-zinc-300">
+ <input type="checkbox" checked={dryRun} onChange={(e) => setDryRun(e.target.checked)} />
+ {dryRunSupported ? "Dry run (simulate without live network execution)" : "Dry run unavailable"}
+ </label>
+
+ {requiresConfirmation && (
+ <div className="notice notice-danger text-xs flex items-center gap-2.5 p-2.5 rounded border">
+ <input
+ id="confirm-override-checkbox"
+ className="cursor-pointer shrink-0"
+ type="checkbox"
+ checked={confirmed}
+ onChange={(e) => setConfirmed(e.target.checked)}
+ />
+ <label htmlFor="confirm-override-checkbox" className="cursor-pointer select-none">
+ Confirm authorized high-noise or sensitive execution
+ </label>
+ </div>
+ )}
+
+ {runHint && runHint !== "Select a campaign before running a module." && (
+ <p className="notice text-xs">{runHint}</p>
+ )}
+ {scopeWarning && (
+ <p className="notice notice-danger text-xs">{scopeWarning}</p>
+ )}
+
+ <div className="pt-2">
+ <button
+ className="btn btn-primary w-full py-2.5 text-xs font-mono font-medium tracking-wide flex items-center justify-center gap-2"
+ type="submit"
+ disabled={!selectedId || run.isPending || (campaignId ? !executionConditionBlocked : false)}
+ >
+ {run.isPending ? (
+ <>
+ <Loader2 className="spin shrink-0" size={14} /> Running {selectedId}...
+ </>
+ ) : (
+ `Execute ${selected.id}`
+ )}
+ </button>
+ </div>
+
+ {run.isPending && (
+ <div className="notice notice-info text-xs" role="status" aria-live="polite">
+ <Loader2 className="spin shrink-0" size={15} />
+ Module execution in progress. Keep this page open while ARES validates the target and collects results.
+ </div>
+ )}
+ </div>
+ </form>
+ ) : (
+ <EmptyState text="Select a module from the catalog to configure and execute." />
+ )}
+ </section>
+ )}
+ {activeTab === "Results" && (
+ <section className="panel p-4">
+ <div className="flex items-center justify-between pb-3 mb-3 border-b border-zinc-800/80">
+ <div>
+ <span className="text-[10px] font-mono text-zinc-500 uppercase tracking-wider block">
+ {activeRun?.moduleId ? `Module: ${activeRun.moduleId}` : (selected ? selected.id : "Execution")}
+ </span>
+ <h2 className="text-sm font-semibold text-zinc-100 flex items-center gap-2">
+ <span>Run Results</span>
+ {activeRun && (
+ <span className="inline-flex items-center gap-1 px-1.5 py-0.5 rounded text-[10px] font-mono bg-zinc-800 text-zinc-300 border border-zinc-700">
+ <Lock size={10} className="text-amber-400" />
+ <span>Locked View</span>
+ </span>
+ )}
+ </h2>
+ </div>
+ {activeRun && (
+ <button
+ type="button"
+ onClick={() => {
+ setLastRunRecord(null);
+ run.reset();
+ }}
+ className="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-sm border border-zinc-700 bg-zinc-800/80 hover:bg-zinc-700 text-zinc-300 hover:text-white text-xs font-mono transition-colors"
+ title="Dismiss and close this run result"
+ >
+ <X size={12} />
+ <span>Close Result</span>
+ </button>
+ )}
+ </div>
+ {runResult || runError ? (
+ <>
+ <ModuleRunSummary
+ result={runResult}
+ error={runError}
+ onSelectModule={(modId, targetParams) => {
+ setSelectedId(modId);
+ if (targetParams) {
+ setParams((prev) => ({ ...prev, ...targetParams }));
+ }
+ setActiveTab("Run Panel");
+ }}
+ />
+ <DataPanel title={runError ? "Run Error" : "Run Result"} data={runError ?? runResult} />
+ </>
+ ) : (
+ <EmptyState text="Run a selected module to see results here." />
+ )}
+ </section>
+ )}
+ </Page>
+ );
+}
+
+
+
+export default ModulesPage;
diff --git a/frontend/src/features/dashboard/pages/OverviewPage.tsx b/frontend/src/features/dashboard/pages/OverviewPage.tsx
new file mode 100644
index 0000000..0cb818f
--- /dev/null
+++ b/frontend/src/features/dashboard/pages/OverviewPage.tsx
@@ -0,0 +1,391 @@
+import {
+ Crosshair,
+ Layers,
+ Plus,
+ Radio,
+ ShieldCheck,
+ Target,
+ Terminal,
+} from "lucide-react";
+import { useNavigate } from "react-router-dom";
+import { useQuery } from "@tanstack/react-query";
+import { api } from "../../../api/client";
+import type { MonthlyFindingStats } from "../../../api/types";
+import {
+ useDashboardUi,
+} from "../dashboardUiState";
+import {
+ CampaignTable,
+ Page,
+ SparklineBars,
+ TelemetrySnapshot,
+ formatMetric,
+ formatRate,
+ formatReportTime,
+ metricNumber,
+ metricNumberOrNull,
+} from "../dashboardComponents";
+
+export function OverviewPage() {
+ const navigate = useNavigate();
+ const { campaigns: campaignList, campaignsLoading, selectedCampaignId, setSelectedCampaignId } = useDashboardUi();
+ const telemetry = useQuery({
+ queryKey: ["telemetry", selectedCampaignId],
+ queryFn: () => api.telemetry(selectedCampaignId || undefined)
+ });
+ const monthlyStats = useQuery({
+ queryKey: ["monthlyStats", selectedCampaignId],
+ queryFn: () => api.monthlyStats(selectedCampaignId || undefined)
+ });
+ const snapshot = telemetry.data as TelemetrySnapshot | undefined;
+ const monthlyData = monthlyStats.data as MonthlyFindingStats | undefined;
+
+ const selectedCampaign = selectedCampaignId
+ ? campaignList.find((campaign) => campaign.id === selectedCampaignId)
+ : undefined;
+
+ const nonDeletedCampaigns = (selectedCampaign ? [selectedCampaign] : campaignList).filter(
+ (campaign) => String(campaign.status ?? "").toLowerCase() !== "deleted"
+ );
+ const runningCampaigns = nonDeletedCampaigns.filter((campaign) =>
+ ["running", "active", "executing"].includes(String(campaign.status ?? "").toLowerCase())
+ );
+ const trackedCount = nonDeletedCampaigns.length;
+ const runningCount = runningCampaigns.length;
+
+ const findings = typeof monthlyData?.confirmed_findings === "number"
+ ? monthlyData.confirmed_findings
+ : typeof snapshot?.findings === "number"
+ ? snapshot.findings
+ : 0;
+ const monthlyTotal = typeof monthlyData?.total === "number" ? monthlyData.total : 0;
+ const monthlySeries = normalizeMonthlySeries(monthlyData?.period, monthlyData?.series);
+
+ // Dynamic header status subtitle (strictly distinguish running execution vs in-scope campaigns)
+ let overviewSubtitle: string;
+ if (selectedCampaign) {
+ const scopeStr = selectedCampaign.scope_cidrs?.length ? selectedCampaign.scope_cidrs.join(", ") : "Single target";
+ overviewSubtitle = `Active Scope: ${selectedCampaign.name} (${selectedCampaign.id.slice(0, 8)}) · CIDRs: ${scopeStr} · Telemetry Scoped`;
+ } else if (trackedCount === 0) {
+ overviewSubtitle = "Enclave standby · No campaigns in scope · Ready for campaign deployment";
+ } else if (runningCount > 0) {
+ overviewSubtitle = `${runningCount} active execution${runningCount === 1 ? "" : "s"} · ${trackedCount} in scope · Enclave telemetry streaming`;
+ } else {
+ overviewSubtitle = `${trackedCount} campaign${trackedCount === 1 ? "" : "s"} in scope · Telemetry pipeline standby · Fail-closed policy enforced`;
+ }
+
+ // Fresh install empty-state (Task 5 / CampaignSync test requirement)
+ if (!campaignsLoading && trackedCount === 0) {
+ return (
+ <Page title="Overview" subtitle={overviewSubtitle}>
+ <div className="dashboard-empty-hero">
+ <div className="fresh-hero-icon-wrap">
+ <Target size={32} className="text-cyan-400" />
+ </div>
+ <h2>No Campaigns Initialized</h2>
+ <p>
+ Initialize an authorized red-team engagement to define target boundaries,
+ configure CIDR scopes, and execute automated validation modules.
+ </p>
+ <div className="fresh-hero-actions">
+ <button
+ className="btn btn-primary flex items-center gap-2 px-4 py-2 text-sm font-semibold"
+ onClick={() => {
+ navigate("/campaigns?tab=List");
+ }}
+ type="button"
+ >
+ <Plus size={16} />
+ <span>Create First Campaign</span>
+ </button>
+ <button
+ className="btn flex items-center gap-2 px-4 py-2 text-sm"
+ onClick={() => navigate("/modules")}
+ type="button"
+ >
+ <Layers size={15} />
+ <span>Browse Module Catalog</span>
+ </button>
+ </div>
+ </div>
+
+ <div className="fresh-readiness-panel">
+ <div className="telemetry-strip flex items-center justify-between text-xs text-zinc-400">
+ <div className="flex items-center gap-5">
+ <span><strong className="text-zinc-200">Runtime:</strong> Ready</span>
+ <span><strong className="text-zinc-200">Worker Pool:</strong> {metricNumber(snapshot?.workers, "active")} active</span>
+ <span><strong className="text-zinc-200">Task Queue:</strong> {metricNumber(snapshot?.queue, "depth")} queued</span>
+ </div>
+ <span className="text-zinc-500 font-mono text-[11px]">Awaiting first engagement initialization</span>
+ </div>
+ </div>
+ </Page>
+ );
+ }
+
+ // Tactical operational metrics extraction
+ const totalRuns = metricNumber(snapshot?.modules, "total");
+ const successRuns = metricNumber(snapshot?.modules, "success");
+ const failedRuns = metricNumber(snapshot?.modules, "failed");
+ const errorRate = metricNumber(snapshot?.modules, "error_rate");
+ const p95 = metricNumberOrNull(snapshot?.latency_ms, "p95");
+ const queueDepth = metricNumber(snapshot?.queue, "depth");
+ const activeWorkers = metricNumber(snapshot?.workers, "active");
+ const hostsDiscovered = metricNumber(snapshot?.hosts, "discovered");
+ const hostsOwned = metricNumberOrNull(snapshot?.hosts, "owned");
+ const isIngestionActive = Boolean(snapshot && snapshot.timestamp);
+
+ const quickActions = (
+ <div className="overview-quick-actions">
+ <button
+ type="button"
+ className="btn btn-primary text-xs flex items-center gap-1.5"
+ onClick={() => {
+ navigate("/campaigns?tab=List");
+ }}
+ title="Initialize an authorized engagement"
+ >
+ <Plus size={14} />
+ <span>New Campaign</span>
+ </button>
+ <button
+ type="button"
+ className="btn text-xs flex items-center gap-1.5"
+ onClick={() => navigate("/modules")}
+ title="Browse validation module catalog"
+ >
+ <Layers size={14} />
+ <span>Module Catalog</span>
+ </button>
+ <button
+ type="button"
+ className="btn text-xs flex items-center gap-1.5"
+ onClick={() => navigate("/live")}
+ title="Open real-time event telemetry stream"
+ >
+ <Radio size={14} />
+ <span>Live Stream</span>
+ </button>
+ </div>
+ );
+
+ return (
+ <Page title="Overview" subtitle={overviewSubtitle} actions={quickActions}>
+ <div className="overview-shell">
+ {/* Tier 1: Executive Telemetry HUD */}
+ <div className="hud-bento-grid">
+ {/* Card 1: Active Engagements */}
+ <div className="hud-bezel-card">
+ <div className="hud-bezel-inner">
+ <div className="hud-card-header">
+ <span className="hud-card-title">Active Engagements</span>
+ </div>
+ <div className="hud-card-value">
+ {trackedCount}
+ </div>
+ <div className="hud-card-footer">
+ <span className="hud-context-text">
+ {runningCount > 0
+ ? `${runningCount} active execution${runningCount > 1 ? "s" : ""}`
+ : trackedCount > 0
+ ? "Staged readiness"
+ : "Standby"}
+ </span>
+ </div>
+ </div>
+ </div>
+
+ {/* Card 2: Validated Findings */}
+ <div className="hud-bezel-card">
+ <div className="hud-bezel-inner">
+ <div className="hud-card-header">
+ <span className="hud-card-title">Validated Findings</span>
+ </div>
+ <div className="hud-card-value">
+ {formatMetric(findings)}
+ </div>
+ <div className="hud-card-footer">
+ <span className="hud-context-text">
+ {findings > 0 ? "Confirmed security vulnerabilities" : "No vulnerabilities detected"}
+ </span>
+ </div>
+ </div>
+ </div>
+
+ {/* Card 3: Attack Surface */}
+ <div className="hud-bezel-card">
+ <div className="hud-bezel-inner">
+ <div className="hud-card-header">
+ <span className="hud-card-title">Attack Surface</span>
+ </div>
+ <div className="hud-card-value">
+ {hostsDiscovered > 0 ? hostsDiscovered : "0"} <span className="text-xs font-normal text-zinc-400 font-sans">hosts</span>
+ </div>
+ <div className="hud-card-footer">
+ <span className="hud-context-text">
+ {hostsOwned !== null && hostsOwned > 0
+ ? `${hostsOwned} compromise targets`
+ : "Perimeter mapped"}
+ </span>
+ </div>
+ </div>
+ </div>
+
+ {/* Card 4: Engine Health */}
+ <div className="hud-bezel-card">
+ <div className="hud-bezel-inner">
+ <div className="hud-card-header">
+ <span className="hud-card-title">Engine Health</span>
+ </div>
+ <div className="hud-card-value">
+ {p95 !== null ? `${formatMetric(p95)} ms` : isIngestionActive ? "Nominal" : "Standby"}
+ </div>
+ <div className="hud-card-footer">
+ <span className="hud-context-text">
+ {activeWorkers} workers online · {queueDepth} queued
+ </span>
+ </div>
+ </div>
+ </div>
+ </div>
+
+ {/* Tier 2: Operational Telemetry (Clean 50/50 Balanced Grid) */}
+ <div className="workstation-split">
+ {/* Panel 1: Execution & Queue Telemetry */}
+ <div className="overview-content-card">
+ <div>
+ <div className="flex items-center justify-between">
+ <span className="text-[11px] font-mono uppercase tracking-wider text-zinc-400">
+ Execution Telemetry
+ </span>
+ <span className="font-mono text-[11px] text-zinc-500">
+ {snapshot?.timestamp ? formatReportTime(snapshot.timestamp) : "Standby"}
+ </span>
+ </div>
+
+ <div className="pulse-stat-grid mt-3">
+ <div className="pulse-stat-cell">
+ <div className="pulse-stat-label">Task Queue</div>
+ <div className="pulse-stat-value">
+ {queueDepth} <span className="text-xs font-normal text-zinc-400 font-sans">queued</span>
+ </div>
+ </div>
+ <div className="pulse-stat-cell">
+ <div className="pulse-stat-label">Module Runs</div>
+ <div className="pulse-stat-value">
+ {totalRuns} <span className="text-xs font-normal text-zinc-400 font-sans">({successRuns} ok)</span>
+ </div>
+ </div>
+ <div className="pulse-stat-cell">
+ <div className="pulse-stat-label">Failure Rate</div>
+ <div className={`pulse-stat-value ${failedRuns > 0 ? "text-rose-400" : "text-zinc-200"}`}>
+ {formatRate(errorRate)}
+ </div>
+ </div>
+ <div className="pulse-stat-cell">
+ <div className="pulse-stat-label">Worker Pool</div>
+ <div className="pulse-stat-value text-emerald-400">
+ {activeWorkers} <span className="text-xs font-normal text-zinc-400 font-sans">active</span>
+ </div>
+ </div>
+ </div>
+ </div>
+
+ <div className="flex items-center gap-2 pt-2 border-t border-zinc-800/60">
+ <button
+ type="button"
+ className="btn btn-compact text-xs flex items-center gap-1.5"
+ onClick={() => navigate("/modules")}
+ title="Browse validation module catalog"
+ >
+ <Terminal size={13} />
+ <span>Run Modules</span>
+ </button>
+ <button
+ type="button"
+ className="btn btn-compact text-xs flex items-center gap-1.5"
+ onClick={() => navigate("/graph")}
+ title="Open attack relationship graph"
+ >
+ <Crosshair size={13} />
+ <span>Attack Graph</span>
+ </button>
+ <button
+ type="button"
+ className="btn btn-compact text-xs flex items-center gap-1.5 ml-auto"
+ onClick={() => navigate("/reports")}
+ title="View compliance and engagement reports"
+ >
+ <ShieldCheck size={13} />
+ <span>Reports</span>
+ </button>
+ </div>
+ </div>
+
+ {/* Panel 2: Activity Pulse & Signals */}
+ <div className="overview-content-card">
+ <div>
+ <div className="flex items-center justify-between">
+ <span className="text-[11px] font-mono uppercase tracking-wider text-zinc-400">
+ Activity Pulse
+ </span>
+ <span className="font-mono text-[11px] text-zinc-300">
+ {monthlyTotal} signals total
+ </span>
+ </div>
+ <div className="mt-3">
+ {monthlySeries.some((value) => value.count > 0) ? (
+ <SparklineBars values={monthlySeries} />
+ ) : (
+ <div className="h-24 flex items-center justify-center text-xs text-zinc-400 bg-zinc-950/40 rounded border border-dashed border-zinc-800">
+ Awaiting operational signal telemetry
+ </div>
+ )}
+ </div>
+ </div>
+
+ <div className="flex items-center justify-between text-xs text-zinc-400 pt-2 border-t border-zinc-800/60 font-mono text-[11px]">
+ <span>Telemetry: {isIngestionActive ? "Ingestion Active" : "Standby"}</span>
+ <span>{hostsDiscovered} hosts mapped</span>
+ </div>
+ </div>
+ </div>
+
+ {/* Tier 3: Campaign Inventory Matrix */}
+ <CampaignTable
+ campaigns={selectedCampaign ? [selectedCampaign] : campaignList}
+ scopedCampaignId={selectedCampaignId}
+ onClearScope={() => setSelectedCampaignId("")}
+ onSelectCampaign={(id) => setSelectedCampaignId(id)}
+ />
+ </div>
+ </Page>
+ );
+}
+
+function normalizeMonthlySeries(
+ period: string | undefined,
+ series: MonthlyFindingStats["series"] | undefined
+): MonthlyFindingStats["series"] {
+ if (!period || !/^\d{4}-\d{2}$/.test(period)) return [];
+ const [yearText, monthText] = period.split("-");
+ const year = Number(yearText);
+ const month = Number(monthText);
+ if (!Number.isInteger(year) || !Number.isInteger(month) || month < 1 || month > 12) return [];
+
+ const counts = new Map<string, number>();
+ for (const item of series ?? []) {
+ const count = Number(item.count);
+ if (item.date && Number.isFinite(count)) counts.set(item.date, Math.max(0, count));
+ }
+
+ const daysInMonth = new Date(year, month, 0).getDate();
+ return Array.from({ length: daysInMonth }, (_, index) => {
+ const date = `${period}-${String(index + 1).padStart(2, "0")}`;
+ return { date, count: counts.get(date) ?? 0 };
+ });
+}
+
+
+
+export default OverviewPage;
diff --git a/frontend/src/features/dashboard/pages/ReportsPage.tsx b/frontend/src/features/dashboard/pages/ReportsPage.tsx
new file mode 100644
index 0000000..2062722
--- /dev/null
+++ b/frontend/src/features/dashboard/pages/ReportsPage.tsx
@@ -0,0 +1,334 @@
+import {
+ AlertTriangle,
+ Loader2,
+} from "lucide-react";
+import { useEffect, useState } from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { api } from "../../../api/client";
+import type { ReportItem } from "../../../api/types";
+import { ConfirmModal } from "../../../components/ui/ConfirmModal";
+import {
+ useDashboardUi,
+ useSessionState,
+ useTabParam,
+} from "../dashboardUiState";
+import {
+ CampaignPicker,
+ DataPanel,
+ EmptyState,
+ Page,
+ PersistedResult,
+ SectionHeader,
+ formatBytes,
+ formatReportDate,
+ pdfFailureHint,
+ readableError,
+ serializeError,
+} from "../dashboardComponents";
+
+const VALID_TABS_REPORTS = ["Generate", "Library"] as const;
+type ReportsTab = typeof VALID_TABS_REPORTS[number];
+
+export function ReportsPage() {
+ const { selectedCampaignId: campaignId, setSelectedCampaignId: setCampaignId, campaigns: campaignList } = useDashboardUi();
+ const [format, setFormat] = useSessionState("ares.dashboard.reports.format", "html");
+ const [warning, setWarning] = useState("");
+ const [libraryError, setLibraryError] = useState("");
+ const [deleteReportTarget, setDeleteReportTarget] = useState<ReportItem | null>(null);
+ const [confirmClearAllReports, setConfirmClearAllReports] = useState(false);
+ const [lastGenerateResult, setLastGenerateResult] = useSessionState<PersistedResult | null>("ares.dashboard.reports.lastGenerate", null);
+ const [rawTab, setActiveTab] = useTabParam("Generate");
+ const activeTab = (VALID_TABS_REPORTS as readonly string[]).includes(rawTab)
+ ? (rawTab as ReportsTab)
+ : "Generate";
+ const queryClient = useQueryClient();
+ const reports = useQuery({
+ queryKey: ["reports", campaignId],
+ queryFn: () => api.reports(campaignId),
+ enabled: Boolean(campaignId)
+ });
+ const reportItems = reports.data?.reports ?? [];
+ const reportResultKey = `${campaignId}:${format}`;
+ const generate = useMutation({
+ mutationFn: () => api.generateReport(campaignId, format),
+ onSuccess: (payload) => {
+ setLastGenerateResult({ key: reportResultKey, payload });
+ setActiveTab("Library");
+ void queryClient.invalidateQueries({ queryKey: ["reports", campaignId] });
+ },
+ onError: (error) => {
+ setLastGenerateResult({ key: reportResultKey, payload: serializeError(error), isError: true });
+ setActiveTab("Generate");
+ }
+ });
+ const persistedGenerateResult = lastGenerateResult?.key === reportResultKey ? lastGenerateResult : null;
+ const generateIssue = generate.error ?? (persistedGenerateResult?.isError ? persistedGenerateResult.payload : undefined);
+ const pdfIssueHint = format === "pdf" ? pdfFailureHint(generateIssue) : "";
+ const download = useMutation({
+ mutationFn: async (item: ReportItem) => {
+ const blob = await api.downloadReport(campaignId, item.filename);
+ const url = URL.createObjectURL(blob);
+ const link = document.createElement("a");
+ link.href = url;
+ link.download = item.filename;
+ document.body.appendChild(link);
+ link.click();
+ link.remove();
+ window.setTimeout(() => URL.revokeObjectURL(url), 1000);
+ }
+ });
+ const deleteReport = useMutation({
+ mutationFn: (item: ReportItem) => api.deleteReport(campaignId, item.filename),
+ onSuccess: (_payload, item) => {
+ queryClient.setQueryData<{ campaign_id: string; reports: ReportItem[] }>(
+ ["reports", campaignId],
+ (current) => current
+ ? {
+ ...current,
+ reports: current.reports.filter((report) => report.filename !== item.filename)
+ }
+ : current
+ );
+ setLibraryError("");
+ const activePayload = (generate.data ?? lastGenerateResult?.payload) as { filename?: string } | undefined;
+ if (activePayload?.filename === item.filename) {
+ generate.reset();
+ setLastGenerateResult(null);
+ }
+ },
+ onError: (error) => {
+ setLibraryError(readableError(error, "Report could not be deleted."));
+ }
+ });
+ const clearReports = useMutation({
+ mutationFn: () => api.clearReports(campaignId),
+ onSuccess: () => {
+ queryClient.setQueryData<{ campaign_id: string; reports: ReportItem[] }>(
+ ["reports", campaignId],
+ (current) => current ? { ...current, reports: [] } : current
+ );
+ setLibraryError("");
+ generate.reset();
+ setLastGenerateResult(null);
+ },
+ onError: (error) => {
+ setLibraryError(readableError(error, "Report library could not be cleared."));
+ }
+ });
+
+ // Auto-clear stale generate result if the report file was deleted from library
+ useEffect(() => {
+ if (reports.isSuccess && (generate.data || lastGenerateResult?.payload)) {
+ const activePayload = (generate.data ?? lastGenerateResult?.payload) as { filename?: string } | undefined;
+ const activeFilename = activePayload?.filename;
+ if (activeFilename && !reportItems.some((r) => r.filename === activeFilename)) {
+ generate.reset();
+ setLastGenerateResult(null);
+ }
+ }
+ }, [reports.isSuccess, reportItems, generate.data, lastGenerateResult]);
+
+ const deleteDisabled = deleteReport.isPending || clearReports.isPending;
+ return (
+ <Page
+ title="Reports"
+ actions={<span className="status-pill">{reports.data?.reports?.length ?? 0} artifacts</span>}
+ tabs={["Generate", "Library"]}
+ activeTab={activeTab}
+ onTabChange={setActiveTab}
+ >
+ {activeTab === "Generate" && (
+ <section className="panel p-4">
+ <SectionHeader
+ title="Generate Report"
+ description="Export findings, scope, and remediation."
+ />
+ <div className="grid gap-3 sm:grid-cols-3 items-end">
+ <div>
+ <label htmlFor="report-campaign-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
+ Target Campaign
+ </label>
+ <CampaignPicker
+ id="report-campaign-select"
+ campaigns={campaignList}
+ value={campaignId}
+ hasError={Boolean(warning && !campaignId)}
+ onChange={(id) => {
+ setCampaignId(id);
+ setWarning("");
+ }}
+ />
+ {warning && !campaignId && (
+ <p className="mt-1.5 flex items-center gap-1.5 text-xs text-rose-400" role="alert">
+ <AlertTriangle size={13} className="shrink-0 text-rose-400" />
+ {warning}
+ </p>
+ )}
+ </div>
+ <div>
+ <label htmlFor="report-format-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
+ Export Format
+ </label>
+ <select
+ id="report-format-select"
+ className="field"
+ value={format}
+ onChange={(e) => setFormat(e.target.value)}
+ >
+ <option value="html">HTML Document</option>
+ <option value="pdf">PDF Document</option>
+ <option value="markdown">Markdown</option>
+ <option value="json">JSON Export</option>
+ </select>
+ </div>
+ <div>
+ <button
+ className="btn btn-primary w-full"
+ disabled={generate.isPending}
+ onClick={() => {
+ if (!campaignId) {
+ setWarning("Select a scoped campaign before generating a report.");
+ return;
+ }
+ setWarning("");
+ generate.mutate();
+ }}
+ >
+ {generate.isPending ? (
+ <>
+ <Loader2 className="spin" size={16} /> Generating...
+ </>
+ ) : (
+ "Generate Report"
+ )}
+ </button>
+ </div>
+ </div>
+ {warning && campaignId && <p className="notice notice-danger mt-3">{warning}</p>}
+ {pdfIssueHint && (
+ <p className="notice notice-danger mt-3">
+ <AlertTriangle size={16} />
+ {pdfIssueHint}
+ </p>
+ )}
+ <DataPanel
+ title={generateIssue ? "Generate Error" : "Generate Result"}
+ data={generate.error ?? generate.data ?? persistedGenerateResult?.payload}
+ onClear={() => {
+ generate.reset();
+ setLastGenerateResult(null);
+ }}
+ />
+ </section>
+ )}
+ {activeTab === "Library" && (
+ <section className="panel table-panel">
+ <SectionHeader
+ title="Report Library"
+ action={campaignId && reportItems.length > 0 ? (
+ <button
+ className="btn btn-danger"
+ disabled={deleteDisabled}
+ onClick={() => setConfirmClearAllReports(true)}
+ >
+ {clearReports.isPending ? (
+ <Loader2 className="spin" size={15} />
+ ) : null}
+ Delete all
+ </button>
+ ) : null}
+ />
+ <div className="p-4 border-b border-zinc-800/80">
+ <label htmlFor="library-campaign-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
+ Target Campaign
+ </label>
+ <CampaignPicker
+ id="library-campaign-select"
+ campaigns={campaignList}
+ value={campaignId}
+ onChange={(id) => {
+ setCampaignId(id);
+ setWarning("");
+ }}
+ />
+ </div>
+ {campaignId && reportItems.length > 0 && (
+ <div className="table-scroll">
+ <table className="table">
+ <thead><tr><th>Filename</th><th>Format</th><th>Size</th><th>Modified</th><th>Actions</th></tr></thead>
+ <tbody>
+ {reportItems.map((item) => (
+ <tr key={item.filename}>
+ <td className="font-medium text-zinc-100 font-mono text-sm">{item.filename}</td>
+ <td><span className="badge">{item.format}</span></td>
+ <td>{formatBytes(item.size_bytes)}</td>
+ <td>{formatReportDate(item.modified_at)}</td>
+ <td>
+ <button className="btn" disabled={download.isPending || deleteDisabled} onClick={() => download.mutate(item)}>
+ Download
+ </button>
+ <button
+ className="btn btn-danger"
+ disabled={deleteDisabled}
+ onClick={() => setDeleteReportTarget(item)}
+ >
+ Delete
+ </button>
+ </td>
+ </tr>
+ ))}
+ </tbody>
+ </table>
+ </div>
+ )}
+ {libraryError && (
+ <p className="notice notice-danger mt-3">
+ <AlertTriangle size={16} />
+ {libraryError}
+ </p>
+ )}
+ <DataPanel title="Report Library Error" data={reports.error} />
+ {campaignId && reportItems.length === 0 && (
+ <EmptyState text="No reports generated for this campaign yet." />
+ )}
+ {!campaignId && <EmptyState text="Select a campaign to list reports." />}
+ <DataPanel title="Download Result" data={download.error} />
+ </section>
+ )}
+ <ConfirmModal
+ open={deleteReportTarget !== null}
+ title="Delete Report"
+ description={`Permanently delete report artifact "${deleteReportTarget?.filename ?? ""}". This action cannot be undone.`}
+ confirmLabel="Delete Report"
+ cancelLabel="Cancel"
+ variant="danger"
+ onConfirm={() => {
+ if (deleteReportTarget) {
+ setLibraryError("");
+ deleteReport.mutate(deleteReportTarget);
+ setDeleteReportTarget(null);
+ }
+ }}
+ onCancel={() => setDeleteReportTarget(null)}
+ />
+ <ConfirmModal
+ open={confirmClearAllReports}
+ title="Delete All Reports"
+ description={`Permanently delete all ${reportItems.length} report artifacts for this campaign. This action cannot be undone.`}
+ confirmLabel="Delete All Reports"
+ cancelLabel="Cancel"
+ variant="danger"
+ onConfirm={() => {
+ setLibraryError("");
+ clearReports.mutate();
+ setConfirmClearAllReports(false);
+ }}
+ onCancel={() => setConfirmClearAllReports(false)}
+ />
+ </Page>
+ );
+}
+
+
+
+export default ReportsPage;
diff --git a/frontend/src/features/dashboard/pages/SecurityPage.tsx b/frontend/src/features/dashboard/pages/SecurityPage.tsx
new file mode 100644
index 0000000..f0b22c2
--- /dev/null
+++ b/frontend/src/features/dashboard/pages/SecurityPage.tsx
@@ -0,0 +1,625 @@
+import {
+ AlertTriangle,
+ ArrowUpDown,
+ CheckCircle2,
+ ChevronDown,
+ Copy,
+ FileText,
+ Loader2,
+} from "lucide-react";
+import { FormEvent, useEffect, useMemo, useRef, useState } from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { api } from "../../../api/client";
+import type { ApiKeyMeta } from "../../../api/types";
+import { ConfirmModal } from "../../../components/ui/ConfirmModal";
+import { StructuredJsonViewer } from "../../../components/common/StructuredJsonViewer";
+import { useAuth } from "../../auth/authContext";
+import { useTabParam } from "../dashboardUiState";
+import {
+ ApiKeyCopyStatus,
+ DataPanel,
+ EmptyState,
+ GeneratedApiKey,
+ Page,
+ SectionHeader,
+ StatusBadge,
+ clearValidationMessage,
+ setRequiredMessage,
+} from "../dashboardComponents";
+
+function formatRole(role?: string): string {
+ const labels: Record<string, string> = {
+ team_lead: "Team Lead",
+ operator: "Operator",
+ recon: "Recon",
+ reporter: "Reporter"
+ };
+ if (!role) {
+ return "";
+ }
+ return labels[role] ?? role.replace(/_/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
+}
+
+function apiKeyVisibleIdentifier(key: ApiKeyMeta): string {
+ const prefix = typeof key.key_prefix === "string" && key.key_prefix
+ ? key.key_prefix
+ : typeof key.prefix === "string" && key.prefix
+ ? key.prefix
+ : "";
+ return prefix ? `Prefix: ${prefix}` : `ID: ${key.id.slice(0, 12)}`;
+}
+
+function apiKeyOwnerLabel(key: ApiKeyMeta): string {
+ const owner = key.owner ?? key.owner_username ?? key.username ?? key.role;
+ return typeof owner === "string" && owner.trim() ? owner : "";
+}
+
+function formatDateTime(value: string): string {
+ const date = new Date(value);
+ return Number.isNaN(date.getTime()) ? value : date.toLocaleString();
+}
+
+function SecurityAuditTable({ auditData, error }: { auditData?: unknown; error?: unknown }) {
+ const [sortAsc, setSortAsc] = useState(false);
+ const [showRaw, setShowRaw] = useState(false);
+
+ const rows = useMemo((): Array<{ id: string; timestamp: string | number; actor: string; action: string; resource: string; status: string }> => {
+ if (!auditData) return [];
+ if (Array.isArray(auditData)) {
+ return auditData.map((item, idx) => {
+ const rawTs = (item as Record<string, unknown>).timestamp ?? (item as Record<string, unknown>).created_at;
+ const ts: string | number = typeof rawTs === "string" || typeof rawTs === "number" ? rawTs : "";
+ return {
+ id: String((item as Record<string, unknown>).id ?? idx),
+ timestamp: ts,
+ actor: String((item as Record<string, unknown>).actor ?? (item as Record<string, unknown>).username ?? "system"),
+ action: String((item as Record<string, unknown>).action ?? (item as Record<string, unknown>).event ?? "audit"),
+ resource: String((item as Record<string, unknown>).resource ?? (item as Record<string, unknown>).target ?? (item as Record<string, unknown>).detail ?? "—"),
+ status: String((item as Record<string, unknown>).status ?? "logged")
+ };
+ });
+ }
+ const obj = auditData as Record<string, unknown>;
+ if (Array.isArray(obj.events)) {
+ return (obj.events as Record<string, unknown>[]).map((item, idx) => {
+ const rawTs = item.timestamp ?? item.created_at;
+ const ts: string | number = typeof rawTs === "string" || typeof rawTs === "number" ? rawTs : "";
+ return {
+ id: String(item.id ?? idx),
+ timestamp: ts,
+ actor: String(item.actor ?? item.username ?? "system"),
+ action: String(item.action ?? item.event ?? "audit"),
+ resource: String(item.resource ?? item.target ?? item.detail ?? "—"),
+ status: String(item.status ?? "logged")
+ };
+ });
+ }
+ if (Array.isArray(obj.logs)) {
+ return (obj.logs as Record<string, unknown>[]).map((item, idx) => {
+ const rawTs = item.timestamp ?? item.created_at;
+ const ts: string | number = typeof rawTs === "string" || typeof rawTs === "number" ? rawTs : "";
+ return {
+ id: String(item.id ?? idx),
+ timestamp: ts,
+ actor: String(item.actor ?? item.username ?? "system"),
+ action: String(item.action ?? item.event ?? "audit"),
+ resource: String(item.resource ?? item.target ?? item.detail ?? "—"),
+ status: String(item.status ?? "logged")
+ };
+ });
+ }
+ if (Array.isArray(obj.vulnerabilities)) {
+ const scanTime = typeof obj.scan_timestamp === "number" ? new Date(obj.scan_timestamp * 1000).toISOString() : new Date().toISOString();
+ const scanner = String(obj.scanner ?? "pip-audit");
+ return (obj.vulnerabilities as Record<string, unknown>[]).map((v, idx) => ({
+ id: String(v.vuln_id ?? idx),
+ timestamp: scanTime,
+ actor: scanner,
+ action: String(v.vuln_id ?? "cve_detected"),
+ resource: `${String(v.package ?? "")} ${String(v.version ?? "")}`,
+ status: String(v.severity ?? "high")
+ }));
+ }
+ return [];
+ }, [auditData]);
+
+ const sortedRows = useMemo(() => {
+ return [...rows].sort((a, b) => {
+ const timeA = new Date(a.timestamp || 0).getTime() || 0;
+ const timeB = new Date(b.timestamp || 0).getTime() || 0;
+ return sortAsc ? timeA - timeB : timeB - timeA;
+ });
+ }, [rows, sortAsc]);
+
+ if (error) {
+ return <DataPanel title="Security Audit Error" data={error} />;
+ }
+
+ return (
+ <section className="panel table-panel">
+ <SectionHeader
+ title="Security Audit Log"
+ description="Immutable record of sensitive operations, security scans, and administrative activity."
+ action={
+ <div className="flex items-center gap-2">
+ <button
+ type="button"
+ onClick={() => setSortAsc(!sortAsc)}
+ className="btn btn-compact text-xs flex items-center gap-1.5"
+ title="Toggle sort direction by timestamp"
+ >
+ <ArrowUpDown size={12} />
+ <span>{sortAsc ? "Oldest First" : "Newest First"}</span>
+ </button>
+ <span className="badge">{rows.length} event{rows.length === 1 ? "" : "s"}</span>
+ </div>
+ }
+ />
+ {sortedRows.length > 0 ? (
+ <div className="table-scroll">
+ <table className="table">
+ <thead>
+ <tr>
+ <th
+ className="cursor-pointer select-none hover:text-zinc-100"
+ onClick={() => setSortAsc(!sortAsc)}
+ title="Click to sort by timestamp"
+ >
+ <div className="flex items-center gap-1">
+ <span>Timestamp</span>
+ <ArrowUpDown size={12} className="text-zinc-400" />
+ </div>
+ </th>
+ <th>Actor</th>
+ <th>Action</th>
+ <th>Resource</th>
+ <th>Status</th>
+ </tr>
+ </thead>
+ <tbody>
+ {sortedRows.map((row) => (
+ <tr key={row.id}>
+ <td className="font-mono text-xs text-zinc-300 whitespace-nowrap">
+ {row.timestamp ? formatDateTime(String(row.timestamp)) : "—"}
+ </td>
+ <td>
+ <span className="font-mono text-xs font-semibold text-zinc-200">{row.actor}</span>
+ </td>
+ <td>
+ <span className="badge font-mono text-[11px]">{row.action}</span>
+ </td>
+ <td>
+ <span className="font-mono text-xs text-zinc-300">{row.resource}</span>
+ </td>
+ <td>
+ <StatusBadge status={row.status} />
+ </td>
+ </tr>
+ ))}
+ </tbody>
+ </table>
+ </div>
+ ) : (
+ <div className="p-4">
+ <EmptyState text="No security audit events recorded yet." />
+ </div>
+ )}
+
+ {Boolean(auditData) && (
+ <div className="p-4 border-t border-zinc-800/80">
+ <div className="flex items-center justify-between">
+ <span className="text-xs text-zinc-400">Underlying telemetry payload:</span>
+ <button
+ type="button"
+ onClick={() => setShowRaw(!showRaw)}
+ className="btn btn-compact text-[11px] py-1 px-2.5 text-zinc-400 hover:text-zinc-200 flex items-center gap-1.5"
+ >
+ <FileText size={12} />
+ <span>{showRaw ? "Hide Raw Audit JSON" : "View Raw Audit JSON"}</span>
+ <ChevronDown size={12} className={`transition-transform duration-200 ${showRaw ? "rotate-180" : ""}`} />
+ </button>
+ </div>
+ {showRaw && (
+ <div className="mt-3">
+ <StructuredJsonViewer data={auditData} title="Raw Audit Payload" maxHeightClass="max-h-72" />
+ </div>
+ )}
+ </div>
+ )}
+ </section>
+ );
+}
+
+function SecurityUsersTable({ usersData, error }: { usersData?: unknown; error?: unknown }) {
+ const [showRaw, setShowRaw] = useState(false);
+ const usersList = Array.isArray(usersData) ? (usersData as Record<string, unknown>[]) : [];
+
+ if (error) {
+ return <DataPanel title="Users Error" data={error} />;
+ }
+
+ return (
+ <section className="panel table-panel">
+ <SectionHeader
+ title="Platform Users"
+ description="Registered accounts and role-based access control."
+ action={<span className="badge">{usersList.length} user{usersList.length === 1 ? "" : "s"}</span>}
+ />
+ {usersList.length > 0 ? (
+ <div className="table-scroll">
+ <table className="table">
+ <thead>
+ <tr>
+ <th>Username</th>
+ <th>Role</th>
+ <th>Last Active</th>
+ <th>Status</th>
+ </tr>
+ </thead>
+ <tbody>
+ {usersList.map((u, index) => {
+ const username = String(u.username ?? `user-${index}`);
+ const role = String(u.role ?? "viewer");
+ const isActive = u.is_active === true || u.is_active === 1;
+ const lastLogin = u.last_login ? formatDateTime(String(u.last_login)) : "Never";
+ const roleTone = role === "team_lead" ? "badge badge-high" : role === "operator" ? "badge badge-low" : "badge";
+ return (
+ <tr key={String(u.id ?? username)}>
+ <td>
+ <div className="flex items-center gap-2">
+ <span className="w-6 h-6 rounded-full bg-zinc-800 text-zinc-300 font-bold text-xs flex items-center justify-center">
+ {username.slice(0, 1).toUpperCase()}
+ </span>
+ <span className="font-semibold text-zinc-100 text-sm">{username}</span>
+ </div>
+ </td>
+ <td>
+ <span className={roleTone}>{formatRole(role)}</span>
+ </td>
+ <td className="text-xs text-zinc-400 font-mono">
+ {lastLogin}
+ </td>
+ <td>
+ <span className={`badge ${isActive ? "badge-low" : "badge-high"}`}>
+ {isActive ? "Active" : "Disabled"}
+ </span>
+ </td>
+ </tr>
+ );
+ })}
+ </tbody>
+ </table>
+ </div>
+ ) : (
+ <div className="p-4">
+ <EmptyState text="No user records loaded yet." />
+ </div>
+ )}
+
+ {Boolean(usersData) && (
+ <div className="p-4 border-t border-zinc-800/80">
+ <div className="flex items-center justify-between">
+ <span className="text-xs text-zinc-400">Raw database user records:</span>
+ <button
+ type="button"
+ onClick={() => setShowRaw(!showRaw)}
+ className="btn btn-compact text-[11px] py-1 px-2.5 text-zinc-400 hover:text-zinc-200 flex items-center gap-1.5"
+ >
+ <FileText size={12} />
+ <span>{showRaw ? "Hide Raw Users JSON" : "View Raw Users JSON"}</span>
+ <ChevronDown size={12} className={`transition-transform duration-200 ${showRaw ? "rotate-180" : ""}`} />
+ </button>
+ </div>
+ {showRaw && (
+ <div className="mt-3">
+ <StructuredJsonViewer data={usersData} title="Raw User Records" maxHeightClass="max-h-72" />
+ </div>
+ )}
+ </div>
+ )}
+ </section>
+ );
+}
+
+const VALID_TABS_SECURITY = ["Account", "API Keys", "Audit", "Users"] as const;
+type SecurityTab = typeof VALID_TABS_SECURITY[number];
+
+export function SecurityPage() {
+ const { user } = useAuth();
+ const keys = useQuery({ queryKey: ["api-keys"], queryFn: api.apiKeys });
+ const audit = useQuery({ queryKey: ["security-audit"], queryFn: api.securityAudit, enabled: user?.role === "team_lead" });
+ const users = useQuery({ queryKey: ["security-users"], queryFn: api.users, enabled: user?.role === "team_lead" });
+ const queryClient = useQueryClient();
+ const secretKeyInputRef = useRef<HTMLInputElement | null>(null);
+ const [currentPassword, setCurrentPassword] = useState("");
+ const [newPassword, setNewPassword] = useState("");
+ const [confirmPassword, setConfirmPassword] = useState("");
+ const [confirmTouched, setConfirmTouched] = useState(false);
+ const [keyName, setKeyName] = useState("");
+ const [scopes, setScopes] = useState("read");
+ const [creatingApiKey, setCreatingApiKey] = useState(false);
+ const [generatedApiKey, setGeneratedApiKey] = useState<GeneratedApiKey | null>(null);
+ const [apiKeyError, setApiKeyError] = useState<unknown>(null);
+ const [copyStatus, setCopyStatus] = useState<ApiKeyCopyStatus>("idle");
+ const [deleteTarget, setDeleteTarget] = useState<string | null>(null);
+ const [rawTab, setActiveTab] = useTabParam("Account");
+ const activeTab = (VALID_TABS_SECURITY as readonly string[]).includes(rawTab)
+ ? (rawTab as SecurityTab)
+ : "Account";
+ const change = useMutation({
+ mutationFn: () => api.changePassword({ current_password: currentPassword, new_password: newPassword }),
+ onSuccess: () => {
+ setCurrentPassword("");
+ setNewPassword("");
+ setConfirmPassword("");
+ setConfirmTouched(false);
+ }
+ });
+ const remove = useMutation({
+ mutationFn: (id: string) => api.deleteApiKey(id),
+ onSuccess: () => {
+ void queryClient.invalidateQueries({ queryKey: ["api-keys"] });
+ }
+ });
+
+ useEffect(() => {
+ if (generatedApiKey) {
+ secretKeyInputRef.current?.focus();
+ }
+ }, [generatedApiKey]);
+
+ async function handleCreateApiKey(event: FormEvent<HTMLFormElement>): Promise<void> {
+ event.preventDefault();
+ if (!event.currentTarget.reportValidity()) return;
+ setApiKeyError(null);
+ setGeneratedApiKey(null);
+ setCopyStatus("idle");
+ setCreatingApiKey(true);
+ try {
+ const response = await api.createApiKey({ name: keyName, scopes });
+ if (!response.key) {
+ throw new Error("API key created, but the secret was not returned by the API.");
+ }
+ setGeneratedApiKey({
+ id: response.id,
+ key: response.key,
+ note: response.note,
+ prefix: response.prefix ?? response.key_prefix
+ });
+ setKeyName("");
+ void queryClient.invalidateQueries({ queryKey: ["api-keys"] });
+ } catch (error) {
+ setApiKeyError(error);
+ } finally {
+ setCreatingApiKey(false);
+ }
+ }
+
+ async function copyGeneratedKey(): Promise<void> {
+ if (!generatedApiKey?.key) return;
+
+ let copied = false;
+ if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
+ try {
+ await navigator.clipboard.writeText(generatedApiKey.key);
+ copied = true;
+ } catch {
+ copied = false;
+ }
+ }
+
+ if (!copied && secretKeyInputRef.current) {
+ secretKeyInputRef.current.focus();
+ secretKeyInputRef.current.select();
+ try {
+ copied = document.execCommand("copy");
+ } catch {
+ copied = false;
+ }
+ }
+
+ setCopyStatus(copied ? "copied" : "manual");
+ }
+
+ function closeGeneratedKeyModal(): void {
+ setGeneratedApiKey(null);
+ setCopyStatus("idle");
+ }
+
+ return (
+ <Page
+ title="Security"
+ actions={<span className="status-pill">{formatRole(user?.role)}</span>}
+ tabs={["Account", "API Keys", "Audit", "Users"]}
+ activeTab={activeTab}
+ onTabChange={setActiveTab}
+ >
+ {activeTab === "Account" && (
+ <section className="panel p-4">
+ <SectionHeader title="Account" />
+ <div className="profile-row mb-3">
+ <span className="profile-avatar-light">{user?.username?.slice(0, 1).toUpperCase() ?? "A"}</span>
+ <div>
+ <div className="font-semibold text-zinc-100">{user?.username}</div>
+ <div className="text-xs text-zinc-400">{formatRole(user?.role)}</div>
+ </div>
+ </div>
+ <form className="grid gap-2" onSubmit={(event) => {
+ event.preventDefault();
+ if (!event.currentTarget.reportValidity()) return;
+ if (newPassword !== confirmPassword) return;
+ change.mutate();
+ }}>
+ <input className="field" required type="password" placeholder="Current password" value={currentPassword} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setCurrentPassword(e.target.value); }} />
+ <input className="field" required minLength={12} type="password" placeholder="New password" value={newPassword} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setNewPassword(e.target.value); }} />
+ <div>
+ <input
+ className={`field ${confirmTouched && confirmPassword !== "" && newPassword !== confirmPassword ? "border-rose-500/70 focus:border-rose-500" : ""}`}
+ required
+ minLength={12}
+ type="password"
+ placeholder="Confirm new password"
+ value={confirmPassword}
+ onInvalid={setRequiredMessage}
+ onBlur={() => setConfirmTouched(true)}
+ onChange={(e) => {
+ clearValidationMessage(e);
+ setConfirmTouched(true);
+ setConfirmPassword(e.target.value);
+ }}
+ />
+ {confirmTouched && confirmPassword !== "" && newPassword !== confirmPassword && (
+ <p className="mt-1.5 flex items-center gap-1.5 text-xs text-rose-400" role="alert">
+ <AlertTriangle size={13} className="shrink-0 text-rose-400" />
+ Passwords do not match
+ </p>
+ )}
+ </div>
+ <button
+ className="btn"
+ disabled={
+ change.isPending ||
+ !currentPassword.trim() ||
+ !newPassword ||
+ !confirmPassword ||
+ newPassword !== confirmPassword
+ }
+ type="submit"
+ >
+ {change.isPending && <Loader2 className="spin" size={16} />}
+ Change Password
+ </button>
+ </form>
+ <DataPanel title="Password Result" data={change.data ?? change.error} />
+ </section>
+ )}
+ {activeTab === "API Keys" && (
+ <section className="panel p-4">
+ <SectionHeader
+ title="API Keys"
+ action={<span className="badge">{keys.data?.length ?? 0} active</span>}
+ description="Metadata only; new secrets are shown once."
+ />
+ <form className="mb-3 grid gap-2 sm:grid-cols-[1fr_120px_auto]" onSubmit={(event) => void handleCreateApiKey(event)}>
+ <input className="field" required placeholder="Name" value={keyName} onInvalid={setRequiredMessage} onChange={(e) => { clearValidationMessage(e); setKeyName(e.target.value); }} />
+ <select className="field" value={scopes} onChange={(e) => setScopes(e.target.value)}>
+ <option value="read">read</option>
+ <option value="write">write</option>
+ <option value="admin">admin</option>
+ </select>
+ <button className="btn" disabled={creatingApiKey} type="submit">
+ {creatingApiKey && <Loader2 className="spin" size={16} />}
+ Create
+ </button>
+ </form>
+ {(keys.data ?? []).map((key) => (
+ <div className="key-row" key={key.id}>
+ <div className="min-w-0">
+ <div className="font-semibold text-zinc-100">{key.name ?? "Unnamed API key"}</div>
+ <div className="mt-1 flex flex-wrap gap-2 text-xs font-semibold text-zinc-400">
+ <span className="font-mono">{apiKeyVisibleIdentifier(key)}</span>
+ {key.scopes ? <span className="badge">Scope: {key.scopes}</span> : null}
+ {apiKeyOwnerLabel(key) ? <span>Owner: {apiKeyOwnerLabel(key)}</span> : null}
+ </div>
+ <div className="mt-1 flex flex-wrap gap-2 text-xs text-zinc-400">
+ {key.created_at ? <span>Created: {formatDateTime(key.created_at)}</span> : null}
+ {key.expires_at ? <span>Expires: {formatDateTime(key.expires_at)}</span> : <span>No expiry</span>}
+ </div>
+ </div>
+ <button className="btn btn-danger" disabled={remove.isPending} onClick={() => setDeleteTarget(key.id)} type="button">Delete</button>
+ </div>
+ ))}
+ {(keys.data ?? []).length === 0 && <EmptyState text="No API keys yet." />}
+ <DataPanel title="API Key Error" data={apiKeyError ?? remove.error ?? keys.error} />
+ </section>
+ )}
+ {activeTab === "Audit" && (
+ <section className="grid gap-4">
+ {user?.role === "team_lead" ? (
+ <SecurityAuditTable auditData={audit.data} error={audit.error} />
+ ) : (
+ <EmptyState text="Audit data is available to team leads." />
+ )}
+ </section>
+ )}
+ {activeTab === "Users" && (
+ <section className="grid gap-4">
+ {user?.role === "team_lead" ? (
+ <SecurityUsersTable usersData={users.data} error={users.error} />
+ ) : (
+ <EmptyState text="User management is available to team leads." />
+ )}
+ </section>
+ )}
+ {generatedApiKey && (
+ <div className="fixed inset-0 z-50 flex items-center justify-center bg-slate-950/60 p-4">
+ <section
+ aria-labelledby="api-key-dialog-title"
+ aria-modal="true"
+ className="panel w-full max-w-2xl p-5 shadow-2xl"
+ role="dialog"
+ >
+ <div className="mb-4 flex flex-wrap items-start justify-between gap-3">
+ <div>
+ <h2 className="text-lg font-bold text-zinc-100" id="api-key-dialog-title">Save your key</h2>
+ <p className="mt-1 text-sm text-zinc-400">Copy this secret key now and store it somewhere safe.</p>
+ </div>
+ {generatedApiKey.prefix ? <span className="badge font-mono">{generatedApiKey.prefix}</span> : null}
+ </div>
+ <p className="mb-4 rounded-md border border-amber-500/30 bg-amber-500/10 p-3 text-sm font-semibold text-amber-200">
+ This secret key is shown only once. After you close this dialog, ARES will not show the full key again.
+ </p>
+ <div className="block">
+ <label htmlFor="generated-api-key-secret" className="block text-sm font-semibold text-zinc-300 mb-1 cursor-pointer">
+ Secret key
+ </label>
+ <div className="mt-2 grid gap-2 sm:grid-cols-[1fr_auto]">
+ <input
+ id="generated-api-key-secret"
+ aria-label="Generated API key secret"
+ className="field font-mono text-sm"
+ onFocus={(event) => event.currentTarget.select()}
+ readOnly
+ ref={secretKeyInputRef}
+ value={generatedApiKey.key}
+ />
+ <button className="btn" onClick={() => void copyGeneratedKey()} type="button">
+ {copyStatus === "copied" ? <CheckCircle2 size={16} /> : <Copy size={16} />}
+ {copyStatus === "copied" ? "Copied" : "Copy"}
+ </button>
+ </div>
+ </div>
+ {copyStatus === "manual" && (
+ <p className="mt-2 rounded-md border border-zinc-700 bg-zinc-900 p-3 text-sm text-zinc-300">
+ Clipboard access was blocked. The key field is selected; press Ctrl+C to copy it manually.
+ </p>
+ )}
+ {generatedApiKey.note ? <p className="mt-3 text-sm text-zinc-400">{generatedApiKey.note}</p> : null}
+ <div className="mt-5 flex justify-end">
+ <button className="btn btn-primary" onClick={closeGeneratedKeyModal} type="button">Done</button>
+ </div>
+ </section>
+ </div>
+ )}
+ <ConfirmModal
+ open={deleteTarget !== null}
+ title="Delete API Key"
+ description="This action cannot be undone. All integrations using this key will immediately lose access."
+ confirmLabel="Delete API Key"
+ cancelLabel="Cancel"
+ variant="danger"
+ onConfirm={() => {
+ if (deleteTarget) {
+ remove.mutate(deleteTarget);
+ setDeleteTarget(null);
+ }
+ }}
+ onCancel={() => setDeleteTarget(null)}
+ />
+ </Page>
+ );
+}
+
+
+
+export default SecurityPage;
diff --git a/frontend/src/features/dashboard/pages/StrategyPage.tsx b/frontend/src/features/dashboard/pages/StrategyPage.tsx
new file mode 100644
index 0000000..e5f8cc9
--- /dev/null
+++ b/frontend/src/features/dashboard/pages/StrategyPage.tsx
@@ -0,0 +1,469 @@
+import {
+ AlertTriangle,
+ ChevronDown,
+ FileText,
+ Info,
+ Loader2,
+} from "lucide-react";
+import { useState } from "react";
+import { useMutation, useQuery } from "@tanstack/react-query";
+import { api } from "../../../api/client";
+import { StructuredJsonViewer } from "../../../components/common/StructuredJsonViewer";
+import { useAuth } from "../../auth/authContext";
+import {
+ useDashboardUi,
+ useSessionState,
+ useTabParam,
+} from "../dashboardUiState";
+import {
+ CampaignPicker,
+ DataPanel,
+ EmptyState,
+ MiniStat,
+ Page,
+ PersistedResult,
+ SectionHeader,
+ StatusBadge,
+ serializeError,
+ splitLines,
+} from "../dashboardComponents";
+
+function StrategyActiveView({
+ activeData,
+ goal,
+ llmBackend,
+ allowed
+}: {
+ activeData?: Record<string, unknown>;
+ goal: string;
+ llmBackend: string;
+ allowed: boolean;
+}) {
+ const [showRaw, setShowRaw] = useState(false);
+ const activeCount = typeof activeData?.count === "number" ? activeData.count : 0;
+ const maxAllowed = typeof activeData?.max_allowed === "number" ? activeData.max_allowed : 1;
+ const slotsAvailable = typeof activeData?.slots_available === "number" ? activeData.slots_available : 1;
+ const llmBackends = (activeData?.llm_backends as Record<string, boolean> | undefined);
+ const backendReady = llmBackends ? llmBackends[llmBackend] !== false : true;
+
+ const stages = [
+ { number: 1, name: "Surface Discovery", desc: "Network & service perimeter mapping, host discovery", status: activeCount > 0 ? "active" : "standby" },
+ { number: 2, name: "Defense Feasibility", desc: "EDR telemetry inspection, AMSI bypass calibration", status: "standby" },
+ { number: 3, name: "Credential Extraction", desc: "Memory dumps, Kerberoasting, AS-REP extraction", status: "standby" },
+ { number: 4, name: "Lateral Movement", desc: "Pivoting via WinRM, SMB, token impersonation", status: "standby" },
+ { number: 5, name: "Domain Escalation", desc: "Privilege elevation, DCSync, Domain Admin achievement", status: "standby" }
+ ];
+
+ return (
+ <div className="grid gap-4">
+ <section className="panel p-4">
+ <SectionHeader
+ title="Planning Snapshot"
+ action={
+ <div className="flex items-center gap-2">
+ <span className={`badge ${activeCount > 0 ? "badge-low" : "badge-info"}`}>
+ {activeCount > 0 ? `${activeCount} Active Engagement` : "Idle / Ready"}
+ </span>
+ <span className="badge font-mono text-xs">{slotsAvailable} slot{slotsAvailable === 1 ? "" : "s"} free</span>
+ </div>
+ }
+ />
+ <div className="mini-stat-grid">
+ <MiniStat title="Strategic Goal" value={goal} detail="Objective target" />
+ <MiniStat
+ title="LLM Backend"
+ value={llmBackend}
+ detail={backendReady ? "Engine online" : "Unconfigured key"}
+ />
+ <MiniStat
+ title="Concurrency Slots"
+ value={`${activeCount} / ${maxAllowed}`}
+ detail={`${slotsAvailable} slot${slotsAvailable === 1 ? "" : "s"} available`}
+ />
+ <MiniStat
+ title="Authorization"
+ value={allowed ? "authorized" : "restricted"}
+ detail={allowed ? "Ready to engage" : "Requires operator"}
+ />
+ </div>
+ </section>
+
+ <section className="panel p-4">
+ <SectionHeader
+ title="Autonomous Engagement Lifecycle"
+ description="Sequential execution stages executed during autonomous strategy engagement."
+ />
+ <div className="compact-list mt-3">
+ {stages.map((st) => (
+ <div key={st.number} className="compact-row flex items-center justify-between gap-3 p-3">
+ <div className="flex items-center gap-3">
+ <div className={`w-7 h-7 rounded-full flex items-center justify-center text-xs font-bold ${
+ st.status === "active"
+ ? "bg-emerald-500/20 text-emerald-400 border border-emerald-500/50"
+ : "bg-zinc-800 text-zinc-400 border border-zinc-700/60"
+ }`}>
+ {st.status === "active" ? <Loader2 size={13} className="spin text-emerald-400" /> : st.number}
+ </div>
+ <div>
+ <div className="font-semibold text-sm text-zinc-100 flex items-center gap-2">
+ <span>{st.name}</span>
+ {st.status === "active" && (
+ <span className="badge badge-low text-[10px] uppercase font-mono">Running</span>
+ )}
+ </div>
+ <div className="text-xs text-zinc-400 mt-0.5">{st.desc}</div>
+ </div>
+ </div>
+ <span className="badge font-mono text-xs">
+ {st.status === "active" ? "In Progress" : "Standby"}
+ </span>
+ </div>
+ ))}
+ </div>
+
+ {activeData && (
+ <div className="mt-4 pt-3 border-t border-zinc-800/80">
+ <button
+ type="button"
+ onClick={() => setShowRaw(!showRaw)}
+ className="btn btn-compact text-[11px] py-1 px-2.5 text-zinc-400 hover:text-zinc-200 flex items-center gap-1.5"
+ >
+ <FileText size={12} />
+ <span>{showRaw ? "Hide Raw Active State" : "View Raw Active State"}</span>
+ <ChevronDown size={12} className={`transition-transform duration-200 ${showRaw ? "rotate-180" : ""}`} />
+ </button>
+ {showRaw && (
+ <div className="mt-2">
+ <StructuredJsonViewer data={activeData} title="Active Strategy State" maxHeightClass="max-h-72" />
+ </div>
+ )}
+ </div>
+ )}
+ </section>
+ </div>
+ );
+}
+
+function StrategyResultView({
+ resultData,
+ isError
+}: {
+ resultData: unknown;
+ isError?: boolean;
+}) {
+ const [showRaw, setShowRaw] = useState(false);
+ const data = (resultData ?? {}) as Record<string, unknown>;
+ const status = typeof data.status === "string" ? data.status : isError ? "failed" : "completed";
+ const goal = typeof data.goal === "string" ? data.goal : "objective";
+ const campaignId = typeof data.campaign_id === "string" ? data.campaign_id : "";
+ const modulesRun = typeof data.modules_run === "number" ? data.modules_run : 0;
+ const children = Array.isArray(data.children) ? (data.children as Record<string, unknown>[]) : [];
+
+ const totalFindings = children.reduce((acc, c) => acc + (typeof c.findings_count === "number" ? c.findings_count : 0), 0);
+ const totalDurationMs = children.reduce((acc, c) => acc + (typeof c.duration_ms === "number" ? c.duration_ms : 0), 0);
+
+ return (
+ <div className="grid gap-4">
+ {isError && (
+ <p className="notice notice-danger">
+ Engagement failed: {String(data.detail ?? data.error ?? "Unknown execution error")}
+ </p>
+ )}
+
+ <section className="panel p-4">
+ <SectionHeader
+ title="Engagement Summary"
+ action={<StatusBadge status={status} />}
+ />
+ <div className="mini-stat-grid">
+ <MiniStat title="Status" value={status} detail={campaignId ? `Campaign ${campaignId.slice(0, 8)}` : "Finished"} />
+ <MiniStat title="Objective Goal" value={goal} detail="Strategic target" />
+ <MiniStat title="Modules Run" value={String(modulesRun || children.length)} detail="Autonomous pipeline" />
+ <MiniStat title="Total Findings" value={String(totalFindings)} detail="Security telemetry" />
+ <MiniStat title="Total Duration" value={`${(totalDurationMs / 1000).toFixed(2)}s`} detail={`${totalDurationMs} ms total`} />
+ </div>
+ </section>
+
+ {children.length > 0 && (
+ <section className="panel table-panel">
+ <SectionHeader
+ title="Module Execution Breakdown"
+ action={<span className="badge">{children.length} step{children.length === 1 ? "" : "s"}</span>}
+ />
+ <div className="table-scroll">
+ <table className="table">
+ <thead>
+ <tr>
+ <th>#</th>
+ <th>Stage</th>
+ <th>Module</th>
+ <th>Status</th>
+ <th>Findings</th>
+ <th>Duration</th>
+ <th>Error</th>
+ </tr>
+ </thead>
+ <tbody>
+ {children.map((child, index) => {
+ const stageOrdinal = typeof child.stage_ordinal === "number" ? child.stage_ordinal + 1 : index + 1;
+ const modId = typeof child.module_id === "string" ? child.module_id : `step-${index}`;
+ const modStatus = typeof child.status === "string" ? child.status : "unknown";
+ const findingsCount = typeof child.findings_count === "number" ? child.findings_count : 0;
+ const durMs = typeof child.duration_ms === "number" ? child.duration_ms : 0;
+ const errText = child.error ? String(child.error) : null;
+ return (
+ <tr key={`${modId}-${index}`}>
+ <td className="muted-cell">#{String(index + 1).padStart(2, "0")}</td>
+ <td>
+ <span className="badge font-mono text-[11px]">Stage {stageOrdinal}</span>
+ </td>
+ <td>
+ <span className="font-mono text-xs font-semibold text-zinc-100">{modId}</span>
+ </td>
+ <td>
+ <StatusBadge status={modStatus} />
+ </td>
+ <td>
+ <span className={`badge ${findingsCount > 0 ? "badge-info" : ""}`}>{findingsCount}</span>
+ </td>
+ <td className="font-mono text-xs text-zinc-400">{durMs} ms</td>
+ <td>
+ {errText ? (
+ <span className="text-xs text-rose-400 font-mono" title={errText}>{errText.slice(0, 40)}</span>
+ ) : (
+ <span className="text-zinc-500 text-xs">—</span>
+ )}
+ </td>
+ </tr>
+ );
+ })}
+ </tbody>
+ </table>
+ </div>
+ </section>
+ )}
+
+ <section className="panel p-4">
+ <div className="flex items-center justify-between">
+ <span className="text-xs text-zinc-400">Raw execution output and identity digest:</span>
+ <button
+ type="button"
+ onClick={() => setShowRaw(!showRaw)}
+ className="btn btn-compact text-[11px] py-1 px-2.5 text-zinc-400 hover:text-zinc-200 flex items-center gap-1.5"
+ >
+ <FileText size={12} />
+ <span>{showRaw ? "Hide Raw Result" : "View Raw Result"}</span>
+ <ChevronDown size={12} className={`transition-transform duration-200 ${showRaw ? "rotate-180" : ""}`} />
+ </button>
+ </div>
+ {showRaw && (
+ <div className="mt-3">
+ <StructuredJsonViewer data={resultData} title="Raw Engagement Result" maxHeightClass="max-h-80" />
+ </div>
+ )}
+ </section>
+ </div>
+ );
+}
+
+const VALID_TABS_STRATEGY = ["Objective", "Active", "Result"] as const;
+type StrategyTab = typeof VALID_TABS_STRATEGY[number];
+
+export function StrategyPage() {
+ const { user } = useAuth();
+ const { selectedCampaignId: campaignId, setSelectedCampaignId: setCampaignId, campaigns: campaignList } = useDashboardUi();
+ const active = useQuery({ queryKey: ["strategy-active"], queryFn: api.activeStrategy });
+ const [goal, setGoal] = useSessionState("ares.dashboard.strategy.goal", "domain_admin");
+ const [llmBackend, setLlmBackend] = useSessionState("ares.dashboard.strategy.llmBackend", "claude");
+ const [authorizations, setAuthorizations] = useSessionState("ares.dashboard.strategy.authorizations", "");
+ const [lastEngageResult, setLastEngageResult] = useSessionState<PersistedResult | null>("ares.dashboard.strategy.lastEngage", null);
+ const [rawTab, setActiveTab] = useTabParam("Objective");
+ const activeTab = (VALID_TABS_STRATEGY as readonly string[]).includes(rawTab)
+ ? (rawTab as StrategyTab)
+ : "Objective";
+ const [attemptedSubmit, setAttemptedSubmit] = useState(false);
+ const strategyResultKey = `${campaignId}:${goal}:${llmBackend}:${authorizations}`;
+ const engage = useMutation({
+ mutationFn: () =>
+ api.engageStrategy({
+ campaign_id: campaignId,
+ goal,
+ llm_backend: llmBackend,
+ max_rounds: 5,
+ authorizations: splitLines(authorizations)
+ }),
+ onSuccess: (payload) => {
+ setLastEngageResult({ key: strategyResultKey, payload });
+ setActiveTab("Result");
+ },
+ onError: (error) => {
+ setLastEngageResult({ key: strategyResultKey, payload: serializeError(error), isError: true });
+ setActiveTab("Result");
+ }
+ });
+ const persistedEngageResult = lastEngageResult?.key === strategyResultKey ? lastEngageResult : null;
+ const allowed = user?.role === "team_lead" || user?.role === "operator";
+
+ const llmBackends = (active.data?.llm_backends as Record<string, boolean> | undefined);
+ const isEngineUnconfigured = llmBackends ? llmBackends[llmBackend] === false : false;
+
+ const handleEngage = () => {
+ if (!campaignId) {
+ setAttemptedSubmit(true);
+ return;
+ }
+ setAttemptedSubmit(false);
+ engage.mutate();
+ };
+
+ return (
+ <Page
+ title="Strategy"
+ actions={<span className={allowed ? "status-pill status-low" : "status-pill status-high"}>{allowed ? "Authorized" : "Restricted"}</span>}
+ tabs={["Objective", "Active", "Result"]}
+ activeTab={activeTab}
+ onTabChange={setActiveTab}
+ >
+ {activeTab === "Objective" && (
+ <section className="panel p-4">
+ <SectionHeader title="Objective Builder" />
+ <div className="space-y-4">
+ <div>
+ <label htmlFor="strategy-campaign-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
+ Target Campaign
+ </label>
+ <CampaignPicker
+ id="strategy-campaign-select"
+ campaigns={campaignList}
+ value={campaignId}
+ hasError={attemptedSubmit && !campaignId}
+ onChange={(id) => {
+ setCampaignId(id);
+ if (id) {
+ setAttemptedSubmit(false);
+ }
+ }}
+ />
+ {attemptedSubmit && !campaignId && (
+ <p className="mt-1.5 flex items-center gap-1.5 text-xs text-rose-400" role="alert">
+ <AlertTriangle size={13} className="shrink-0 text-rose-400" />
+ Select a scoped campaign before starting Strategy.
+ </p>
+ )}
+ </div>
+
+ <div>
+ <label htmlFor="strategy-goal-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
+ Strategic Objective
+ </label>
+ <select
+ id="strategy-goal-select"
+ className="field"
+ value={goal}
+ onChange={(e) => setGoal(e.target.value)}
+ >
+ <option value="domain_admin">Domain Admin (Active Directory)</option>
+ <option value="enterprise_admin">Enterprise Admin (Forest Root)</option>
+ <option value="cloud_admin">Cloud Admin (Identity Provider)</option>
+ <option value="data_exfil">Data Exfiltration</option>
+ <option value="persistence">Persistence & Foothold</option>
+ <option value="full_compromise">Full Infrastructure Compromise</option>
+ </select>
+ </div>
+
+ <div>
+ <label htmlFor="strategy-engine-select" className="block text-xs font-medium text-zinc-300 mb-1.5">
+ AI Planning Engine
+ </label>
+ <select
+ id="strategy-engine-select"
+ className="field"
+ value={llmBackend}
+ onChange={(e) => setLlmBackend(e.target.value)}
+ >
+ <option value="claude">Claude (Anthropic)</option>
+ <option value="openai">OpenAI (GPT-4o)</option>
+ <option value="local">Local (Ollama)</option>
+ </select>
+ {isEngineUnconfigured && (
+ <p className="mt-1.5 flex items-center gap-1.5 text-xs text-amber-400/90">
+ <Info size={13} className="shrink-0 text-amber-400" />
+ {llmBackend === "claude"
+ ? "Anthropic API key is not configured in the server environment. Configure it on the server or select another engine."
+ : llmBackend === "openai"
+ ? "OpenAI API key is not configured in the server environment. Configure it on the server or select another engine."
+ : "Local Ollama service is not reachable at http://127.0.0.1:11434. Start Ollama or verify server connection."}
+ </p>
+ )}
+ </div>
+
+ <div>
+ <label htmlFor="strategy-authorizations" className="block text-xs font-medium text-zinc-300 mb-1.5">
+ Explicit Authorizations
+ </label>
+ <textarea
+ id="strategy-authorizations"
+ className="field min-h-24"
+ placeholder="Authorization notes or specific module constraints, one per line"
+ value={authorizations}
+ onChange={(e) => setAuthorizations(e.target.value)}
+ />
+ </div>
+ </div>
+
+ {!allowed && (
+ <p className="notice notice-danger mt-3">
+ Strategy engagement requires operator or team lead role.
+ </p>
+ )}
+
+ <button
+ className="btn btn-primary mt-4"
+ disabled={!allowed || engage.isPending}
+ onClick={handleEngage}
+ >
+ {engage.isPending ? (
+ <>
+ <Loader2 className="spin" size={16} /> Engaging...
+ </>
+ ) : (
+ "Engage Scope"
+ )}
+ </button>
+ </section>
+ )}
+ {activeTab === "Active" && (
+ <section className="grid gap-4">
+ {active.error ? (
+ <DataPanel title="Active Strategy Error" data={active.error} />
+ ) : active.data ? (
+ <StrategyActiveView
+ activeData={active.data as Record<string, unknown> | undefined}
+ goal={goal}
+ llmBackend={llmBackend}
+ allowed={allowed}
+ />
+ ) : (
+ <EmptyState text="No active strategy state is available yet." />
+ )}
+ </section>
+ )}
+ {activeTab === "Result" && (
+ <section className="panel p-4">
+ {(engage.data ?? engage.error ?? persistedEngageResult?.payload) ? (
+ <StrategyResultView
+ resultData={engage.data ?? engage.error ?? persistedEngageResult?.payload}
+ isError={Boolean(engage.error ?? persistedEngageResult?.isError)}
+ />
+ ) : (
+ <EmptyState text="Engage a strategy objective to see results here." />
+ )}
+ </section>
+ )}
+ </Page>
+ );
+}
+
+
+
+export default StrategyPage;
diff --git a/frontend/src/features/dashboard/pages/TemplatesPage.tsx b/frontend/src/features/dashboard/pages/TemplatesPage.tsx
new file mode 100644
index 0000000..85fab25
--- /dev/null
+++ b/frontend/src/features/dashboard/pages/TemplatesPage.tsx
@@ -0,0 +1,169 @@
+import {
+ Loader2,
+} from "lucide-react";
+import { useState } from "react";
+import { useMutation, useQuery } from "@tanstack/react-query";
+import { api } from "../../../api/client";
+import {
+ useSessionState,
+ useTabParam,
+} from "../dashboardUiState";
+import {
+ DataPanel,
+ EmptyState,
+ Page,
+ PersistedResult,
+ SectionHeader,
+ TemplatePlanResponse,
+ TemplatePlanSummary,
+ isJsonObject,
+ safeJson,
+ serializeError,
+} from "../dashboardComponents";
+
+const VALID_TABS_TEMPLATES = ["Templates", "Plan Builder"] as const;
+type TemplatesTab = typeof VALID_TABS_TEMPLATES[number];
+
+export function TemplatesPage() {
+ const templates = useQuery({ queryKey: ["templates"], queryFn: api.templates });
+ const [name, setName] = useSessionState("ares.dashboard.templates.name", "");
+ const [params, setParams] = useSessionState("ares.dashboard.templates.params", "{}");
+ const [warning, setWarning] = useState("");
+ const [lastPlanResult, setLastPlanResult] = useSessionState<PersistedResult | null>("ares.dashboard.templates.lastPlan", null);
+ const [rawTab, setActiveTab] = useTabParam("Templates");
+ const activeTab = (VALID_TABS_TEMPLATES as readonly string[]).includes(rawTab)
+ ? (rawTab as TemplatesTab)
+ : "Templates";
+ const templatePlanKey = `${name.trim()}:${params}`;
+ const plan = useMutation({
+ mutationFn: () => api.templatePlan(name, safeJson(params)),
+ onSuccess: (payload) => setLastPlanResult({ key: templatePlanKey, payload }),
+ onError: (error) => setLastPlanResult({ key: templatePlanKey, payload: serializeError(error), isError: true })
+ });
+ const selected = (templates.data ?? []).find((item) => item.name === name);
+ const persistedPlanResult = lastPlanResult?.key === templatePlanKey ? lastPlanResult : null;
+ const generated = (plan.data ?? (!persistedPlanResult?.isError ? persistedPlanResult?.payload : undefined)) as TemplatePlanResponse | undefined;
+ const paramsValid = isJsonObject(params);
+ return (
+ <Page
+ title="Templates"
+ actions={<span className="status-pill">{templates.data?.length ?? 0} templates</span>}
+ tabs={["Templates", "Plan Builder"]}
+ activeTab={activeTab}
+ onTabChange={setActiveTab}
+ >
+ <DataPanel title="Template Error" data={templates.error} />
+ {activeTab === "Templates" && (
+ <section className="panel p-4">
+ <SectionHeader
+ title="Campaign Templates"
+ description="Pick a template and generate a plan."
+ />
+ <div className="grid gap-2">
+ {(templates.data ?? []).map((item, index) => {
+ const templateName = String(item.name ?? item.id ?? index);
+ return (
+ <button
+ className={`template-card ${name === templateName ? "active" : ""}`}
+ key={templateName}
+ onClick={() => {
+ setName(templateName);
+ setWarning("");
+ setLastPlanResult(null);
+ plan.reset();
+ setActiveTab("Plan Builder");
+ }}
+ >
+ <span className="font-bold">{templateName}</span>
+ <small>{item.description ?? "Campaign execution template"}</small>
+ <span className="mt-2 flex flex-wrap gap-2">
+ <span className="badge">{item.stages ?? 0} stages</span>
+ <span className="badge">{item.modules ?? 0} modules</span>
+ </span>
+ </button>
+ );
+ })}
+ </div>
+ </section>
+ )}
+ {activeTab === "Plan Builder" && (
+ <section className="panel p-4">
+ <SectionHeader title="Plan Builder" action={name ? <span className="badge">{name}</span> : null} />
+ <input className="field" placeholder="Template name" value={name} onChange={(e) => {
+ setName(e.target.value);
+ setWarning("");
+ setLastPlanResult(null);
+ }} />
+ {selected ? (
+ <div className="preview-card mt-3">
+ <div className="font-bold">{selected.name}</div>
+ <p className="mt-1 text-sm text-zinc-300">{selected.description}</p>
+ <div className="mt-2 flex flex-wrap gap-2">
+ <span className="badge">{selected.stages ?? 0} stages</span>
+ <span className="badge">{selected.modules ?? 0} modules</span>
+ </div>
+ </div>
+ ) : (
+ <EmptyState text="Select a template from the left panel." />
+ )}
+ <div className="mt-3 block">
+ <label htmlFor="template-global-params" className="block text-sm font-semibold mb-1 cursor-pointer">
+ Global parameters
+ </label>
+ <textarea
+ id="template-global-params"
+ className="field min-h-32"
+ value={params}
+ placeholder={'{"target":"127.0.0.1","domain":"corp.local","dc":"10.0.0.5"}'}
+ autoComplete="off"
+ spellCheck={false}
+ onChange={(e) => {
+ setParams(e.target.value);
+ setWarning("");
+ }}
+ />
+ </div>
+ <p className="mt-1 text-xs text-zinc-400">JSON object. Leave {"{}"} for defaults.</p>
+ {(warning || !paramsValid) && (
+ <p className="notice notice-danger mt-2">
+ {warning || "Global parameters must be a valid JSON object."}
+ </p>
+ )}
+ <button
+ className="btn btn-primary mt-3"
+ disabled={!name || plan.isPending || !paramsValid}
+ onClick={() => {
+ if (!name.trim()) {
+ setWarning("Template name is required.");
+ return;
+ }
+ if (!paramsValid) {
+ setWarning("Global parameters must be a valid JSON object.");
+ return;
+ }
+ setWarning("");
+ plan.mutate();
+ }}
+ >
+ {plan.isPending ? (
+ <>
+ <Loader2 className="spin" size={16} /> Generating...
+ </>
+ ) : (
+ "Generate Plan"
+ )}
+ </button>
+ <TemplatePlanSummary plan={generated} />
+ <DataPanel
+ title={(plan.error ?? (persistedPlanResult?.isError ? persistedPlanResult.payload : undefined)) ? "Plan Error" : "Plan Details"}
+ data={plan.error ?? plan.data ?? persistedPlanResult?.payload}
+ />
+ </section>
+ )}
+ </Page>
+ );
+}
+
+
+
+export default TemplatesPage;
diff --git a/frontend/src/features/graph/GraphPage.test.tsx b/frontend/src/features/graph/GraphPage.test.tsx
new file mode 100644
index 0000000..d27f2ff
--- /dev/null
+++ b/frontend/src/features/graph/GraphPage.test.tsx
@@ -0,0 +1,170 @@
+import "../../test/setup";
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { cleanup, fireEvent, render, screen, waitFor } from "@testing-library/react";
+import { MemoryRouter } from "react-router-dom";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import type { AttackPathsResponse, Campaign } from "../../api/types";
+
+const mockCampaigns: Campaign[] = [
+ { id: "camp-001", name: "Alpha Engagement", targets: ["10.0.0.1", "10.0.0.2"] },
+ { id: "camp-002", name: "Bravo Assessment", targets: ["192.168.1.1"] }
+];
+
+const mockGraphData = {
+ nodes: [
+ { id: "node:firewall", label: "Perimeter Firewall", type: "firewall" },
+ { id: "node:dc01", label: "DC01.CORP.LOCAL", type: "dc" }
+ ],
+ edges: [
+ { id: "edge:fw-dc", source: "node:firewall", target: "node:dc01", label: "SMB" }
+ ]
+};
+
+const mockAttackPaths: AttackPathsResponse = {
+ paths: [
+ {
+ total_score: 90,
+ steps: [
+ { from: "node:firewall", to: "node:dc01", attack: "SMB Relay" }
+ ]
+ }
+ ]
+};
+
+vi.mock("../../api/client", () => ({
+ api: {
+ campaigns: vi.fn(async () => mockCampaigns),
+ graph: vi.fn(async () => mockGraphData),
+ attackPaths: vi.fn(async () => mockAttackPaths),
+ ingestBloodhound: vi.fn(async () => ({ status: "ok" }))
+ }
+}));
+
+import GraphPage from "./GraphPage";
+
+function renderGraphPage(props: {
+ campaignId?: string;
+ onCampaignIdChange?: (id: string) => void;
+} = {}) {
+ const queryClient = new QueryClient({
+ defaultOptions: {
+ queries: { retry: false, gcTime: 0 }
+ }
+ });
+
+ const onCampaignIdChange = props.onCampaignIdChange || vi.fn();
+ const campaignId = props.campaignId !== undefined ? props.campaignId : "camp-001";
+
+ return render(
+ <QueryClientProvider client={queryClient}>
+ <MemoryRouter>
+ <GraphPage
+ campaignId={campaignId}
+ onCampaignIdChange={onCampaignIdChange}
+ />
+ </MemoryRouter>
+ </QueryClientProvider>
+ );
+}
+
+describe("GraphPage Test Harness (AUD-009)", () => {
+ beforeEach(() => {
+ vi.clearAllMocks();
+ });
+
+ afterEach(() => {
+ cleanup();
+ });
+
+ it("renders Cobalt Strike C2 Console with title bar, controls, and session dock", async () => {
+ renderGraphPage();
+
+ expect(screen.getByLabelText("Cobalt Strike C2 Console")).toBeInTheDocument();
+ expect(screen.getAllByText("ARES").length).toBeGreaterThan(0);
+ expect(screen.getByLabelText("Cobalt Strike Pivot Graph")).toBeInTheDocument();
+
+ // Toolbar legend items
+ expect(screen.getAllByText(/SYSTEM \*/i).length).toBeGreaterThan(0);
+ expect(screen.getByText(/SMB Pivot/i)).toBeInTheDocument();
+
+ // Session dock terminal
+ await waitFor(() => {
+ expect(screen.getByText("beacon>")).toBeInTheDocument();
+ });
+ });
+
+ it("renders campaign selector and triggers onCampaignIdChange on switch", async () => {
+ const handleCampaignChange = vi.fn();
+ renderGraphPage({ campaignId: "camp-001", onCampaignIdChange: handleCampaignChange });
+
+ // Wait for campaigns to load and populate options
+ await waitFor(() => {
+ expect(screen.getByText("Alpha Engagement")).toBeInTheDocument();
+ expect(screen.getByText("Bravo Assessment")).toBeInTheDocument();
+ });
+
+ const select = screen.getByLabelText(/Campaign:/i);
+ fireEvent.change(select, { target: { value: "camp-002" } });
+
+ await waitFor(() => {
+ expect(handleCampaignChange).toHaveBeenCalledWith("camp-002");
+ });
+ });
+
+ it("toggles lateral pivot route focus [P] and displays HUD toast notice", async () => {
+ renderGraphPage();
+
+ const pivotBtn = screen.getByTitle(/Toggle Lateral Pivot Route Focus/i);
+ expect(pivotBtn).toBeInTheDocument();
+
+ fireEvent.click(pivotBtn);
+
+ await waitFor(() => {
+ expect(screen.getByText(/Pivot Focus: ACTIVE/i)).toBeInTheDocument();
+ });
+
+ fireEvent.click(pivotBtn);
+
+ await waitFor(() => {
+ expect(screen.getByText(/Pivot Focus: OFF/i)).toBeInTheDocument();
+ });
+ });
+
+ it("opens and closes the Attack Paths Explorer dialog", async () => {
+ renderGraphPage();
+
+ const attackPathsBtn = screen.getByTitle(/Attack Paths Explorer/i);
+ fireEvent.click(attackPathsBtn);
+
+ await waitFor(() => {
+ expect(screen.getByText("Attack Paths Explorer")).toBeInTheDocument();
+ });
+
+ const closeBtn = screen.getByRole("button", { name: "Close" });
+ fireEvent.click(closeBtn);
+
+ await waitFor(() => {
+ expect(screen.queryByText("Calculated lateral movement paths for active engagement campaign:")).not.toBeInTheDocument();
+ });
+ });
+
+ it("opens and closes the Help dialog with keyboard shortcuts reference", async () => {
+ renderGraphPage();
+
+ const helpItem = screen.getByTitle(/Operator Help, Shortcuts & Command Reference/i);
+ fireEvent.click(helpItem);
+
+ await waitFor(() => {
+ expect(screen.getByText(/ARES C2 - Operator Reference & Help Manual/i)).toBeInTheDocument();
+ expect(screen.getByText(/Interactive Canvas Controls:/i)).toBeInTheDocument();
+ expect(screen.getByText(/Clear locked pathway highlight and unlock topology view/i)).toBeInTheDocument();
+ });
+
+ const closeBtn = screen.getByRole("button", { name: "Close" });
+ fireEvent.click(closeBtn);
+
+ await waitFor(() => {
+ expect(screen.queryByText(/ARES C2 - Operator Reference & Help Manual/i)).not.toBeInTheDocument();
+ });
+ });
+});
diff --git a/frontend/src/test/setup.ts b/frontend/src/test/setup.ts
index f149f27..5792bcf 100644
--- a/frontend/src/test/setup.ts
+++ b/frontend/src/test/setup.ts
@@ -1 +1,51 @@
import "@testing-library/jest-dom/vitest";
+import { vi } from "vitest";
+
+// Safe mock for window.scrollTo in JSDOM
+if (typeof window !== "undefined") {
+ window.scrollTo = vi.fn();
+}
+
+// Safe mock for HTMLCanvasElement.prototype.getContext in JSDOM (AUD-012)
+if (typeof HTMLCanvasElement !== "undefined") {
+ HTMLCanvasElement.prototype.getContext = vi.fn().mockImplementation((contextId: string) => {
+ if (contextId === "2d") {
+ return {
+ fillRect: vi.fn(),
+ clearRect: vi.fn(),
+ getImageData: vi.fn(() => ({ data: new Array(4) })),
+ putImageData: vi.fn(),
+ createImageData: vi.fn(() => []),
+ setTransform: vi.fn(),
+ drawImage: vi.fn(),
+ save: vi.fn(),
+ fillText: vi.fn(),
+ restore: vi.fn(),
+ beginPath: vi.fn(),
+ moveTo: vi.fn(),
+ lineTo: vi.fn(),
+ closePath: vi.fn(),
+ stroke: vi.fn(),
+ translate: vi.fn(),
+ scale: vi.fn(),
+ rotate: vi.fn(),
+ arc: vi.fn(),
+ fill: vi.fn(),
+ measureText: vi.fn(() => ({ width: 0 })),
+ transform: vi.fn(),
+ rect: vi.fn(),
+ clip: vi.fn(),
+ } as unknown as CanvasRenderingContext2D;
+ }
+ return null;
+ });
+}
+
+// Safe mock for ResizeObserver for @xyflow/react in JSDOM
+if (typeof globalThis.ResizeObserver === "undefined") {
+ globalThis.ResizeObserver = class ResizeObserver {
+ observe() {}
+ unobserve() {}
+ disconnect() {}
+ };
+}