@kal-elsam/kairo-runtime 0.4.0 → 0.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kal-elsam/kairo-runtime",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Kairo Runtime — local agent operating system for Codex, Cursor, Claude, Gemini, Copilot, Engram, and Graphify.",
   "type": "module",
   "homepage": "https://github.com/Kal-elSam/harness#readme",

package/scripts/cockpit-smoke.mjs

@@ -25,7 +25,7 @@ const root = join(dirname(fileURLToPath(import.meta.url)), "..");
 const require = createRequire(import.meta.url);
 const pkg = require(join(root, "package.json"));
 
-assert.equal(pkg.version, "0.4.0");
+assert.equal(pkg.version, "0.4.1");
 assert.ok(pkg.dependencies["ansi-escapes"]);
 
 assert.equal(resolveLayoutMode({ columns: 120, rows: 40 }), LAYOUT_MODES.WIDE);

package/src/global/dashboard-guidance.js

@@ -71,7 +71,7 @@ export function resolveProjectReadiness({
   const intelConfigured = hasIntelligenceConfigured(diagnostics);
   const summaryLine = `${agentsReady} agents ready · ${detected} detected · ${activeRuns} active runs`;
 
-  if (!hasGlobalState || detected === 0) {
+  if (!hasGlobalState || (launchableCount === 0 && detected === 0)) {
     return {
       kind: READINESS_KINDS.NEEDS_SETUP,
       label: READINESS_LABELS[READINESS_KINDS.NEEDS_SETUP],
@@ -126,9 +126,9 @@ export function resolveProjectReadiness({
 
 /**
  * Contextual next step from existing diagnostics + dashboard snapshot.
- * Priority: configure → review when blocked → launch when launchable →
- * enable intelligence → review.
- * Launchable agents win over missing optional intelligence.
+ * Priority: configure without state → launch when launchable → configure when
+ * nothing detected → review when blocked → enable intelligence → review.
+ * Launchable agents win over missing optional intelligence and empty detected counts.
  */
 export function resolveDashboardRecommendation({
   hasGlobalState = false,
@@ -140,7 +140,7 @@ export function resolveDashboardRecommendation({
   const launchableCount = countLaunchableAgents(dashboard);
   const blocked = hasBlockingDiagnostics(diagnostics);
 
-  if (!hasGlobalState || (summary.detected ?? 0) === 0) {
+  if (!hasGlobalState) {
     return {
       kind: NEXT_STEP_KINDS.CONFIGURE,
       title: "Finish local setup",
@@ -151,17 +151,6 @@ export function resolveDashboardRecommendation({
     };
   }
 
-  if (blocked && launchableCount === 0) {
-    return {
-      kind: NEXT_STEP_KINDS.REVIEW,
-      title: "Review system health",
-      message: "Review System health for problems before launching a run.",
-      detail: "Fix agent or configuration issues, then try again.",
-      targetView: RECOMMENDATION_TARGETS.DIAGNOSTICS,
-      targetAction: null
-    };
-  }
-
   if (launchableCount > 0) {
     return {
       kind: NEXT_STEP_KINDS.LAUNCH,
@@ -173,6 +162,28 @@ export function resolveDashboardRecommendation({
     };
   }
 
+  if ((summary.detected ?? 0) === 0) {
+    return {
+      kind: NEXT_STEP_KINDS.CONFIGURE,
+      title: "Finish local setup",
+      message: `Configure the local environment with ${formatCliCommand("setup")}.`,
+      detail: "Open System health to review what Kairo detected.",
+      targetView: RECOMMENDATION_TARGETS.DIAGNOSTICS,
+      targetAction: null
+    };
+  }
+
+  if (blocked && launchableCount === 0) {
+    return {
+      kind: NEXT_STEP_KINDS.REVIEW,
+      title: "Review system health",
+      message: "Review System health for problems before launching a run.",
+      detail: "Fix agent or configuration issues, then try again.",
+      targetView: RECOMMENDATION_TARGETS.DIAGNOSTICS,
+      targetAction: null
+    };
+  }
+
   if (!intelligence?.localAvailable && !intelligence?.cloudAuthenticated) {
     return {
       kind: NEXT_STEP_KINDS.ENABLE_INTELLIGENCE,