Skip to content

armgit / Pulse

Public Imported from GitHub
0

Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.

18.5 KB
Raw Blame
import { createMemo, type Accessor } from 'solid-js';
import type { Resource, ResourceRelationship } from '@/types/resource';
import type { HostNetworkInterface } from '@/types/api';
import { requiresGovernedResourceDisplay } from '@/types/resource';
import type { ResourceVMwareMeta } from '@/types/resource';
import { formatAbsoluteTime, formatRelativeTime } from '@/utils/format';
import { useRelativeTimeNow } from '@/utils/relativeTimeClock';
import { getAgentStatusIndicator } from '@/utils/status';
import { getAgentFirstReportStatusIndicator } from '@/utils/agentResources';
import { mapDockerContainerStatus } from '@/features/docker/dockerPageModel';
import {
  dedupeResourceBadges,
  getInfrastructureSystemIdentityBadges,
  getPlatformBadge,
  getSourceBadge,
  getTypeBadge,
  getUnifiedSourceBadges,
} from '@/utils/resourceBadgePresentation';
import {
  getPreferredResourceClusterName,
  getPreferredInfrastructureDisplayName,
} from '@/utils/resourceIdentity';
import { areSystemSettingsLoaded, shouldHideDockerUpdateActions } from '@/stores/systemSettings';
import { useAlertsActivation } from '@/stores/alertsActivation';
import {
  getResourcePolicyBadges,
  getResourcePolicyGovernedSummary,
  getResourcePolicyRedactionLabels,
  getResourceRoutingScopeLabel,
  hasDefaultResourcePolicyPosture,
} from '@/utils/resourcePolicyPresentation';
import { formatResourceAnalysisSummary } from '@/utils/resourceAnalysisPresentation';
import type { ResourceIntelligence } from '@/types/aiIntelligence';
import {
  buildCustomSensorRows,
  buildTemperatureRows,
  HOST_AGENT_STOPPED_REPORTING_REASON,
  toAgentFromResource,
  toNodeFromProxmox,
  type AgentPlatformData,
  type DockerPlatformData,
  type KubernetesPlatformData,
  type PlatformData,
} from '@/components/Infrastructure/resourceDetailMappers';
import {
  getResourceGuestReadPrecaution,
  toDiscoveryConfig,
} from '@/components/Infrastructure/resourceDetailDiscoveryModel';
import {
  buildPbsActiveTasks,
  buildPbsVisibleJobBreakdown,
  buildPmgVisibleMailBreakdown,
  buildPmgVisibleQueueBreakdown,
  getPbsJobTotal,
  getPmgQueueBacklog,
  getServiceDetailsSummary,
} from './resourceDetailDrawerServiceModel';
import {
  buildAccessSummary,
  buildHostDetailCards,
  buildHostDetailSummary,
  buildKubernetesCapabilityBadges,
  buildRelatedLinks,
  buildSourceSummary,
  hasRuntimeOperationalContext as buildHasRuntimeOperationalContext,
} from './resourceDetailDrawerOperationalModel';
import {
  getResourceMetricsHistoryCurrentMetrics,
  getResourceMetricsHistoryDeferredMetrics,
  getResourceMetricsHistoryGroups,
  getResourceMetricsHistoryTarget,
  resourceSupportsMetricsHistory,
} from './resourceDetailDrawerMetricsHistoryModel';
import {
  buildIdentityMatchInfo,
  buildResourceDebugBundle,
  buildResourceIdentityView,
  buildSourceSections,
} from './resourceDetailDrawerIdentityModel';
import { buildVMwareDetailSections } from './resourceDetailDrawerVmwareModel';
import { buildTrueNASDetailSections } from './resourceDetailDrawerTrueNASModel';
import { buildKubernetesDetailSections } from './resourceDetailDrawerKubernetesModel';
import { getResourceHealthIssuePresentation } from './resourceHealthPresentation';

type DrawerTab = 'overview' | 'manage' | 'mail' | 'namespaces' | 'debug';

interface UseResourceDetailDrawerDerivedStateOptions {
  resource: Resource;
  resolveResourceLabel?: (resourceId: string) => string | null | undefined;
  debugEnabled: Accessor<boolean>;
  resourceIntelligence: Accessor<ResourceIntelligence | null>;
  resourceRelationships?: Accessor<readonly ResourceRelationship[] | null | undefined>;
}

