@pellux/goodvibes-tui 0.19.65 → 0.19.66

package/CHANGELOG.md

@@ -8,6 +8,26 @@ All notable changes to GoodVibes TUI.
 
 ---
 
+## [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.66-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.66",
   "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,18 +413,46 @@ function categoryItemCount(modal: SettingsModal, category: SettingsCategory): nu
   return modal.groups.get(category)?.length ?? 0;
 }
 
+type CategoryRailEntry =
+  | { readonly type: 'group'; readonly label: string }
+  | { readonly type: 'category'; readonly category: SettingsCategory; readonly index: number };
+
+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): 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;
+  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(`${GLYPHS.navigation.moreAbove} ${window.start} more row(s) above`);
+  for (let railIndex = window.start; railIndex < window.end; railIndex += 1) {
+    const entry = entries[railIndex]!;
+    if (entry.type === 'group') {
+      rows.push(`  ${entry.label.toUpperCase()}`);
+      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})`);
   }
-  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`);
+  if (window.end < entries.length) rows.push(`${GLYPHS.navigation.moreBelow} ${entries.length - window.end} more row(s) below`);
   while (rows.length < height) rows.push('');
   return rows.slice(0, height);
 }

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.66';
 try {
   const pkg = JSON.parse(readFileSync(join(import.meta.dir, '..', 'package.json'), 'utf-8'));
   _version = pkg.version ?? _version;