@pellux/goodvibes-tui 0.19.65 → 0.19.67

package/CHANGELOG.md

@@ -8,6 +8,37 @@ All notable changes to GoodVibes TUI.
 
 ---
 
+## [0.19.67] — 2026-05-06
+
+### Fixed
+- Styled `/config` category group headings in bold and indented category rows so the category rail hierarchy is easier to scan.
+
+### Verified
+- `bun test src/test/renderer/settings-modal.test.ts`
+- `bunx tsc --noEmit`
+
+---
+
+## [0.19.66] — 2026-05-06
+
+### Fixed
+- Changed `/config` to open with focus on the category rail at the first category instead of dropping users directly into the selected setting list.
+- Reorganized the `/config` category rail into logical groups so related settings are easier to scan.
+- Corrected `goodvibes service status` / service posture reporting for systemd-managed daemons by reconciling status against `systemctl --user show`, so running/enabled OS services are no longer reported as stopped because of stale pid-file state.
+
+### Verified
+- `bun test src/test/input/settings-modal.test.ts src/test/renderer/settings-modal.test.ts`
+- `bun test src/test/input/modal-space-actions.test.ts`
+- `bun test src/test/cli/service-posture.test.ts`
+- `bun run test`
+- `bunx tsc --noEmit`
+- `bun run build:prod`
+- `bun run smoke:tui`
+- `bun run smoke:daemon`
+- `git diff --check`
+
+---
+
 ## [0.19.65] — 2026-05-05
 
 ### Fixed

package/README.md

