@kal-elsam/kairo-runtime 0.13.1 → 0.15.0

package/src/global/ink/orchestrator-app.js

@@ -46,6 +46,7 @@ import { LAYOUT_MODES } from "./layout.js";
 import { CHANGES_PHASE } from "./cockpit-changes.js";
 import { RECOVERY_PHASE, listRecoverySnapshots } from "./cockpit-recovery.js";
 import { SETTINGS_PHASE } from "./cockpit-settings.js";
+import { buildOverviewButtons, OVERVIEW_BUTTON_COUNT } from "./ux/overview-actions.js";
 
 export function OrchestratorApp({
   homeDir,
@@ -62,8 +63,7 @@ export function OrchestratorApp({
   const [ui, dispatch] = useReducer(
     reduceCockpitUi,
     createCockpitUiState({
-      layoutMode: layoutMode ?? LAYOUT_MODES.COMPACT,
-      region: COCKPIT_REGIONS.NAV
+      layoutMode: layoutMode ?? LAYOUT_MODES.COMPACT
     })
   );
   const data = useOrchestratorData({
@@ -165,6 +165,26 @@ export function OrchestratorApp({
       return;
     }
 
+    if (ui.view === ORCHESTRATOR_VIEWS.HOME && !ui.paletteOpen) {
+      const digit = inputKey === "1" ? 0 : inputKey === "2" ? 1 : -1;
+      if (digit >= 0) {
+        const buttons = buildOverviewButtons({
+          hasGlobalState,
+          snapshot: data.snapshot,
+          diagnostics: data.diagnostics,
+          dashboard: data.dashboard
+        });
+        const selected = buttons[digit];
+        const intent = selected?.intent ?? null;
+        if (intent === "setup") {
+          finish({ cancelled: false, action: "setup" });
+          return;
+        }
+        if (intent && openDestination(intent)) return;
+        return;
+      }
+    }
+
     if (inputKey === " " && ui.view === ORCHESTRATOR_VIEWS.HOME && !ui.paletteOpen) {
       dispatch({ type: "toggle-overview-details" });
       return;
@@ -245,7 +265,9 @@ export function OrchestratorApp({
       return;
     }
 
-    const listLength = ui.view === ORCHESTRATOR_VIEWS.RUNS
+    const listLength = ui.view === ORCHESTRATOR_VIEWS.HOME
+      ? OVERVIEW_BUTTON_COUNT
+      : ui.view === ORCHESTRATOR_VIEWS.RUNS
       ? RUNS_HUB_ITEMS.length
       : ui.view === ORCHESTRATOR_VIEWS.ACTIVE_RUNS
         ? (data.dashboard?.activeRuns ?? []).length
@@ -301,6 +323,21 @@ export function OrchestratorApp({
           return;
         }
       }
+      if (routed.type === "enter-home-button") {
+        const buttons = buildOverviewButtons({
+          hasGlobalState,
+          snapshot: data.snapshot,
+          diagnostics: data.diagnostics,
+          dashboard: data.dashboard
+        });
+        const selected = buttons[Math.min(Math.max(0, ui.listIndex), buttons.length - 1)];
+        const intent = selected?.intent ?? null;
+        if (intent === "setup") {
+          finish({ cancelled: false, action: "setup" });
+          return;
+        }
+        if (intent && openDestination(intent)) return;
+      }
       dispatch(routed);
       return;
     }
@@ -583,7 +620,8 @@ export function OrchestratorApp({
         governanceDetailsOpen: ui.governanceDetailsOpen,
         activityDetailsOpen: ui.activityDetailsOpen,
         contentFocused: ui.region === COCKPIT_REGIONS.CONTENT,
-        homeDir
+        homeDir,
+        hasGlobalState
       })
     )
   );

package/src/global/ink/ux/live-overview.js

@@ -1,16 +1,16 @@
 /**
  * Live semantic Overview for Cockpit HOME — product cover.
- * Nav owns the sole focus mark — this panel never renders `>`.
+ * Content owns the button focus mark when region=content.
  * ASCII wordmark only here (wide/compact); minimal is textual.
  *
- * Rule: show purpose + one next step + a few plain-language needs.
+ * Rule: show purpose + two buttons + a few plain-language needs.
  * Machine/system noise stays out of the first screen (Details only).
  */
 import React from "react";
 import { Box, Text } from "ink";
 import { DASHBOARD_PURPOSE } from "../../dashboard-guidance.js";
 import { LAYOUT_MODES } from "../layout.js";
-import { COCKPIT_COLORS } from "../theme.js";
+import { COCKPIT_COLORS, resolveGlyphs } from "../theme.js";
 import {
   overviewBrandTitle,
   shouldShowWordmark,
@@ -24,6 +24,7 @@ import {
   mapHealthTone,
   partitionCompanionLines
 } from "./overview-needs.js";
+import { buildOverviewButtons, OVERVIEW_BUTTON_COUNT } from "./overview-actions.js";
 
 export {
   humanizeCompanionNeed,
@@ -33,6 +34,8 @@ export {
   partitionCompanionLines
 } from "./overview-needs.js";
 
+export { buildOverviewButtons, OVERVIEW_BUTTON_COUNT } from "./overview-actions.js";
+
 /** Safe Details lines — leftovers + raw signals; never invent paths/IDs. */
 export function buildOverviewDetails(model = {}, companionRest = []) {
   const lines = [];
@@ -59,13 +62,19 @@ export function buildOverviewDetails(model = {}, companionRest = []) {
 
 /**
  * Pure adapter: buildControlCenterModel → semantic overview props.
- * First screen = purpose + next step + plain needs. Machine noise → Details.
+ * First screen = purpose + two buttons + plain needs. Machine noise → Details.
  */
-export function adaptControlCenterToOverview(model = {}) {
+export function adaptControlCenterToOverview(model = {}, options = {}) {
   const status = model.status ?? model.health ?? {};
   const next = model.nextAction ?? model.cta ?? {};
   const { needs, rest } = partitionCompanionLines(model.companion?.lines ?? []);
   const primary = humanizePrimary(next);
+  const buttons = buildOverviewButtons({
+    hasGlobalState: options.hasGlobalState,
+    snapshot: options.snapshot,
+    diagnostics: options.diagnostics,
+    dashboard: options.dashboard
+  });
 
   const activity = model.activity?.headline;
   const metrics = [];
@@ -85,12 +94,6 @@ export function adaptControlCenterToOverview(model = {}) {
       label: `Alerts · ${model.alerts.headline ?? `${model.alerts.count} open`}`
     });
   }
-  if (rest.length > 0) {
-    metrics.push({
-      id: "more",
-      label: `${rest.length} more in Details · Space`
-    });
-  }
   if (metrics.length === 0) {
     metrics.push({ id: "quiet", label: "Nothing else needs you right now" });
   }
@@ -104,6 +107,7 @@ export function adaptControlCenterToOverview(model = {}) {
       body: status.summaryLine ?? ""
     },
     primary,
+    buttons,
     metrics,
     details: buildOverviewDetails(model, rest)
   };
@@ -136,14 +140,30 @@ export function SemanticOverviewPanel({
   detailsOpen = false,
   colorEnabled = true,
   unicode = true,
-  layoutMode = LAYOUT_MODES.COMPACT
+  layoutMode = LAYOUT_MODES.COMPACT,
+  selectedIndex = 0,
+  contentFocused = false,
+  hasGlobalState = false,
+  snapshot = null,
+  diagnostics = null,
+  dashboard = null
 }) {
-  const view = adaptControlCenterToOverview(model);
+  const view = adaptControlCenterToOverview(model, {
+    hasGlobalState,
+    snapshot,
+    diagnostics,
+    dashboard
+  });
   const showArt = shouldShowWordmark(layoutMode);
   const brandTitle = overviewBrandTitle(layoutMode);
   const isWide = layoutMode === LAYOUT_MODES.WIDE;
   const mark = renderWordmark({ layoutMode, colorEnabled, unicode });
   const status = renderCallout(view, colorEnabled);
+  const safeIndex = Math.min(
+    Math.max(0, selectedIndex),
+    Math.max(0, view.buttons.length - 1)
+  );
+  const glyphs = resolveGlyphs(unicode);
 
   const hero = showArt
     ? (isWide
@@ -166,18 +186,25 @@ export function SemanticOverviewPanel({
       color: colorEnabled ? COCKPIT_COLORS.muted : undefined
     }, view.purpose),
     React.createElement(Box, { marginTop: 1, flexDirection: "column" },
-      React.createElement(Text, {
-        bold: true,
-        color: colorEnabled ? COCKPIT_COLORS.interactive : undefined
-      }, `→ ${view.primary.label}`),
-      view.primary.detail
-        ? React.createElement(Text, null, view.primary.detail)
-        : null,
-      view.primary.hint
-        ? React.createElement(Text, {
-          color: colorEnabled ? COCKPIT_COLORS.muted : undefined
-        }, view.primary.hint)
-        : null
+      ...view.buttons.map((button, index) => {
+        const selected = index === safeIndex;
+        const focused = contentFocused && selected;
+        return React.createElement(Box, {
+          key: button.id,
+          flexDirection: "column",
+          marginBottom: index === view.buttons.length - 1 ? 0 : 1
+        },
+          React.createElement(Text, {
+            bold: selected,
+            color: colorEnabled && selected ? COCKPIT_COLORS.interactive : undefined
+          }, `${selected ? glyphs.focus : " "} [${index + 1}] ${button.label}${focused ? "  ← Press Enter" : ""}`),
+          button.detail
+            ? React.createElement(Text, {
+              color: colorEnabled ? COCKPIT_COLORS.muted : undefined
+            }, `      ${button.detail}`)
+            : null
+        );
+      })
     ),
     React.createElement(Box, { marginTop: 1, flexDirection: "column" },
       React.createElement(ActionList, {
@@ -190,7 +217,7 @@ export function SemanticOverviewPanel({
     ),
     React.createElement(Details, {
       open: detailsOpen,
-      summary: "More info",
+      summary: `More info (${view.details.length})`,
       lines: view.details,
       colorEnabled,
       focused: false,

package/src/global/ink/ux/overview-actions.js

@@ -0,0 +1,80 @@
+/**
+ * Two explicit Home buttons — prepare + configure.
+ * No writes here: intents only open existing consent-gated flows.
+ */
+
+export const OVERVIEW_BUTTON_COUNT = 2;
+
+function changeCount(snapshot) {
+  if (!snapshot?.diff?.hasChanges) return 0;
+  return snapshot.diff.changeCount
+    ?? snapshot.diff.changes?.length
+    ?? 0;
+}
+
+function detectedAgentCount({ snapshot = null, diagnostics = null, dashboard = null } = {}) {
+  if (Number.isFinite(snapshot?.coverage?.detectedAgents)) {
+    return snapshot.coverage.detectedAgents;
+  }
+  if (Number.isFinite(diagnostics?.diagnostics?.detected)) {
+    return diagnostics.diagnostics.detected;
+  }
+  return (dashboard?.providers ?? []).filter((entry) => entry?.available).length;
+}
+
+function buildPrepareButton({
+  hasGlobalState = false,
+  snapshot = null,
+  diagnostics = null,
+  dashboard = null
+} = {}) {
+  const detected = detectedAgentCount({ snapshot, diagnostics, dashboard });
+  const needsSetup = hasGlobalState === false || detected === 0;
+  if (needsSetup) {
+    return {
+      id: "prepare",
+      label: "Set up Kairo",
+      detail: "Detect your agents and install what is missing.",
+      intent: "setup"
+    };
+  }
+
+  const pending = changeCount(snapshot);
+  if (pending > 0) {
+    return {
+      id: "prepare",
+      label: `Repair ${pending} change${pending === 1 ? "" : "s"}`,
+      detail: "You will see the exact plan before anything is written.",
+      intent: "governance"
+    };
+  }
+
+  return {
+    id: "prepare",
+    label: "Everything is ready",
+    detail: "Open History to see what changed, or Configure to adjust.",
+    intent: "history"
+  };
+}
+
+const CONFIGURE_BUTTON = Object.freeze({
+  id: "configure",
+  label: "Configure",
+  detail: "Agents, Obsidian vault, integrations.",
+  intent: "settings"
+});
+
+/**
+ * Exactly two buttons for Home. First button changes face by state.
+ */
+export function buildOverviewButtons({
+  hasGlobalState = false,
+  snapshot = null,
+  diagnostics = null,
+  dashboard = null
+} = {}) {
+  return [
+    buildPrepareButton({ hasGlobalState, snapshot, diagnostics, dashboard }),
+    { ...CONFIGURE_BUTTON }
+  ];
+}

package/src/global/ink/ux/overview-needs.js

@@ -4,7 +4,7 @@
 import { CONTROL_PLANE_HEALTH } from "../../control-plane-snapshot.js";
 import { formatCliCommand } from "../../brand/cli.js";
 
-export const OVERVIEW_NEED_LIMIT = 3;
+export const OVERVIEW_NEED_LIMIT = 2;
 
 /** Prefixes that never belong on the first screen (machine / internals). */
 export const DETAILS_ONLY_PREFIXES = [

package/src/global/integrations/engram-evidence.js

@@ -215,12 +215,17 @@ function jsonKeyEvidence(path, keyPath, kind) {
   try {
     let cursor = JSON.parse(readFileSync(path, "utf8"));
     for (const key of keyPath) {
-      if (cursor == null || typeof cursor !== "object") {
+      if (cursor == null || typeof cursor !== "object" || Array.isArray(cursor)) {
         return { path, kind, present: false, conflict: true, keyPath, detail: "invalid structure" };
       }
+      // Missing key = unconfigured evidence, not a conflict (file may use another MCP path).
+      if (!Object.prototype.hasOwnProperty.call(cursor, key)) {
+        return { path, kind, present: false, conflict: false, keyPath };
+      }
       cursor = cursor[key];
     }
-    return { path, kind, present: cursor != null && typeof cursor === "object", conflict: false, keyPath };
+    const present = cursor != null && typeof cursor === "object" && !Array.isArray(cursor);
+    return { path, kind, present, conflict: false, keyPath };
   } catch {
     return { path, kind, present: false, conflict: true, keyPath, detail: "unreadable json" };
   }

package/src/global/integrations/sdd-apply.js

@@ -17,7 +17,8 @@ const APPLYING_ACTIONS = new Set([SDD_PLAN_ACTIONS.CREATE, SDD_PLAN_ACTIONS.UPDA
 
 export async function applySddConfigure({
   requestedAgentIds = null, detectedAgentIds = [], homeDir, packageRoot, persona = "off",
-  personaAgentIds = [], trackedFiles = {}, preservePersona = false, dryRun = false, yes = false,
+  personaAgentIds = [], trackedFiles = {}, adoptedFiles = {}, overwriteConflicts = false,
+  preservePersona = false, dryRun = false, yes = false,
   json = false, interactive = null, receiptId = null, plan = planSddConfigure,
   confirm = promptApplyConfirmation, saveReceipt = saveSddReceipt,
   now = () => new Date().toISOString()
@@ -28,14 +29,16 @@ export async function applySddConfigure({
 
   const planned = await plan({
     requestedAgentIds, detectedAgentIds, homeDir, packageRoot, persona, personaAgentIds,
-    trackedFiles, preservePersona, dryRun: true
+    trackedFiles, adoptedFiles, overwriteConflicts, preservePersona, dryRun: true
   });
   if (dryRun) return { ...planned, applied: false, cancelled: false, receipt: null };
 
   if (shouldPromptApplyConfirmation({ applying: true, dryRun, json, confirm: yes, interactive })) {
     const accepted = await confirm({
       command: "components configure sdd-core",
-      question: "Materialize SDD skills for the planned agents? [Y/n]: "
+      question: overwriteConflicts
+        ? "Overwrite conflicting SDD skills with canonical Kairo copies (backups first)? [Y/n]: "
+        : "Materialize SDD skills for the planned agents? [Y/n]: "
     });
     if (!accepted) return { ...planned, applied: false, cancelled: true, receipt: null };
   }
@@ -66,7 +69,8 @@ export async function applySddConfigure({
     try {
       const managedRoot = resolveSddSkillRoot(action.agentIds[0], homeDir);
       const outcome = await materializeOne(action, {
-        homeDir, packageRoot, managedRoot, receiptId: resolvedReceiptId
+        homeDir, packageRoot, managedRoot, receiptId: resolvedReceiptId,
+        overwriteConflicts: Boolean(action.overwrote || overwriteConflicts)
       });
       if (outcome.conflict) {
         files.push({
@@ -78,7 +82,8 @@ export async function applySddConfigure({
       if (outcome.backup) backups.push(outcome.backup);
       files.push({
         ...record, applied: true, skipped: false, outcome: SDD_FILE_OUTCOMES.APPLIED,
-        afterHash: outcome.afterHash, parentRealpath: outcome.parentRealpath
+        afterHash: outcome.afterHash, parentRealpath: outcome.parentRealpath,
+        overwrote: Boolean(action.overwrote)
       });
     } catch (error) {
       failed = { skillId: action.skillId, destinationPath: action.destinationPath, error: error.message };
@@ -141,7 +146,9 @@ async function readCanonicalBytes(action, packageRoot) {
   ));
 }
 
-async function materializeOne(action, { homeDir, packageRoot, managedRoot, receiptId }) {
+async function materializeOne(action, {
+  homeDir, packageRoot, managedRoot, receiptId, overwriteConflicts = false
+}) {
   const chain = await assertSafePathChain(action.destinationPath, managedRoot, homeDir);
   if (!chain.ok) return { conflict: chain.reason };
 
@@ -169,7 +176,10 @@ async function materializeOne(action, { homeDir, packageRoot, managedRoot, recei
     return { conflict: "Managed destination disappeared after planning; preserving byte-for-byte." };
   }
   const snap = await snapshotRegularFile(action.destinationPath);
-  if (snap.hash !== action.trackedHash) {
+  const expectedHash = overwriteConflicts || action.overwrote
+    ? snap.hash
+    : action.trackedHash;
+  if (snap.hash !== expectedHash) {
     return { conflict: "Managed file changed after planning; preserving byte-for-byte." };
   }
   const parent = await parentRealpath(action.destinationPath);

package/src/global/integrations/sdd-evidence.js

@@ -16,6 +16,7 @@ export const SDD_FILE_OUTCOMES = Object.freeze({
 
 export const SDD_HEALTH = Object.freeze({
   CONFIGURED: "configured",
+  ADOPTED: "adopted",
   MISSING: "missing",
   DRIFTED: "drifted",
   CONFLICT: "conflict"
@@ -23,13 +24,16 @@ export const SDD_HEALTH = Object.freeze({
 
 /**
  * Classify one destination file against canonical bytes and optional tracked hash.
- * Untracked or user-modified files are conflicts and must never be overwritten.
+ * Untracked or user-modified files are conflicts and must never be overwritten
+ * unless overwriteConflicts is requested at apply time.
+ * adoptedHash (disk content accepted as-is) yields NOOP without claiming managed.
  */
 export function classifySddSkillFile({
   exists,
   canonicalHash,
   diskHash = null,
-  trackedHash = null
+  trackedHash = null,
+  adoptedHash = null
 } = {}) {
   if (!exists) {
     return {
@@ -38,6 +42,13 @@ export function classifySddSkillFile({
     };
   }
 
+  if (adoptedHash != null && adoptedHash === diskHash) {
+    return {
+      action: SDD_PLAN_ACTIONS.NOOP,
+      reason: "Adopted disk bytes; preserving byte-for-byte."
+    };
+  }
+
   if (trackedHash == null) {
     return {
       action: SDD_PLAN_ACTIONS.CONFLICT,
@@ -70,11 +81,19 @@ export function classifySddVerifyHealth({
   exists,
   canonicalHash,
   diskHash = null,
-  trackedHash = null
+  trackedHash = null,
+  adoptedHash = null
 } = {}) {
   if (!exists) {
     return { status: SDD_HEALTH.MISSING, drift: null, reason: "Destination missing on disk." };
   }
+  if (adoptedHash != null && adoptedHash === diskHash) {
+    return {
+      status: SDD_HEALTH.ADOPTED,
+      drift: null,
+      reason: "Disk matches adopted hash (not Kairo-managed)."
+    };
+  }
   if (trackedHash == null) {
     return { status: SDD_HEALTH.CONFLICT, drift: null, reason: "Pre-existing untracked file." };
   }

package/src/global/integrations/sdd-plan.js

@@ -25,6 +25,8 @@ export async function planSddConfigure({
   persona = "off",
   personaAgentIds = [],
   trackedFiles = {},
+  adoptedFiles = {},
+  overwriteConflicts = false,
   preservePersona = false,
   dryRun = true,
   exists = existsSync,
@@ -50,16 +52,31 @@ export async function planSddConfigure({
       for (const group of destinationGroups) {
         const destinationPath = join(group.root, skillId, ...file.relativePath.split("/"));
         const trackedHash = trackedFiles[destinationPath] ?? null;
+        const adoptedHash = adoptedFiles[destinationPath] ?? null;
         const fileExists = exists(destinationPath);
         const diskHash = fileExists ? hashBuffer(await readFileImpl(destinationPath)) : null;
-        const classification = classifySddSkillFile({
-          exists: fileExists, canonicalHash, diskHash, trackedHash
+        let classification = classifySddSkillFile({
+          exists: fileExists, canonicalHash, diskHash, trackedHash, adoptedHash
         });
+        let overwrote = false;
+        if (
+          overwriteConflicts
+          && classification.action === SDD_PLAN_ACTIONS.CONFLICT
+          && fileExists
+        ) {
+          classification = {
+            action: SDD_PLAN_ACTIONS.UPDATE,
+            reason: "Overwrite conflicts requested; backup then replace with canonical."
+          };
+          overwrote = true;
+        }
         actions.push({
           skillId, relativePath: file.relativePath, destinationPath,
           agentIds: [...group.agentIds], kind: group.kind,
           action: classification.action, reason: classification.reason,
-          canonicalHash, skillHash, diskHash, trackedHash, writes: false, executes: false
+          canonicalHash, skillHash, diskHash, trackedHash, adoptedHash,
+          overwrote, overwriteConflicts: Boolean(overwriteConflicts),
+          writes: false, executes: false
         });
       }
     }
@@ -78,6 +95,7 @@ export async function planSddConfigure({
   return {
     provider: "sdd-core", componentId: "sdd-core", dryRun: Boolean(dryRun),
     executes: false, writes: false, requestedPersona: persona, preservePersona,
+    overwriteConflicts: Boolean(overwriteConflicts),
     persona: personaTransition.persona,
     personaPath: resolveCanonicalTeachingPersonaPath(packageRoot),
     personaActive: personaTransition.after.length > 0, personaTransition, agentIds, actions,

package/src/global/integrations/sdd-resolutions.js

@@ -0,0 +1,73 @@
+import { formatCliCommand } from "../brand/cli.js";
+import { resolution, RESOLUTION_KIND, RESOLUTION_SAFETY } from "../check-resolutions.js";
+import { SDD_HEALTH } from "./sdd-evidence.js";
+
+/**
+ * Build panel/CLI resolution buttons for sdd-core:skills from verify findings.
+ * Agent list is derived from conflict/drifted findings so buttons scope correctly.
+ */
+export function buildSddSkillResolutions(verification = {}) {
+  const summary = verification.summary ?? {};
+  const conflictCount = summary.conflict ?? 0;
+  const driftedCount = summary.drifted ?? 0;
+  if (conflictCount === 0 && driftedCount === 0) return [];
+
+  const agentIds = conflictAgentIds(verification.findings ?? []);
+  const agentsFlag = agentIds.length ? ` --agents ${agentIds.join(",")}` : "";
+
+  return [
+    resolution(
+      "sdd-diff",
+      "Ver diff",
+      formatCliCommand(`components diff sdd-core${agentsFlag}`),
+      {
+        kind: RESOLUTION_KIND.RUN,
+        safety: RESOLUTION_SAFETY.READ_ONLY,
+        detail: "Read-only: canonical Kairo skills vs disk."
+      }
+    ),
+    resolution(
+      "sdd-adopt",
+      "Conservar el mío",
+      formatCliCommand(`components adopt sdd-core${agentsFlag} --yes`),
+      {
+        kind: RESOLUTION_KIND.CONFIGURE,
+        safety: RESOLUTION_SAFETY.CONSENT,
+        detail: "Adopt disk bytes into Kairo state without overwriting files. Button click is consent."
+      }
+    ),
+    resolution(
+      "sdd-overwrite",
+      "Usar versión Kairo",
+      formatCliCommand(`components configure sdd-core${agentsFlag} --overwrite-conflicts --yes`),
+      {
+        kind: RESOLUTION_KIND.CONFIGURE,
+        safety: RESOLUTION_SAFETY.DESTRUCTIVE,
+        detail: "Backup then replace conflicting files with canonical Kairo skills."
+      }
+    ),
+    resolution(
+      "doctor",
+      "Doctor",
+      formatCliCommand("doctor"),
+      { kind: RESOLUTION_KIND.RUN, safety: RESOLUTION_SAFETY.READ_ONLY }
+    ),
+    resolution(
+      "refresh",
+      "Refresh",
+      null,
+      { kind: RESOLUTION_KIND.REFRESH, safety: RESOLUTION_SAFETY.READ_ONLY }
+    )
+  ];
+}
+
+function conflictAgentIds(findings) {
+  const ids = new Set();
+  for (const finding of findings) {
+    if (finding?.status !== SDD_HEALTH.CONFLICT && finding?.status !== SDD_HEALTH.DRIFTED) {
+      continue;
+    }
+    for (const id of finding.agentIds ?? []) ids.add(id);
+  }
+  return [...ids].sort();
+}