@pellux/goodvibes-tui 2.0.21 → 2.1.1

package/src/{panels → views}/polish.ts

@@ -4,10 +4,10 @@ import { getDisplayWidth, wrapText } from '../utils/terminal-width.ts';
 import { getSurfaceContentRows, getTrackedVisibleWindow, getVisibleWindow, type VisibleWindow } from '../renderer/surface-layout.ts';
 import { GLYPHS } from '../renderer/ui-primitives.ts';
 import { type StatusState, STATE_GLYPHS } from '../renderer/status-glyphs.ts';
-import { buildPanelLine, buildStyledPanelLine, DEFAULT_PANEL_PALETTE } from './polish-core.ts';
-import type { PanelPalette, StyledPanelSegment } from './polish-core.ts';
+import { buildViewLine, buildStyledViewLine, DEFAULT_VIEW_PALETTE } from './polish-core.ts';
+import type { ViewPalette, StyledViewSegment } from './polish-core.ts';
 
-// The panel formatting toolkit is split across three modules to stay under the
+// The view formatting toolkit is split across three modules to stay under the
 // architecture line-count cap; every symbol remains importable from './polish.ts':
 //   - ./polish-core.ts    palette + base line primitives (leaf)
 //   - ./polish-tables.ts  table / tree / badge / aligned-row primitives