@@ -2,7 +2,7 @@
 
 [![CI](https://github.com/mgd34msu/goodvibes-tui/actions/workflows/ci.yml/badge.svg)](https://github.com/mgd34msu/goodvibes-tui/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Version](https://img.shields.io/badge/version-0.19.65-blue.svg)](https://github.com/mgd34msu/goodvibes-tui)
+[![Version](https://img.shields.io/badge/version-0.19.67-blue.svg)](https://github.com/mgd34msu/goodvibes-tui)
 
 A terminal-native AI coding, operations, automation, knowledge, and integration console with a typed runtime, omnichannel surfaces, structured memory/knowledge, and a raw ANSI renderer.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-tui",
-  "version": "0.19.65",
+  "version": "0.19.67",
   "description": "Terminal-native GoodVibes product for coding, operations, automation, knowledge, channels, and daemon-backed control-plane workflows.",
   "type": "module",
   "main": "src/main.ts",

package/src/cli/service-posture.ts

@@ -1,3 +1,4 @@
+import { spawnSync } from 'node:child_process';
 import { accessSync, closeSync, constants, existsSync, openSync, readSync, realpathSync, statSync } from 'node:fs';
 import net from 'node:net';
 import { basename, delimiter, dirname, isAbsolute, join, resolve } from 'node:path';
@@ -82,6 +83,23 @@ interface ServiceDefinitionOverride {
   readonly restartOnFailure: boolean;
 }
 
+interface CliServiceStatusCommandResult {
+  readonly status: number | null;
+  readonly stdout?: string;
+  readonly stderr?: string;
+}
+
+interface CliServiceStatusManager {
+  status(): ManagedServiceStatus;
+}
+
+interface CliServicePostureOptions {
+  readonly probe?: boolean;
+  readonly logTailBytes?: number;
+  readonly manager?: CliServiceStatusManager;
+  readonly runCommand?: (command: string, args: readonly string[]) => CliServiceStatusCommandResult;
+}
+
 function connectHostForBindHost(host: string): string {
   if (host === '0.0.0.0' || host === '::') return '127.0.0.1';
   return host || '127.0.0.1';
@@ -227,6 +245,58 @@ function pidFilePath(runtime: CliServiceRuntime, platform: ManagedServiceStatus[
   return join(getServiceStateRoot(runtime), 'service', `${platform}.pid`);
 }
 
+function runStatusCommand(
+  command: string,
+  args: readonly string[],
+  options: CliServicePostureOptions,
+): CliServiceStatusCommandResult {
+  if (options.runCommand) return options.runCommand(command, args);
+  return spawnSync(command, [...args], {
+    stdio: 'pipe',
+    encoding: 'utf-8',
+    timeout: 1500,
+  });
+}
+
+function parseSystemdShowValue(lines: readonly string[], key: string): string | null {
+  const prefix = `${key}=`;
+  const match = lines.find((line) => line.startsWith(prefix));
+  return match ? match.slice(prefix.length).trim() : null;
+}
+
+function reconcileSystemdServiceStatus(
+  runtime: CliServiceRuntime,
+  status: ManagedServiceStatus,
+  options: CliServicePostureOptions,
+): ManagedServiceStatus {
+  if (status.platform !== 'systemd') return status;
+
+  const name = String(runtime.configManager.get('service.serviceName') ?? 'goodvibes').trim() || 'goodvibes';
+  const result = runStatusCommand('systemctl', [
+    '--user',
+    'show',
+    `${name}.service`,
+    '--property=LoadState,ActiveState,UnitFileState,MainPID',
+    '--no-page',
+  ], options);
+  if ((result.status ?? 1) !== 0) return status;
+
+  const lines = (result.stdout ?? '').split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+  const loadState = parseSystemdShowValue(lines, 'LoadState');
+  const activeState = parseSystemdShowValue(lines, 'ActiveState');
+  const unitFileState = parseSystemdShowValue(lines, 'UnitFileState');
+  const rawPid = Number.parseInt(parseSystemdShowValue(lines, 'MainPID') ?? '', 10);
+  const pid = Number.isFinite(rawPid) && rawPid > 0 ? rawPid : undefined;
+
+  return {
+    ...status,
+    installed: loadState === 'loaded' || status.installed,
+    autostart: unitFileState === 'enabled' || unitFileState === 'linked' || status.autostart,
+    running: activeState === 'active',
+    ...(pid === undefined ? {} : { pid }),
+  };
+}
+
 function readLogPosture(path: string | undefined, tailBytes: number): CliServiceLogPosture {
   if (!path) return { path: null, exists: false, size: 0, modifiedAt: null };
   if (!existsSync(path)) return { path, exists: false, size: 0, modifiedAt: null };
@@ -298,10 +368,10 @@ export function createPlatformServiceManager(runtime: CliServiceRuntime): Platfo
 
 export async function buildCliServicePosture(
   runtime: CliServiceRuntime,
-  options: { readonly probe?: boolean; readonly logTailBytes?: number } = {},
+  options: CliServicePostureOptions = {},
 ): Promise<CliServicePosture> {
-  const manager = createPlatformServiceManager(runtime);
-  const status = manager.status();
+  const manager = options.manager ?? createPlatformServiceManager(runtime);
+  const status = reconcileSystemdServiceStatus(runtime, manager.status(), options);
   const endpoints = await Promise.all(ENDPOINTS.map(async (endpoint): Promise<CliServiceEndpointPosture> => {
     const enabled = runtime.configManager.get(endpoint.enabledKey as never) === true;
     const binding = resolveRuntimeEndpointBinding(runtime.configManager, endpoint.id);

package/src/input/settings-modal-types.ts

@@ -36,39 +36,21 @@ export type SettingsCategory =
 
 export type SettingsFocusPane = 'categories' | 'settings';
 
-export const SETTINGS_CATEGORIES: SettingsCategory[] = [
-  'display',
-  'ui',
-  'provider',
-  'subscriptions',
-  'behavior',
-  'storage',
-  'permissions',
-  'orchestration',
-  'wrfc',
-  'tools',
-  'helper',
-  'tts',
-  'service',
-  'controlPlane',
-  'httpListener',
-  'web',
-  'network',
-  'mcp',
-  'sandbox',
-  'surfaces',
-  'cloudflare',
-  'batch',
-  'automation',
-  'watchers',
-  'runtime',
-  'telemetry',
-  'cache',
-  'danger',
-  'flags',
-  'release',
+export const SETTINGS_CATEGORY_GROUPS: ReadonlyArray<{
+  readonly label: string;
+  readonly categories: readonly SettingsCategory[];
+}> = [
+  { label: 'Interface', categories: ['display', 'ui', 'behavior', 'permissions'] },
+  { label: 'AI Routing', categories: ['provider', 'subscriptions', 'helper', 'tools', 'tts'] },
+  { label: 'Service & Network', categories: ['service', 'network', 'controlPlane', 'httpListener', 'web'] },
+  { label: 'Surfaces & Cloud', categories: ['surfaces', 'mcp', 'cloudflare'] },
+  { label: 'Automation', categories: ['batch', 'automation', 'watchers', 'orchestration', 'wrfc'] },
+  { label: 'Runtime & Data', categories: ['storage', 'sandbox', 'runtime', 'cache', 'telemetry'] },
+  { label: 'Advanced', categories: ['flags', 'release', 'danger'] },
 ];
 
+export const SETTINGS_CATEGORIES: SettingsCategory[] = SETTINGS_CATEGORY_GROUPS.flatMap(group => group.categories);
+
 export interface SettingEntry {
   setting: ConfigSetting;
   currentValue: unknown;

package/src/input/settings-modal.ts

@@ -34,6 +34,7 @@ import { logger } from '@pellux/goodvibes-sdk/platform/utils';
 import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
 import {
   SETTINGS_CATEGORIES,
+  SETTINGS_CATEGORY_GROUPS,
   type FlagEntry,
   type McpEntry,
   type SettingEntry,
@@ -60,6 +61,7 @@ export interface SettingsModalOpenOptions {
 
 export {
   SETTINGS_CATEGORIES,
+  SETTINGS_CATEGORY_GROUPS,
   type FlagEntry,
   type McpEntry,
   type SettingEntry,
@@ -158,7 +160,7 @@ export class SettingsModal {
     this._loadSubscriptionEntries();
     this.categoryIndex = 0;
     this.selectedIndex = 0;
-    this.focusPane = 'settings';
+    this.focusPane = 'categories';
     this.editingMode = false;
     this.editBuffer = '';
     this.pendingModelPickerTarget = null;

package/src/renderer/settings-modal.ts

@@ -8,7 +8,7 @@
 import type { Line } from '../types/grid.ts';
 import { createEmptyLine, createStyledCell } from '../types/grid.ts';
 import type { SettingsModal, SettingEntry, FlagEntry, McpEntry, SubscriptionEntry, SettingsCategory } from '../input/settings-modal.ts';
-import { SETTINGS_CATEGORIES } from '../input/settings-modal.ts';
+import { SETTINGS_CATEGORIES, SETTINGS_CATEGORY_GROUPS } from '../input/settings-modal.ts';
 import { getDisplayWidth, wrapText } from '../utils/terminal-width.ts';
 import { CATEGORY_LABELS, describeUiRouting, formatValue, getSettingLabel, inferSubscriptionRouteReason, valueColor } from './settings-modal-helpers.ts';
 import { isSecretConfigKey } from '../config/secret-config.ts';
@@ -413,19 +413,53 @@ function categoryItemCount(modal: SettingsModal, category: SettingsCategory): nu
   return modal.groups.get(category)?.length ?? 0;
 }
 
-function renderCategories(modal: SettingsModal, width: number, height: number): string[] {
-  const rows: string[] = [];
-  const window = stableWindow(SETTINGS_CATEGORIES.length, modal.categoryIndex, height);
-  if (window.start > 0) rows.push(`${GLYPHS.navigation.moreAbove} ${window.start} more categor${window.start === 1 ? 'y' : 'ies'} above`);
-  for (let index = window.start; index < window.end; index += 1) {
-    const category = SETTINGS_CATEGORIES[index]!;
-    const active = index === modal.categoryIndex;
+type CategoryRailEntry =
+  | { readonly type: 'group'; readonly label: string }
+  | { readonly type: 'category'; readonly category: SettingsCategory; readonly index: number };
+
+type CategoryRailRow = {
+  readonly text: string;
+  readonly type: CategoryRailEntry['type'] | 'more' | 'empty';
+  readonly selected: boolean;
+};
+
+function buildCategoryRailEntries(): CategoryRailEntry[] {
+  const entries: CategoryRailEntry[] = [];
+  for (const group of SETTINGS_CATEGORY_GROUPS) {
+    const categories = group.categories.filter(category => SETTINGS_CATEGORIES.includes(category));
+    if (categories.length === 0) continue;
+    entries.push({ type: 'group', label: group.label });
+    for (const category of categories) {
+      entries.push({
+        type: 'category',
+        category,
+        index: SETTINGS_CATEGORIES.indexOf(category),
+      });
+    }
+  }
+  return entries;
+}
+
+function renderCategories(modal: SettingsModal, width: number, height: number): CategoryRailRow[] {
+  const rows: CategoryRailRow[] = [];
+  const entries = buildCategoryRailEntries();
+  const selectedEntryIndex = Math.max(0, entries.findIndex(entry => entry.type === 'category' && entry.index === modal.categoryIndex));
+  const window = stableWindow(entries.length, selectedEntryIndex, height);
+  if (window.start > 0) rows.push({ text: `${GLYPHS.navigation.moreAbove} ${window.start} more row(s) above`, type: 'more', selected: false });
+  for (let railIndex = window.start; railIndex < window.end; railIndex += 1) {
+    const entry = entries[railIndex]!;
+    if (entry.type === 'group') {
+      rows.push({ text: entry.label.toUpperCase(), type: 'group', selected: false });
+      continue;
+    }
+    const category = entry.category;
+    const active = entry.index === modal.categoryIndex;
     const count = categoryItemCount(modal, category);
     const cursor = active ? (modal.focusPane === 'categories' ? GLYPHS.navigation.selected : '•') : ' ';
-    rows.push(`${cursor} ${CATEGORY_LABELS[category]} (${count})`);
+    rows.push({ text: `  ${cursor} ${CATEGORY_LABELS[category]} (${count})`, type: 'category', selected: active });
   }
-  if (window.end < SETTINGS_CATEGORIES.length) rows.push(`${GLYPHS.navigation.moreBelow} ${SETTINGS_CATEGORIES.length - window.end} more categor${SETTINGS_CATEGORIES.length - window.end === 1 ? 'y' : 'ies'} below`);
-  while (rows.length < height) rows.push('');
+  if (window.end < entries.length) rows.push({ text: `${GLYPHS.navigation.moreBelow} ${entries.length - window.end} more row(s) below`, type: 'more', selected: false });
+  while (rows.length < height) rows.push({ text: '', type: 'empty', selected: false });
   return rows.slice(0, height);
 }
 
@@ -615,13 +649,12 @@ export function renderSettingsModal(
     fillRange(line, 1, dividerX - 1, PALETTE.categoryBg);
     drawVertical(line, dividerX, bg);
 
-    const categoryText = categoryRows[row] ?? '';
-    const categoryActive = categoryText.startsWith(GLYPHS.navigation.selected) || categoryText.startsWith('•');
-    if (categoryText.startsWith(GLYPHS.navigation.selected)) fillRange(line, leftStart, dividerX - 1, PALETTE.selectedBg);
-    writeText(line, leftStart + 1, leftWidth - 3, categoryText, {
-      fg: categoryActive ? PALETTE.text : PALETTE.muted,
-      bg: categoryText.startsWith(GLYPHS.navigation.selected) ? PALETTE.selectedBg : PALETTE.categoryBg,
-      bold: categoryActive,
+    const categoryRow = categoryRows[row] ?? { text: '', type: 'empty' as const, selected: false };
+    if (categoryRow.selected) fillRange(line, leftStart, dividerX - 1, PALETTE.selectedBg);
+    writeText(line, leftStart + 1, leftWidth - 3, categoryRow.text, {
+      fg: categoryRow.selected ? PALETTE.text : categoryRow.type === 'group' ? PALETTE.subtitle : PALETTE.muted,
+      bg: categoryRow.selected ? PALETTE.selectedBg : PALETTE.categoryBg,
+      bold: categoryRow.selected || categoryRow.type === 'group',
     });
 
     if (inSeparator) {

package/src/version.ts

@@ -6,7 +6,7 @@ import { join } from 'node:path';
 // The prebuild script updates the fallback value before compilation.
 // Uses import.meta.dir (Bun) to locate package.json relative to this file,
 // which is correct regardless of the process working directory.
-let _version = '0.19.65';
+let _version = '0.19.67';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8'));
   _version = pkg.version ?? _version;