@kal-elsam/kairo-runtime 0.18.0 → 0.19.0

package/CHANGELOG.md

@@ -5,6 +5,27 @@ Historical entries below may reference the legacy `@kal-elsam/harness` package n
 
 ## Unreleased
 
+## 0.19.0 — 2026-09-18 (Kairo Runtime)
+
+Patch-level polish on top of 0.18.0's PROJECT TEAM work: fixes the
+provider column's alignment and adds a way back to the interactive
+analyst picker once a strategy already exists.
+
+### Added
+
+- `r` key inside the `/project` overlay (RESULT/ACTIVE/STALE states)
+  forces a genuinely fresh analysis, landing back on the real
+  interactive analyst picker — previously only reachable on a
+  project's very first `/project` run.
+
+### Fixed
+
+- The PROJECT TEAM view's provider column (`CockpitView.teamRoleLabel()`)
+  now pads every row's model name to a shared width
+  (`teamModelColumnWidth()`), so the " · Provider" separator lines up
+  across rows regardless of how much individual model names vary in
+  length.
+
 ## 0.18.0 — 2026-09-18 (Kairo Runtime)
 
 Minor release. Provider visibility and quota-aware improvements to the

package/package.json

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

package/src/global/cockpit/project-overlay.js

@@ -40,14 +40,15 @@ const overlayFrameTheme = {
   fg: (role, text) => theme.fg(role === "border" ? "info" : role, text)
 };
 