export const useResourceDetailDrawerDerivedState = (
  options: UseResourceDetailDrawerDerivedStateOptions,
) => {
  const resource = () => options.resource;
  const {
    resolveResourceLabel: resolveResourceLabelInput,
    debugEnabled,
    resourceIntelligence,
  } = options;

  const displayName = createMemo(() => getPreferredInfrastructureDisplayName(resource()));
  const kubernetesClusterName = createMemo(() => getPreferredResourceClusterName(resource()) ?? '');
  const resolveResourceLabel = (resourceId: string): string =>
    resolveResourceLabelInput?.(resourceId)?.trim() || resourceId;
  // A container's dot reads its run state and health check, the same mapper
  // its table row uses, so a running but unhealthy container is not green here
  // while red in the row above.
  const statusIndicator = createMemo(() =>
    resource().type === 'app-container'
      ? mapDockerContainerStatus(resource())
      : (getAgentFirstReportStatusIndicator(resource()) ??
        getAgentStatusIndicator({ status: resource().status })),
  );
  const healthIssue = createMemo(() => getResourceHealthIssuePresentation(resource()));
  // An open drawer keeps its rows while a resource's timestamps stay the same,
  // which is exactly when a silent resource's Last seen must keep aging, so
  // the drawer's ages read the shared clock.
  const now = useRelativeTimeNow();
  const lastSeen = createMemo(() => formatRelativeTime(resource().lastSeen, { now: now() }));
  const lastSeenAbsolute = createMemo(() => formatAbsoluteTime(resource().lastSeen));

  const platformBadge = createMemo(() => getPlatformBadge(resource().platformType));
  const sourceBadge = createMemo(() => getSourceBadge(resource().sourceType));
  const typeBadge = createMemo(() => getTypeBadge(resource().type));
  const platformData = createMemo(() => resource().platformData as PlatformData | undefined);
  const unifiedSourceBadges = createMemo(() => {
    const sources = resource().sources;
    return getUnifiedSourceBadges(
      Array.isArray(sources) && sources.length > 0 ? sources : (platformData()?.sources ?? []),
    );
  });
  const systemIdentityBadges = createMemo(() => getInfrastructureSystemIdentityBadges(resource()));
  const hasUnifiedSources = createMemo(() => unifiedSourceBadges().length > 0);
  const headerBadges = createMemo(() =>
    dedupeResourceBadges([
      typeBadge(),
      ...(systemIdentityBadges().length > 0
        ? systemIdentityBadges()
        : hasUnifiedSources()
          ? unifiedSourceBadges()
          : [platformBadge(), sourceBadge()]),
    ]),
  );
  const policyBadges = createMemo(() => getResourcePolicyBadges(resource().policy));
  const policyRedactions = createMemo(() => getResourcePolicyRedactionLabels(resource().policy));
  const governanceSummary = createMemo(() =>
    requiresGovernedResourceDisplay(resource().policy)
      ? getResourcePolicyGovernedSummary(resource())
      : (resource().aiSafeSummary?.trim() ?? ''),
  );
  const hasGovernanceData = createMemo(
    () =>
      !hasDefaultResourcePolicyPosture(resource().policy) &&
      (policyBadges().length > 0 || Boolean(governanceSummary())),
  );

  const agentMeta = createMemo(
    () => resource().agent ?? (platformData()?.agent as AgentPlatformData | undefined),
  );
  const kubernetesMeta = createMemo(
    () =>
      resource().kubernetes ?? (platformData()?.kubernetes as KubernetesPlatformData | undefined),
  );
  const vmwareData = createMemo(
    () => resource().vmware ?? (platformData()?.vmware as ResourceVMwareMeta | undefined),
  );
  const kubernetesCapabilityBadges = createMemo(() =>
    buildKubernetesCapabilityBadges(kubernetesMeta()?.metricCapabilities),
  );

  const proxmoxNode = createMemo(() => toNodeFromProxmox(resource()));
  const proxmoxNetworkInterfaces = createMemo(
    () =>
      resource().proxmox?.networkInterfaces ??
      (platformData()?.proxmox as { networkInterfaces?: HostNetworkInterface[] } | undefined)
        ?.networkInterfaces ??
      [],
  );
  const agentInfo = createMemo(() => toAgentFromResource(resource(), agentMeta()));
  // A silent agent's sensors and disk usage are its last report, even on a
  // row another source keeps online.
  const agentReadingsLastKnownReason = createMemo(() =>
    resource().agent?.stale ? HOST_AGENT_STOPPED_REPORTING_REASON : undefined,
  );
  const temperatureRows = createMemo(() =>
    buildTemperatureRows(agentInfo()?.sensors, {
      lastKnownReason: agentReadingsLastKnownReason(),
    }),
  );
  const customSensorRows = createMemo(() => buildCustomSensorRows(agentInfo()?.sensors));

  const dockerHostData = createMemo(() => platformData()?.docker as DockerPlatformData | undefined);
  const dockerHostSourceId = createMemo(
    () => (dockerHostData()?.hostSourceId || '').trim() || null,
  );
  const dockerUpdatesAvailable = createMemo(() => dockerHostData()?.updatesAvailableCount ?? 0);
  const dockerContainerCount = createMemo(() => dockerHostData()?.containerCount ?? 0);
  const dockerUpdatesCheckedRelative = createMemo(() => {
    const raw = dockerHostData()?.updatesLastCheckedAt;
    if (!raw) return '';
    const parsed = Date.parse(raw);
    if (!Number.isFinite(parsed)) return '';
    return formatRelativeTime(parsed, { now: now() });
  });
  const dockerHostCommand = createMemo(() => dockerHostData()?.command);
  const dockerHostCommandActive = createMemo(() => {
    const status = (dockerHostCommand()?.status || '').trim().toLowerCase();
    return ['queued', 'dispatched', 'acknowledged', 'in_progress'].includes(status);
  });
  const dockerUpdateActionsDisabled = createMemo(() => shouldHideDockerUpdateActions());
  const dockerUpdateActionsLoading = createMemo(() => !areSystemSettingsLoaded());

  const resourceDependencies = createMemo(() => resourceIntelligence()?.dependencies ?? []);
  const resourceDependents = createMemo(() => resourceIntelligence()?.dependents ?? []);
  const resourceCorrelations = createMemo(() => resourceIntelligence()?.correlations ?? []);
  const resourceRelationships = createMemo(
    () => options.resourceRelationships?.() ?? resource().relationships ?? [],
  );
  const hasMeaningfulResourceIntelligence = createMemo(() => {
    const intel = resourceIntelligence();
    if (!intel) return false;

    return (
      (intel.health.score ?? 100) < 100 ||
      intel.health.trend !== 'stable' ||
      (intel.health.prediction?.trim() ?? '') !== '' ||
      (intel.health.factors?.length ?? 0) > 0 ||
      (intel.note_count ?? 0) > 0 ||
      (intel.recent_changes?.length ?? 0) > 0
    );
  });
  const hasCorrelationContext = createMemo(
    () =>
      resourceRelationships().length > 0 ||
      resourceDependencies().length > 0 ||
      resourceDependents().length > 0 ||
      resourceCorrelations().length > 0,
  );
  const hasInvestigationContext = createMemo(
    () => hasMeaningfulResourceIntelligence() || hasGovernanceData(),
  );
  const investigationContextSummary = createMemo(() => {
    const intel = resourceIntelligence();
    const summary: string[] = [];

    if (intel && hasMeaningfulResourceIntelligence()) {
      summary.push(formatResourceAnalysisSummary(intel.health.grade, intel.health.score));
    }
    const policy = resource().policy;
    if (policy?.routing.scope && !hasDefaultResourcePolicyPosture(policy)) {
      summary.push(`Routing ${getResourceRoutingScopeLabel(policy.routing.scope)}`);
    }

    return summary.join(' · ');
  });

  const pbsData = createMemo(() => platformData()?.pbs);
  const pmgData = createMemo(() => platformData()?.pmg);
  const pbsJobTotal = createMemo(() => getPbsJobTotal(pbsData()));
  const pmgQueueBacklog = createMemo(() => getPmgQueueBacklog(pmgData()));
  const pmgUpdatedRelative = createMemo(() => {
    const raw = pmgData()?.lastUpdated;
    if (!raw) return '';
    const parsed = Date.parse(raw);
    if (!Number.isFinite(parsed)) return '';
    return formatRelativeTime(parsed, { now: now() });
  });
  const pbsVisibleJobBreakdown = createMemo(() => buildPbsVisibleJobBreakdown(pbsData()));
  const pbsActiveTasks = createMemo(() => buildPbsActiveTasks(pbsData()));
  const pbsActiveTaskCount = createMemo(() => pbsActiveTasks().length);
  const pmgVisibleQueueBreakdown = createMemo(() => buildPmgVisibleQueueBreakdown(pmgData()));
  const pmgVisibleMailBreakdown = createMemo(() => buildPmgVisibleMailBreakdown(pmgData()));

  const mergedSources = createMemo(() => platformData()?.sources ?? []);
  const sourceStatus = createMemo<NonNullable<PlatformData['sourceStatus']>>(
    () => platformData()?.sourceStatus ?? {},
  );
  const sourceSummary = createMemo(() => buildSourceSummary(mergedSources(), sourceStatus()));

  const identityView = createMemo(() => buildResourceIdentityView(resource()));
  const identityAliasValues = createMemo(() => identityView().identityAliasValues);
  const identityIpValues = createMemo(() => identityView().identityIpValues);
  const primaryIdentityRows = createMemo(() => identityView().primaryIdentityRows);
  const identityCardHasRichData = createMemo(() => identityView().identityCardHasRichData);
  const aliasPreviewValues = createMemo(() => identityView().aliasPreviewValues);
  const hasAliasOverflow = createMemo(() => identityView().hasAliasOverflow);
  const hasMergedSources = createMemo(() => mergedSources().length > 1);
  const discoveryConfig = createMemo(() => toDiscoveryConfig(resource()));
  const guestReadPrecaution = createMemo(() => getResourceGuestReadPrecaution(resource()));

  const hostDetailCards = createMemo(() =>
    buildHostDetailCards({
      hasProxmoxNode: Boolean(proxmoxNode()),
      hasAgentDetails: Boolean(agentInfo()),
      networkInterfaceCount: Math.max(
        agentInfo()?.networkInterfaces?.length ?? 0,
        proxmoxNetworkInterfaces().length,
      ),
      diskCount: agentInfo()?.disks?.length ?? 0,
      raidCount: agentMeta()?.raid?.length ?? 0,
      temperatureRowCount: temperatureRows().length + customSensorRows().length,
    }),
  );
  const hasHostDetails = createMemo(() => hostDetailCards().length > 0);
  const hostDetailSummary = createMemo(() => buildHostDetailSummary(hostDetailCards()));
  const hasServiceDetails = createMemo(
    () => resource().type === 'docker-host' || Boolean(pbsData()) || Boolean(pmgData()),
  );
  const serviceDetailsSummary = createMemo(() => {
    return getServiceDetailsSummary({
      resourceType: resource().type,
      docker: dockerHostData(),
      pbs: pbsData(),
      pmg: pmgData(),
    });
  });
  const vmwareDetailSections = createMemo(() =>
    buildVMwareDetailSections(resource().type, vmwareData()),
  );
  const { getTrueNASDiskTemperatureThresholds } = useAlertsActivation();
  const trueNASDetailSections = createMemo(() =>
    buildTrueNASDetailSections(resource(), getTrueNASDiskTemperatureThresholds),
  );
  const kubernetesDetailSections = createMemo(() => buildKubernetesDetailSections(resource()));
  const metricsHistoryTarget = createMemo(() => getResourceMetricsHistoryTarget(resource()));
  const metricsHistoryCurrentMetrics = createMemo(() =>
    getResourceMetricsHistoryCurrentMetrics(resource()),
  );
  const metricsHistoryDeferredMetrics = createMemo(() =>
    getResourceMetricsHistoryDeferredMetrics(resource()),
  );
  const metricsHistoryGroups = createMemo(() => getResourceMetricsHistoryGroups(resource()));
  const hasMetricsHistory = createMemo(() => resourceSupportsMetricsHistory(resource()));
  const relatedLinks = createMemo(() => buildRelatedLinks(resource(), displayName()));
  const accessSummary = createMemo(() =>
    buildAccessSummary({
      hasWebInterface: Boolean(discoveryConfig()),
      links: relatedLinks(),
    }),
  );
  const hasAccessContext = createMemo(
    () => Boolean(discoveryConfig()) || relatedLinks().length > 0,
  );
  const hasRuntimeOperationalContext = createMemo(() =>
    buildHasRuntimeOperationalContext(kubernetesCapabilityBadges()),
  );

  const sourceSections = createMemo(() => buildSourceSections(platformData()));
  const identityMatchInfo = createMemo(() => buildIdentityMatchInfo(platformData()));
  const debugBundle = createMemo(() =>
    buildResourceDebugBundle({
      resource: resource(),
      platformData: platformData(),
      sourceStatus: sourceStatus(),
      identityMatchInfo: identityMatchInfo(),
    }),
  );
  const debugJson = createMemo(() => JSON.stringify(debugBundle(), null, 2));

  const tabs = createMemo(() => {
    const base = [
      // A resource with stored history charts it on Overview; there is no
      // separate History tab repeating those charts at another range.
      { id: 'overview' as DrawerTab, label: 'Overview' },
      { id: 'manage' as DrawerTab, label: 'Manage' },
      ...(resource().type === 'pmg' ? [{ id: 'mail' as DrawerTab, label: 'Mail' }] : []),
      // Deployments and Swarm services have their own platform tabs
      // (Kubernetes > Workloads, Docker > Swarm), so the drawer does not
      // repeat them; namespaces scope those tabs from here.
      ...(resource().type === 'k8s-cluster'
        ? [{ id: 'namespaces' as DrawerTab, label: 'Namespaces' }]
        : []),
    ];
    if (debugEnabled()) {
      base.push({ id: 'debug' as DrawerTab, label: 'Debug' });
    }
    return base;
  });

  return {
    displayName,
    kubernetesClusterName,
    resolveResourceLabel,
    statusIndicator,
    healthIssue,
    lastSeen,
    lastSeenAbsolute,
    platformBadge,
    sourceBadge,
    typeBadge,
    platformData,
    unifiedSourceBadges,
    hasUnifiedSources,
    headerBadges,
    policyBadges,
    policyRedactions,
    governanceSummary,
    hasGovernanceData,
    agentMeta,
    kubernetesMeta,
    vmwareData,
    kubernetesCapabilityBadges,
    proxmoxNode,
    proxmoxNetworkInterfaces,
    agentInfo,
    agentReadingsLastKnownReason,
    temperatureRows,
    customSensorRows,
    dockerHostData,
    dockerHostSourceId,
    dockerUpdatesAvailable,
    dockerContainerCount,
    dockerUpdatesCheckedRelative,
    dockerHostCommand,
    dockerHostCommandActive,
    dockerUpdateActionsDisabled,
    dockerUpdateActionsLoading,
    resourceDependencies,
    resourceDependents,
    resourceCorrelations,
    resourceRelationships,
    hasCorrelationContext,
    hasMeaningfulResourceIntelligence,
    hasInvestigationContext,
    investigationContextSummary,
    pbsData,
    pmgData,
    pbsJobTotal,
    pbsActiveTasks,
    pbsActiveTaskCount,
    pmgQueueBacklog,
    pmgUpdatedRelative,
    pbsVisibleJobBreakdown,
    pmgVisibleQueueBreakdown,
    pmgVisibleMailBreakdown,
    mergedSources,
    sourceStatus,
    sourceSummary,
    identityIpValues,
    identityAliasValues,
    primaryIdentityRows,
    identityCardHasRichData,
    aliasPreviewValues,
    hasAliasOverflow,
    hasMergedSources,
    discoveryConfig,
    accessSummary,
    hasAccessContext,
    hasHostDetails,
    hostDetailSummary,
    hasServiceDetails,
    serviceDetailsSummary,
    metricsHistoryTarget,
    metricsHistoryCurrentMetrics,
    metricsHistoryDeferredMetrics,
    metricsHistoryGroups,
    hasMetricsHistory,
    guestReadPrecaution,
    vmwareDetailSections,
    trueNASDetailSections,
    kubernetesDetailSections,
    relatedLinks,
    hasRuntimeOperationalContext,
    sourceSections,
    identityMatchInfo,
    debugJson,
    tabs,
  };
};