@@ -32,9 +32,9 @@ export function buildGuidanceLine(
   width: number,
   command: string,
   summary: string,
-  palette: PanelPalette,
+  palette: ViewPalette,
 ): Line {
-  return buildPanelLine(width, [
+  return buildViewLine(width, [
     [` ${GLYPHS.status.info} `, palette.info],
     [command, palette.info],
     ['  - ', palette.dim],
@@ -42,13 +42,14 @@ export function buildGuidanceLine(
   ]);
 }
 
-export function buildPanelTitle(
+export function buildViewTitle(
   width: number,
   title: string,
-  palette: PanelPalette,
+  palette: ViewPalette,
 ): Line {
-  const titleText = fitDisplayText(` ${title}`, width);
-  return buildStyledPanelLine(width, [
+  // Two columns between the fill edge and the title (the Measurements padding rule).
+  const titleText = fitDisplayText(`  ${title}`, width);
+  return buildStyledViewLine(width, [
     { text: titleText, fg: palette.header ?? palette.accent ?? palette.value, bg: palette.headerBg, bold: true },
   ], { fillBg: palette.headerBg });
 }
@@ -56,21 +57,21 @@ export function buildPanelTitle(
 export function buildBodyText(
   width: number,
   text: string,
-  palette: PanelPalette,
+  palette: ViewPalette,
   fg: string = palette.value,
 ): Line[] {
   const wrapped = wrapText(text, Math.max(10, width - 2));
-  return wrapped.map((line) => buildStyledPanelLine(width, [{ text: ` ${line}`, fg, bg: palette.surfaceBg }], { fillBg: palette.surfaceBg }));
+  return wrapped.map((line) => buildStyledViewLine(width, [{ text: ` ${line}`, fg, bg: palette.surfaceBg }], { fillBg: palette.surfaceBg }));
 }
 
 export function buildSectionHeader(
   width: number,
   title: string,
-  palette: PanelPalette,
+  palette: ViewPalette,
 ): Line {
   const prefix = `${GLYPHS.status.dualPane} ${title}`;
   const divider = GLYPHS.frame.horizontal.repeat(Math.max(0, width - getDisplayWidth(prefix) - 2));
-  return buildStyledPanelLine(width, [
+  return buildStyledViewLine(width, [
     { text: ' ', fg: palette.label, bg: palette.sectionBg },
     { text: prefix, fg: palette.label, bg: palette.sectionBg, bold: true },
     { text: ' ', fg: palette.dim, bg: palette.sectionBg },
@@ -81,7 +82,7 @@ export function buildSectionHeader(
 export function buildKeyValueLine(
   width: number,
   entries: ReadonlyArray<{ label: string; value: string; valueColor?: string }>,
-  palette: PanelPalette,
+  palette: ViewPalette,
 ): Line {
   const segments: Array<[string, string, string?]> = [];
   for (const entry of entries) {
@@ -90,16 +91,16 @@ export function buildKeyValueLine(
     segments.push([entry.value, entry.valueColor ?? palette.value]);
     segments.push(['  ', palette.dim]);
   }
-  return buildStyledPanelLine(width, segments.map(([text, fg, bg]) => ({ text, fg, bg: bg ?? palette.summaryBg })), { fillBg: palette.summaryBg });
+  return buildStyledViewLine(width, segments.map(([text, fg, bg]) => ({ text, fg, bg: bg ?? palette.summaryBg })), { fillBg: palette.summaryBg });
 }
 
 export function buildShortcutLine(
   width: number,
   keys: string,
   summary: string,
-  palette: PanelPalette,
+  palette: ViewPalette,
 ): Line {
-  return buildPanelLine(width, [
+  return buildViewLine(width, [
     ['  ', palette.label],
     [keys, palette.info],
     ['  ', palette.dim],
@@ -107,10 +108,10 @@ export function buildShortcutLine(
   ]);
 }
 
-export function buildPanelListRow(
+export function buildViewListRow(
   width: number,
-  segments: ReadonlyArray<StyledPanelSegment>,
-  palette: PanelPalette,
+  segments: ReadonlyArray<StyledViewSegment>,
+  palette: ViewPalette,
   options: {
     readonly selected?: boolean;
     readonly selectedBg?: string;
@@ -124,7 +125,7 @@ export function buildPanelListRow(
   const fillBg = selected ? selectedBg : options.fillBg;
   const marker = selected ? `${options.marker ?? GLYPHS.navigation.selected} ` : '  ';
   const markerFg = selected ? (options.markerColor ?? palette.info) : palette.dim;
-  return buildStyledPanelLine(width, [
+  return buildStyledViewLine(width, [
     { text: marker, fg: markerFg, bg: fillBg, bold: selected },
     ...segments.map((segment) => ({
       ...segment,
@@ -137,7 +138,7 @@ export function buildSearchInputLine(
   width: number,
   label: string,
   value: string,
-  palette: PanelPalette,
+  palette: ViewPalette,
   options: { active?: boolean; bg?: string; emptyLabel?: string; valueColor?: string } = {},
 ): Line {
   const active = options.active ?? false;
@@ -152,33 +153,38 @@ export function buildSearchInputLine(
     : hasValue
       ? options.valueColor ?? palette.value
       : palette.dim;
-  return buildStyledPanelLine(width, [
-    { text: ' ', fg: palette.label, bg },
+  // Two columns of padding on both sides of the fill; a long draft keeps its
+  // end (where the cursor is) in view.
+  const room = Math.max(1, width - 4 - getDisplayWidth(label));
+  let shown = content;
+  while (shown.length > 0 && getDisplayWidth(shown) > room) shown = shown.slice(1);
+  return buildStyledViewLine(width, [
+    { text: '  ', fg: palette.label, bg },
     { text: `${label}`, fg: palette.label, bg },
-    { text: content, fg, bg, bold: active },
+    { text: shown, fg, bg, bold: active },
   ], { fillBg: bg });
 }
 
 /**
- * Build a status pill segment (glyph + label) for use in buildPanelLine.
+ * Build a status pill segment (glyph + label) for use in buildViewLine.
  *
- * Returns StyledPanelSegment[], spread directly into a buildPanelLine segments
+ * Returns StyledViewSegment[], spread directly into a buildViewLine segments
  * array:
- *   buildPanelLine(width, [['  count ', C.label], ...buildStatusPill('bad', '3')])
+ *   buildViewLine(width, [['  count ', C.label], ...buildStatusPill('bad', '3')])
  *
  * Convention: raw hex colors may only live inside a palette constant declared at
- * the top of a panel file; buildStatusPill derives its color from the palette.
+ * the top of a view file; buildStatusPill derives its color from the palette.
  */
 export function buildStatusPill(
   state: StatusState,
   label: string,
   opts?: { glyph?: string; bg?: string; count?: number },
-): StyledPanelSegment[] {
+): StyledViewSegment[] {
   const glyph = opts?.glyph ?? STATE_GLYPHS[state];
-  const color = state === 'good' ? DEFAULT_PANEL_PALETTE.good
-    : state === 'warn' ? DEFAULT_PANEL_PALETTE.warn
-    : state === 'bad'  ? DEFAULT_PANEL_PALETTE.bad
-    : DEFAULT_PANEL_PALETTE.info;
+  const color = state === 'good' ? DEFAULT_VIEW_PALETTE.good
+    : state === 'warn' ? DEFAULT_VIEW_PALETTE.warn
+    : state === 'bad'  ? DEFAULT_VIEW_PALETTE.bad
+    : DEFAULT_VIEW_PALETTE.info;
   const bg = opts?.bg;
   const text = opts?.count !== undefined ? `${glyph} ${label} (${opts.count})` : `${glyph} ${label}`;
   return [{ text, fg: color, bg }];
@@ -213,7 +219,7 @@ export function buildMeterLine(
   const normalizedFilledChar = options.filledChar ?? GLYPHS.meter.filled;
   const barWidth = Math.max(1, total);
   const clampedFilled = Math.max(0, Math.min(barWidth, filled));
-  const segments: StyledPanelSegment[] = [{ text: prefix, fg: colors.label ?? colors.filled }];
+  const segments: StyledViewSegment[] = [{ text: prefix, fg: colors.label ?? colors.filled }];
   if (clampedFilled > 0) {
     segments.push({ text: normalizedFilledChar.repeat(clampedFilled), fg: colors.filled });
   }
@@ -221,7 +227,7 @@ export function buildMeterLine(
     segments.push({ text: emptyChar.repeat(barWidth - clampedFilled), fg: colors.empty });
   }
   segments.push({ text: suffix, fg: colors.label ?? colors.filled });
-  return buildStyledPanelLine(width, segments);
+  return buildStyledViewLine(width, segments);
 }
 
 export function buildEmptyState(
@@ -229,13 +235,13 @@ export function buildEmptyState(
   title: string,
   body: string,
   actions: ReadonlyArray<{ command: string; summary: string }>,
-  palette: PanelPalette,
+  palette: ViewPalette,
 ): Line[] {
   const lines: Line[] = [];
-  lines.push(buildPanelLine(width, [[` ${title}`, palette.empty]]));
+  lines.push(buildViewLine(width, [[` ${title}`, palette.empty]]));
   lines.push(...buildBodyText(width, body, palette, palette.dim));
   if (actions.length > 0) {
-    lines.push(buildPanelLine(width, [[' Suggested next steps', palette.label]]));
+    lines.push(buildViewLine(width, [[' Suggested next steps', palette.label]]));
     for (const action of actions) {
       lines.push(buildGuidanceLine(width, action.command, action.summary, palette));
     }
@@ -247,10 +253,10 @@ export function buildSummaryBlock(
   width: number,
   title: string,
   rows: readonly Line[],
-  palette: PanelPalette,
+  palette: ViewPalette,
 ): Line[] {
   const lines: Line[] = [
-    buildStyledPanelLine(width, [
+    buildStyledViewLine(width, [
       { text: ` ${GLYPHS.status.active} ${title}`, fg: palette.header ?? palette.value, bg: palette.summaryBg, bold: true },
     ], { fillBg: palette.summaryBg }),
   ];
@@ -262,10 +268,10 @@ export function buildDetailBlock(
   width: number,
   title: string,
   rows: readonly Line[],
-  palette: PanelPalette,
+  palette: ViewPalette,
 ): Line[] {
   return [
-    buildStyledPanelLine(width, [
+    buildStyledViewLine(width, [
       { text: ` ${GLYPHS.status.review} ${title}`, fg: palette.header ?? palette.value, bg: palette.sectionBg, bold: true },
     ], { fillBg: palette.sectionBg }),
     ...rows.map((row) => row.map((cell) => (
@@ -294,12 +300,12 @@ function fitDisplayText(text: string, width: number): string {
   return out;
 }
 
-export interface PanelWorkspaceSection {
+export interface ViewWorkspaceSection {
   readonly title?: string;
   readonly lines: readonly Line[];
 }
 
-export interface PrimaryScrollablePanelSectionConfig {
+export interface PrimaryScrollableViewSectionConfig {
   readonly title?: string;
   readonly fixedLines?: readonly Line[];
   readonly scrollableLines: readonly Line[];
@@ -313,7 +319,7 @@ export interface PrimaryScrollablePanelSectionConfig {
   };
 }
 
-export interface ScrollablePanelSectionConfig {
+export interface ScrollableViewSectionConfig {
   readonly title?: string;
   readonly fixedLines?: readonly Line[];
   readonly scrollableLines: readonly Line[];
@@ -327,33 +333,33 @@ export interface ScrollablePanelSectionConfig {
   };
 }
 
-export interface StackedScrollablePanelSectionConfig extends ScrollablePanelSectionConfig {
+export interface StackedScrollableViewSectionConfig extends ScrollableViewSectionConfig {
   readonly weight?: number;
 }
 
-export interface PanelWorkspaceConfig {
+export interface ViewWorkspaceConfig {
   readonly title: string;
   readonly intro?: string;
-  readonly sections: readonly PanelWorkspaceSection[];
+  readonly sections: readonly ViewWorkspaceSection[];
   readonly footerLines?: readonly Line[];
-  readonly palette: PanelPalette;
+  readonly palette: ViewPalette;
 }
 
-function getPanelWorkspaceIntroRows(
+function getViewWorkspaceIntroRows(
   width: number,
   intro: string | undefined,
-  palette: PanelPalette,
+  palette: ViewPalette,
 ): number {
   return intro ? buildBodyText(width, intro, palette, palette.dim).length : 0;
 }
 
-export function getPanelWorkspaceContentBudget(
+export function getViewWorkspaceContentBudget(
   width: number,
   height: number,
-  config: Pick<PanelWorkspaceConfig, 'intro' | 'footerLines' | 'palette'>,
+  config: Pick<ViewWorkspaceConfig, 'intro' | 'footerLines' | 'palette'>,
 ): number {
   const footerLines = [...(config.footerLines ?? [])];
-  const chromeRows = 1 + getPanelWorkspaceIntroRows(width, config.intro, config.palette) + footerLines.length;
+  const chromeRows = 1 + getViewWorkspaceIntroRows(width, config.intro, config.palette) + footerLines.length;
   return Math.max(
     1,
     getSurfaceContentRows({
@@ -368,27 +374,27 @@ export function getPanelWorkspaceContentBudget(
   );
 }
 
-export function getPanelWorkspaceSectionRows(section: PanelWorkspaceSection): number {
+export function getViewWorkspaceSectionRows(section: ViewWorkspaceSection): number {
   return (section.title ? 1 : 0) + section.lines.length;
 }
 
-export function getPanelScrollableSectionBudget(
+export function getViewScrollableSectionBudget(
   width: number,
   height: number,
   options: {
     readonly intro?: string;
     readonly footerLines?: readonly Line[];
-    readonly palette: PanelPalette;
-    readonly beforeSections?: readonly PanelWorkspaceSection[];
+    readonly palette: ViewPalette;
+    readonly beforeSections?: readonly ViewWorkspaceSection[];
     readonly currentSectionTitle?: string;
     readonly currentSectionFixedRows?: number;
-    readonly afterSections?: readonly PanelWorkspaceSection[];
+    readonly afterSections?: readonly ViewWorkspaceSection[];
     readonly minRows?: number;
   },
 ): number {
-  const contentBudget = getPanelWorkspaceContentBudget(width, height, options);
-  const beforeRows = (options.beforeSections ?? []).reduce((sum, section) => sum + getPanelWorkspaceSectionRows(section), 0);
-  const afterRows = (options.afterSections ?? []).reduce((sum, section) => sum + getPanelWorkspaceSectionRows(section), 0);
+  const contentBudget = getViewWorkspaceContentBudget(width, height, options);
+  const beforeRows = (options.beforeSections ?? []).reduce((sum, section) => sum + getViewWorkspaceSectionRows(section), 0);
+  const afterRows = (options.afterSections ?? []).reduce((sum, section) => sum + getViewWorkspaceSectionRows(section), 0);
   const currentHeaderRows = options.currentSectionTitle ? 1 : 0;
   const currentFixedRows = Math.max(0, options.currentSectionFixedRows ?? 0);
   return Math.max(options.minRows ?? 1, contentBudget - beforeRows - currentHeaderRows - currentFixedRows - afterRows);
@@ -400,17 +406,17 @@ export function resolvePrimaryScrollableSection(
   options: {
     readonly intro?: string;
     readonly footerLines?: readonly Line[];
-    readonly palette: PanelPalette;
-    readonly beforeSections?: readonly PanelWorkspaceSection[];
-    readonly section: PrimaryScrollablePanelSectionConfig;
-    readonly afterSections?: readonly PanelWorkspaceSection[];
+    readonly palette: ViewPalette;
+    readonly beforeSections?: readonly ViewWorkspaceSection[];
+    readonly section: PrimaryScrollableViewSectionConfig;
+    readonly afterSections?: readonly ViewWorkspaceSection[];
   },
 ): {
-  readonly section: PanelWorkspaceSection;
+  readonly section: ViewWorkspaceSection;
   readonly scrollOffset: number;
   readonly window: VisibleWindow;
 } {
-  return resolveScrollablePanelSection(width, height, {
+  return resolveScrollableViewSection(width, height, {
     intro: options.intro,
     footerLines: options.footerLines,
     palette: options.palette,
@@ -420,24 +426,24 @@ export function resolvePrimaryScrollableSection(
   });
 }
 
-export function resolveScrollablePanelSection(
+export function resolveScrollableViewSection(
   width: number,
   height: number,
   options: {
     readonly intro?: string;
     readonly footerLines?: readonly Line[];
-    readonly palette: PanelPalette;
-    readonly beforeSections?: readonly PanelWorkspaceSection[];
-    readonly section: ScrollablePanelSectionConfig;
-    readonly afterSections?: readonly PanelWorkspaceSection[];
+    readonly palette: ViewPalette;
+    readonly beforeSections?: readonly ViewWorkspaceSection[];
+    readonly section: ScrollableViewSectionConfig;
+    readonly afterSections?: readonly ViewWorkspaceSection[];
   },
 ): {
-  readonly section: PanelWorkspaceSection;
+  readonly section: ViewWorkspaceSection;
   readonly scrollOffset: number;
   readonly window: VisibleWindow;
 } {
   const fixedLines = [...(options.section.fixedLines ?? [])];
-  const budget = getPanelScrollableSectionBudget(width, height, {
+  const budget = getViewScrollableSectionBudget(width, height, {
     intro: options.intro,
     footerLines: options.footerLines,
     palette: options.palette,
@@ -450,7 +456,7 @@ export function resolveScrollablePanelSection(
   // When a window-summary row will render (list longer than the budget can
   // show), it occupies one of the section's rows. Reserve that row up front so
   // the summary is accounted INSIDE the budget; otherwise the appended summary
-  // pushes total output one line past the panel's exact-height contract and the
+  // pushes total output one line past the view's exact-height contract and the
   // tail line (typically the footer's keyboard-hints row) is silently dropped.
   const summaryReserved = options.section.appendWindowSummary
     && options.section.scrollableLines.length > budget
@@ -477,7 +483,7 @@ export function resolveScrollablePanelSection(
   if (options.section.appendWindowSummary && options.section.scrollableLines.length > window.count) {
     const summary = options.section.appendWindowSummary.formatter
       ? options.section.appendWindowSummary.formatter(window)
-      : buildPanelLine(width, [[`  showing ${window.start + 1}-${window.end} of ${window.total}`, options.section.appendWindowSummary.dimColor ?? options.palette.dim]]);
+      : buildViewLine(width, [[`  showing ${window.start + 1}-${window.end} of ${window.total}`, options.section.appendWindowSummary.dimColor ?? options.palette.dim]]);
     lines.push(summary);
   }
   return {
@@ -496,20 +502,20 @@ export function resolveStackedScrollableSections(
   options: {
     readonly intro?: string;
     readonly footerLines?: readonly Line[];
-    readonly palette: PanelPalette;
-    readonly beforeSections?: readonly PanelWorkspaceSection[];
-    readonly sections: readonly StackedScrollablePanelSectionConfig[];
-    readonly afterSections?: readonly PanelWorkspaceSection[];
+    readonly palette: ViewPalette;
+    readonly beforeSections?: readonly ViewWorkspaceSection[];
+    readonly sections: readonly StackedScrollableViewSectionConfig[];
+    readonly afterSections?: readonly ViewWorkspaceSection[];
   },
 ): ReadonlyArray<{
-  readonly section: PanelWorkspaceSection;
+  readonly section: ViewWorkspaceSection;
   readonly scrollOffset: number;
   readonly window: VisibleWindow;
 }> {
   if (options.sections.length === 0) return [];
-  const contentBudget = getPanelWorkspaceContentBudget(width, height, options);
-  const beforeRows = (options.beforeSections ?? []).reduce((sum, section) => sum + getPanelWorkspaceSectionRows(section), 0);
-  const afterRows = (options.afterSections ?? []).reduce((sum, section) => sum + getPanelWorkspaceSectionRows(section), 0);
+  const contentBudget = getViewWorkspaceContentBudget(width, height, options);
+  const beforeRows = (options.beforeSections ?? []).reduce((sum, section) => sum + getViewWorkspaceSectionRows(section), 0);
+  const afterRows = (options.afterSections ?? []).reduce((sum, section) => sum + getViewWorkspaceSectionRows(section), 0);
   const fixedChrome = options.sections.reduce((sum, section) => (
     sum
     + (section.title ? 1 : 0)
@@ -539,7 +545,7 @@ export function resolveStackedScrollableSections(
 
   return options.sections.map((section, index) => {
     const fixedLines = [...(section.fixedLines ?? [])];
-    // Same reservation as resolveScrollablePanelSection: a window-summary row
+    // Same reservation as resolveScrollableViewSection: a window-summary row
     // occupies one of this section's allocated rows, so shrink the visible
     // window rather than overflowing the stack's exact-height budget.
     const budget = budgets[index]!;
@@ -564,7 +570,7 @@ export function resolveStackedScrollableSections(
     if (section.appendWindowSummary && section.scrollableLines.length > window.count) {
       const summary = section.appendWindowSummary.formatter
         ? section.appendWindowSummary.formatter(window)
-        : buildPanelLine(width, [[`  showing ${window.start + 1}-${window.end} of ${window.total}`, section.appendWindowSummary.dimColor ?? options.palette.dim]]);
+        : buildViewLine(width, [[`  showing ${window.start + 1}-${window.end} of ${window.total}`, section.appendWindowSummary.dimColor ?? options.palette.dim]]);
       lines.push(summary);
     }
     return {
@@ -579,13 +585,13 @@ export function resolveStackedScrollableSections(
 }
 
 /**
- * Standardized footer keyboard-hint row so every panel's hints look identical.
+ * Standardized footer keyboard-hint row so every view's hints look identical.
  * Each hint renders as `keys` (info color) + `label` (dim).
  */
 export function buildKeyboardHints(
   width: number,
   hints: ReadonlyArray<{ keys: string; label: string }>,
-  palette: PanelPalette,
+  palette: ViewPalette,
 ): Line {
   const segments: Array<[string, string, string?]> = [];
   hints.forEach((hint, i) => {
@@ -595,21 +601,21 @@ export function buildKeyboardHints(
     segments.push([' ', palette.dim]);
     segments.push([hint.label, palette.dim]);
   });
-  return buildPanelLine(width, segments);
+  return buildViewLine(width, segments);
 }
 
-export function buildPanelWorkspace(
+export function buildViewWorkspace(
   width: number,
   height: number,
-  config: PanelWorkspaceConfig,
+  config: ViewWorkspaceConfig,
 ): Line[] {
   const lines: Line[] = [];
-  lines.push(buildPanelTitle(width, config.title, config.palette));
+  lines.push(buildViewTitle(width, config.title, config.palette));
   if (config.intro) {
     lines.push(...buildBodyText(width, config.intro, config.palette, config.palette.dim));
   }
   const footerLines = [...(config.footerLines ?? [])];
-  const contentBudget = getPanelWorkspaceContentBudget(width, height, config);
+  const contentBudget = getViewWorkspaceContentBudget(width, height, config);
 
   let consumed = 0;
   for (let sectionIndex = 0; sectionIndex < config.sections.length; sectionIndex++) {

package/src/{panels → views}/project-planning-answer-actions.ts

@@ -1,11 +1,11 @@
 import type { ProjectPlanningQuestion } from '@pellux/goodvibes-sdk/platform/knowledge';
 
 // ---------------------------------------------------------------------------
-// Answer-action helpers for the Project Planning panel.
+// Answer-action helpers for the Project Planning view.
 //
-// Extracted from project-planning-panel.ts to keep that module under the
+// Extracted from the project planning view to keep that module under the
 // architecture line-count cap. Leaf module (only the SDK question type);
-// the panel is their public import site.
+// the project planning view is their public import site.
 // ---------------------------------------------------------------------------
 
 export interface PlanningAnswerAction {

package/src/{panels → views}/provider-health-routes.ts

@@ -2,19 +2,19 @@
 // provider-health-routes.ts
 //
 // Single-source auth-route posture for the provider console (merge of
-// the retired accounts panel into provider-health). All route data flows from
+// the retired accounts view into provider-health). All route data flows from
 // ProviderRuntimeInspectionQuery.inspectAll() snapshots; this module only
 // normalizes descriptors (synthesizing them for providers that do not declare
 // routes) and derives the active/preferred route, freshness, issues, and
-// repair hints. It intentionally keeps the full descriptor list so the panel
-// can render per-route detail (absorbed from the accounts panel) instead of a
+// repair hints. It intentionally keeps the full descriptor list so the provider-health modal
+// can render per-route detail (absorbed from the accounts view) instead of a
 // lossy summary record.
 // ---------------------------------------------------------------------------
 
 import type { ProviderAuthRouteDescriptor } from '@pellux/goodvibes-sdk/platform/providers';
 
-export type ProviderPanelAuthRoute = ProviderAuthRouteDescriptor['route'] | 'unconfigured';
-export type ProviderPanelAuthFreshness = NonNullable<ProviderAuthRouteDescriptor['freshness']> | 'unconfigured';
+export type ProviderHealthAuthRoute = ProviderAuthRouteDescriptor['route'] | 'unconfigured';
+export type ProviderHealthAuthFreshness = NonNullable<ProviderAuthRouteDescriptor['freshness']> | 'unconfigured';
 
 /** Auth metadata shape carried by ProviderRuntimeInspectionQuery snapshots. */
 export interface ProviderRuntimeAuthMetadata {
@@ -42,10 +42,10 @@ export interface ProviderAccountPosture {
   readonly modelCount: number;
   /** Normalized route descriptors (declared or synthesized). */
   readonly routes: readonly ProviderAuthRouteDescriptor[];
-  readonly activeRoute: ProviderPanelAuthRoute;
-  readonly preferredRoute: ProviderPanelAuthRoute;
+  readonly activeRoute: ProviderHealthAuthRoute;
+  readonly preferredRoute: ProviderHealthAuthRoute;
   readonly activeRouteReason: string;
-  readonly authFreshness: ProviderPanelAuthFreshness;
+  readonly authFreshness: ProviderHealthAuthFreshness;
   /** True when any route is expiring (or already expired/pending). */
   readonly expiringSoon: boolean;
   readonly issues: readonly string[];
@@ -53,7 +53,7 @@ export interface ProviderAccountPosture {
   readonly repairHints: readonly string[];
 }
 
-const AUTH_ROUTE_PRIORITY: readonly ProviderPanelAuthRoute[] = [
+const AUTH_ROUTE_PRIORITY: readonly ProviderHealthAuthRoute[] = [
   'subscription-oauth',
   'service-oauth',
   'secret-ref',
@@ -63,7 +63,7 @@ const AUTH_ROUTE_PRIORITY: readonly ProviderPanelAuthRoute[] = [
   'unconfigured',
 ] as const;
 
-export function routePriority(route: ProviderPanelAuthRoute): number {
+export function routePriority(route: ProviderHealthAuthRoute): number {
   const priority = AUTH_ROUTE_PRIORITY.indexOf(route);
   return priority >= 0 ? priority : AUTH_ROUTE_PRIORITY.length;
 }
@@ -137,7 +137,7 @@ function pickRoute(
 /**
  * Derive the console's account/auth posture for one inspectAll() snapshot.
  * This is the only route-posture derivation in the TUI (the retired accounts
- * panel's parallel snapshot model was deleted with).
+ * view's parallel snapshot model was deleted with).
  */
 export function buildAccountPosture(snapshot: ProviderRuntimeSnapshotLike): ProviderAccountPosture {
   const auth = snapshot.runtime.auth;
@@ -146,9 +146,9 @@ export function buildAccountPosture(snapshot: ProviderRuntimeSnapshotLike): Prov
   const usableRoutes = routes.filter(isRouteUsable);
   const preferredRoute = pickRoute(configuredRoutes.length > 0 ? configuredRoutes : routes);
   const activeRoute = pickRoute(usableRoutes.length > 0 ? usableRoutes : (preferredRoute ? [preferredRoute] : []));
-  const activeRouteId: ProviderPanelAuthRoute = activeRoute?.route ?? 'unconfigured';
-  const preferredRouteId: ProviderPanelAuthRoute = preferredRoute?.route ?? activeRouteId;
-  const authFreshness: ProviderPanelAuthFreshness =
+  const activeRouteId: ProviderHealthAuthRoute = activeRoute?.route ?? 'unconfigured';
+  const preferredRouteId: ProviderHealthAuthRoute = preferredRoute?.route ?? activeRouteId;
+  const authFreshness: ProviderHealthAuthFreshness =
     activeRoute?.freshness ?? (activeRouteId === 'none' ? 'healthy' : 'unconfigured');
 
   const issueSet = new Set<string>();

package/src/{panels → views}/search-focus.ts

@@ -1,11 +1,11 @@
 import { isTextBackspace } from '../input/delete-key-policy.ts';
 
-export type PanelSearchFocusTransition = 'focus-search' | 'focus-list' | null;
+export type ViewSearchFocusTransition = 'focus-search' | 'focus-list' | null;
 
-export function getPanelSearchFocusTransition(
+export function getViewSearchFocusTransition(
   key: string,
   options: { selectedIndex: number; itemCount: number; focusKeys?: ReadonlyArray<string> },
-): PanelSearchFocusTransition {
+): ViewSearchFocusTransition {
   const focusKeys = options.focusKeys ?? ['/'];
   if (focusKeys.includes(key)) return 'focus-search';
   if (key === 'up' && options.selectedIndex <= 0) {
@@ -17,22 +17,22 @@ export function getPanelSearchFocusTransition(
   return null;
 }
 
-// Panel search filters are end-anchored (no moveable cursor).
+// View search filters are end-anchored (no moveable cursor).
 // Per the delete-key policy (src/input/delete-key-policy.ts):
 //   'backspace' removes the last character.
 //   'delete' is a no-op, there is no cursor, so forward-delete is meaningless.
-export function isPanelSearchBackspace(key: string): boolean {
+export function isViewSearchBackspace(key: string): boolean {
   return isTextBackspace(key);
 }
 
-export function isPanelSearchCancel(key: string): boolean {
+export function isViewSearchCancel(key: string): boolean {
   return key === 'escape';
 }
 
-export function isPanelSearchCommit(key: string): boolean {
+export function isViewSearchCommit(key: string): boolean {
   return key === 'return' || key === 'enter';
 }
 
-export function isPanelSearchPrintable(key: string): boolean {
+export function isViewSearchPrintable(key: string): boolean {
   return key.length === 1 && key >= ' ';
 }