-function teamLines(label, team, aiTeamLabel, tone = "bold") {
+function teamLines(label, team, view, tone = "bold") {
   const lines = [tone === "bold" ? theme.bold(label) : theme.fg("muted", label)];
   if (!team?.length) {
     lines.push(theme.fg("muted", "  (no active roles)"));
     return lines;
   }
+  const modelColumnWidth = view.teamModelColumnWidth(team.map((entry) => entry.model));
   for (const entry of team) {
-    const modelText = entry.model ? aiTeamLabel(entry.model) : theme.fg("warning", "no eligible option");
+    const modelText = entry.model ? view.teamRoleLabel(entry.model, modelColumnWidth) : theme.fg("warning", "no eligible option");
     lines.push(theme.fg("muted", `  ${entry.role.padEnd(10)} ${modelText}`));
   }
   return lines;
@@ -174,6 +175,23 @@ export class ProjectOverlay {
     this.requestRender();
   }
 
+  /**
+   * Forces a genuinely fresh analysis — the ONLY way back to the real
+   * interactive analyst-picker (SELECT_ANALYST) once a SUGGESTED/ACTIVE/
+   * STALE strategy already exists (the constructor's own existing-strategy
+   * shortcut otherwise always wins). Discards the held suggested/active
+   * strategy in memory only — nothing persisted is touched until a new
+   * choice is confirmed and a new /project approve happens; the previous
+   * real strategy stays exactly as persisted if the human backs out
+   * (Esc from SELECT_ANALYST) before confirming anything.
+   */
+  reanalyze() {
+    this.suggestedStrategy = null;
+    this.activeStrategy = null;
+    this.resultSelectList = null;
+    void this.loadPreflight();
+  }
+
   /** A short, honest label for a catalog entry's own real recommendationTags/evidenceStatus — never a fabricated "Quality"/"Efficient" claim for a model that doesn't actually carry that tag. */
   static tagLabel(model) {
     if (model.evidenceStatus === "unscored") return "Unscored";
@@ -269,8 +287,9 @@ export class ProjectOverlay {
    */
   buildResultRoleList() {
     const team = this.suggestedStrategy?.projectTeam ?? [];
+    const modelColumnWidth = this.view.teamModelColumnWidth(team.map((entry) => entry.model));
     const items = team.map((entry) => {
-      const modelText = entry.model ? this.view.teamRoleLabel(entry.model) : "no eligible option";
+      const modelText = entry.model ? this.view.teamRoleLabel(entry.model, modelColumnWidth) : "no eligible option";
       const overrideNote = entry.assignmentSource === "override" ? theme.fg("accent", " (override)") : "";
       // Role + model are the real primary information here — explicit
       // `text` color, never left to default/muted.
@@ -458,11 +477,19 @@ export class ProjectOverlay {
       // edits the highlighted role instead. Enter must never silently
       // approve just because a role row happens to be focused.
       if (data === "a" || data === "A") return void this.approve();
+      // "r" forces a genuinely fresh analysis (re-picks the analyst from
+      // scratch) — distinct from editing one role's model (Enter) or
+      // approving the current suggestion (a) — see reanalyze()'s own doc.
+      if (data === "r" || data === "R") return void this.reanalyze();
       this.resultSelectList.handleInput(data);
       this.requestRender();
       return;
     }
 
+    if ((this.state === S.ACTIVE || this.state === S.STALE) && (data === "r" || data === "R")) {
+      return void this.reanalyze();
+    }
+
     if (this.state === S.EDIT_MODEL_SEARCH) {
       if (matchesKey(data, Key.escape) || matchesKey(data, Key.esc)) {
         this.state = S.RESULT;
@@ -533,7 +560,6 @@ export class ProjectOverlay {
     // isn't a modal boundary a human eye reliably notices.
     const box = new Box(2, 1);
     this.box = box;
-    const aiTeamLabel = (model) => this.view.teamRoleLabel(model);
     // Text defaults to one blank row above and below every child; inside
     // a framed modal that inflated the height until pi-tui clipped the
     // bottom border. Keep spacing explicit and compact instead.
@@ -594,9 +620,9 @@ export class ProjectOverlay {
         // Quality/Efficient stay real, comparative REFERENCE — muted, and
         // rendered strictly below the real operational PROJECT TEAM list
         // above, never replacing it visually.
-        for (const line of teamLines("Quality (reference)", strategy.qualityTeam, aiTeamLabel, "muted")) push(line);
-        for (const line of teamLines("Efficient (reference)", strategy.efficientTeam, aiTeamLabel, "muted")) push(line);
-        push(theme.fg("muted", "Enter edit role · a approve & activate · Esc close without approving"));
+        for (const line of teamLines("Quality (reference)", strategy.qualityTeam, this.view, "muted")) push(line);
+        for (const line of teamLines("Efficient (reference)", strategy.efficientTeam, this.view, "muted")) push(line);
+        push(theme.fg("muted", "Enter edit role · a approve & activate · r re-analyze from scratch · Esc close without approving"));
         break;
       }
       case S.EDIT_LOADING:
@@ -645,16 +671,16 @@ export class ProjectOverlay {
         const strategy = this.activeStrategy;
         push(theme.fg("success", "ACTIVE"));
         push(theme.fg("muted", `Approved ${strategy.approvedAt ?? "?"}`));
-        for (const line of teamLines("PROJECT TEAM", strategy.projectTeam ?? strategy.qualityTeam, aiTeamLabel)) push(line);
-        push(theme.fg("muted", "Esc close"));
+        for (const line of teamLines("PROJECT TEAM", strategy.projectTeam ?? strategy.qualityTeam, this.view)) push(line);
+        push(theme.fg("muted", "r re-analyze from scratch · Esc close"));
         break;
       }
       case S.STALE: {
         const strategy = this.activeStrategy;
         push(theme.fg("warning", "STALE"));
         push(theme.fg("muted", "The real project evidence has changed since this team was approved — previous assignments are kept until refreshed."));
-        for (const line of teamLines("PROJECT TEAM (previous)", strategy.projectTeam ?? strategy.qualityTeam, aiTeamLabel)) push(line);
-        push(theme.fg("muted", "Enter refresh · Esc close"));
+        for (const line of teamLines("PROJECT TEAM (previous)", strategy.projectTeam ?? strategy.qualityTeam, this.view)) push(line);
+        push(theme.fg("muted", "Enter refresh · r re-analyze from scratch · Esc close"));
         break;
       }
       case S.ERROR:

package/src/global/cockpit/view.js

@@ -576,8 +576,12 @@ export class CockpitView {
       };
     }
     const lines = [];
-    if (strategy.bootstrapAnalyst) lines.push(`${"Project Analyst".padEnd(18)} ${this.teamRoleLabel(strategy.bootstrapAnalyst)}`);
-    if (strategy.orchestrator) lines.push(`${"Orchestrator".padEnd(18)} ${this.teamRoleLabel(strategy.orchestrator)}`);
+    const projectTeam = strategy.projectTeam ?? strategy.qualityTeam ?? [];
+    const modelColumnWidth = this.teamModelColumnWidth([
+      strategy.bootstrapAnalyst, strategy.orchestrator, ...projectTeam.map((entry) => entry.model)
+    ]);
+    if (strategy.bootstrapAnalyst) lines.push(`${"Project Analyst".padEnd(18)} ${this.teamRoleLabel(strategy.bootstrapAnalyst, modelColumnWidth)}`);
+    if (strategy.orchestrator) lines.push(`${"Orchestrator".padEnd(18)} ${this.teamRoleLabel(strategy.orchestrator, modelColumnWidth)}`);
     // The real OPERATIONAL team (see buildProjectStrategy's own doc) —
     // never qualityTeam, which is comparative reference only. The overlay
     // (project-overlay.js) already shows projectTeam under this exact
@@ -585,8 +589,8 @@ export class CockpitView {
     // same label was the real, reported mismatch. qualityTeam only
     // remains as a fallback for a strategy persisted before projectTeam
     // existed (see applyProjectTeamOverride's own legacy-entry comment).
-    for (const entry of strategy.projectTeam ?? strategy.qualityTeam ?? []) {
-      lines.push(`${entry.role.padEnd(18)} ${entry.model ? this.teamRoleLabel(entry.model) : theme.fg("warning", "no eligible option")}`);
+    for (const entry of projectTeam) {
+      lines.push(`${entry.role.padEnd(18)} ${entry.model ? this.teamRoleLabel(entry.model, modelColumnWidth) : theme.fg("warning", "no eligible option")}`);
     }
     if (strategy.status === "suggested") lines.push(theme.fg("muted", "Suggested from real project analysis. Use /project approve to activate."));
     if (strategy.status === "stale") lines.push(theme.fg("warning", "Real evidence changed since approval — use /project refresh."));
@@ -764,10 +768,29 @@ export class CockpitView {
    * actually run against — two roles can land on visually similar model
    * names from different providers, and knowing which subscription a role
    * draws from is exactly what a real, provider-aware team review needs.
+   *
+   * `modelColumnWidth` left-pads the model name so every row's " · Provider"
+   * lines up in its own column instead of drifting with each model name's
+   * own length — see `CockpitView.teamModelColumnWidth()`, which a caller
+   * computes once across the real rows it's about to render and passes
+   * here for every row in that same list.
+   * @param {object} model
+   * @param {number} [modelColumnWidth]
    */
-  teamRoleLabel(model) {
+  teamRoleLabel(model, modelColumnWidth = 0) {
     const provider = model.adapterId.charAt(0).toUpperCase() + model.adapterId.slice(1);
-    return `${this.aiTeamLabel(model)}  ·  ${provider}`;
+    return `${this.aiTeamLabel(model).padEnd(modelColumnWidth)}  ·  ${provider}`;
+  }
+
+  /**
+   * The real model-name column width for a set of rows about to be
+   * rendered with `teamRoleLabel()` — the longest real, cleaned model
+   * name among them, never a fixed guess (model names vary wildly in
+   * length, e.g. "GPT-5.6-Terra" vs "Muse Spark 1.3 1M Extra High").
+   * @param {Array<object|null|undefined>} models
+   */
+  teamModelColumnWidth(models) {
+    return models.reduce((max, model) => (model ? Math.max(max, this.aiTeamLabel(model).length) : max), 0);
   }
 
   /**

package/src/global/observability/codex-models.js

@@ -89,7 +89,7 @@ export async function readCodexModels({
     child.once?.("close", () => { if (!finished) finish(unknown("codex app-server closed before model list")); });
 
     writeRequest(child, 1, "initialize", {
-      clientInfo: { name: "kairo", title: "Kairo", version: "0.18.0" },
+      clientInfo: { name: "kairo", title: "Kairo", version: "0.19.0" },
       capabilities: {}
     });
   });

package/src/global/observability/codex-usage.js

@@ -151,7 +151,7 @@ export async function readCodexUsage({
     child.once?.("close", () => { if (!finished) finish(unknown("codex app-server closed before rate limits")); });
 
     writeRequest(child, 1, "initialize", {
-      clientInfo: { name: "kairo", title: "Kairo", version: "0.18.0" },
+      clientInfo: { name: "kairo", title: "Kairo", version: "0.19.0" },
       capabilities: {}
     });
   });