rinco-pi-hud 1.3.0 → 1.3.1

package/README.md

@@ -113,7 +113,7 @@ See [docs/footer.md](docs/footer.md) for the full variable and segment reference
 | [`extensions/hud/ui/`](extensions/hud/ui/) | Icons and terminal style utilities |
 | [`docs/footer.md`](docs/footer.md) | Complete footer configuration reference |
 | [`docs/CONTRIBUTING.md`](docs/CONTRIBUTING.md) | Local development, testing guidance, and pull request checklist |
-| [`tests/`](tests/) | Vitest suite: footer layout, telemetry, provider balances, MCP parsing |
+| [`tests/`](tests/) | Vitest suite: footer layout, telemetry, provider balances, MCP configuration counts |
 
 ## Development
 

package/docs/CONTRIBUTING.md

@@ -50,7 +50,8 @@ npm run pack:check
 
 Tests live in `tests/`:
 
-- `zentui-status.test.ts` — Config counts, MCP status parsing, and extension status helpers.
+- `zentui-status.test.ts` — Config counts, MCP configuration counts, and extension status helpers.
+- `mcp-footer.test.ts` — MCP count rendering, segment controls, custom formats, and legacy third-party statuses.
 - `codex-usage.test.ts` — Codex payload normalization and model-specific quota formatting.
 - `footer-layout.test.ts` — Four-group categorized layout, segment wrapping, and narrow-width budget.
 - `footer-groups.test.ts` — Semantic Project, Session, Activity, and Usage segment ordering.

package/docs/README.zh-CN.md

@@ -113,7 +113,7 @@ Usage 行跟随当前模型的 Provider：
 | [`extensions/hud/ui/`](../extensions/hud/ui/) | 图标与终端样式工具 |
 | [`docs/footer.md`](footer.md) | 完整脚注配置参考 |
 | [`docs/CONTRIBUTING.md`](CONTRIBUTING.md) | 本地开发、测试规范和 PR 检查清单 |
-| [`tests/`](../tests/) | Vitest 测试套件：脚注布局、遥测、各家余额与 MCP 解析 |
+| [`tests/`](../tests/) | Vitest 测试套件：脚注布局、遥测、各家余额与 MCP 配置计数 |
 
 ## 开发
 

package/docs/footer.md

@@ -7,10 +7,12 @@ When `footerFormat` is empty, the HUD displays four semantic groups:
 ```text
 Project  · pi-sakura ·  main ·  24.18
 Session  · gpt-5.3 · Thinking level: high · Turn 8
-Activity · Agent idle · Skill 2/3 · MCP 2/2
+Activity · Agent idle · Skill 2/3 · MCP 2
 Usage    · 35%/200k · ↑ 4.2k · ↓ 1.1k · $ 0.030
 ```
 
+The MCP segment counts server entries in Pi's agent-directory `mcp.json` and the project's `.pi/mcp.json`. Same-name entries count once; disabled entries are included. Zero entries hide the segment. Counts refresh with the project state polling interval. This does not report connection state, validate individual server settings, or include servers registered dynamically by extensions. Missing, unreadable, malformed, or larger-than-1-MiB files contribute no entries. Legacy adapter footer statuses remain ordinary third-party statuses.
+
 The category column is sized from visible text so every separator aligns. When a row exceeds the terminal width, complete status segments move to an indented continuation line. Only a single segment that is wider than the available content area is truncated. Third-party extension statuses appear on the Activity group in configured `left`, `middle`, then `right` order.
 
 Control each default-layout row independently:
@@ -50,7 +52,7 @@ The command shape is `/zentui row <project|session|activity|usage> <enable|disab
 | `activeAgents` | on | Activity | Active primary agent runs |
 | `agentIdle` | on | Activity | `Agent idle` when no primary agent run is active |
 | `skills` | on | Activity | Active/available skills count, e.g. `Skill 1/3` |
-| `mcp` | on | Activity | MCP connected/total servers |
+| `mcp` | on | Activity | File-configured MCP servers, e.g. `MCP 2` |
 | `context` | on | Usage | Context percentage, window size, and/or gauge |
 | `inputTokens` | on | Usage | Cumulative input tokens |
 | `outputTokens` | on | Usage | Cumulative output tokens |
@@ -119,7 +121,7 @@ Clear it:
 | `$skills` | Active/available skills, e.g. `Skill 1/3` |
 | `$active_skills` | Active skills count only |
 | `$extensions` | Installed Pi packages count |
-| `$mcp` | MCP connected/total |
+| `$mcp` | File-configured MCP server count |
 | `$tool_counts` | Native tool completion counts |
 | `$running_tools` | Recently running tools |
 | `$active_agents` | Active primary agent runs |

package/extensions/hud/commands/settings.ts

@@ -133,7 +133,7 @@ const footerSegmentSettingLabels: Record<FooterSegmentSettingId, string> = {
 	activeAgents: "Active agents",
 	agentIdle: "Agent idle status",
 	skills: "Skill activity",
-	mcp: "MCP connections",
+	mcp: "MCP configured servers",
 	context: "Context usage",
 	inputTokens: "Input tokens",
 	outputTokens: "Output tokens",
@@ -173,7 +173,7 @@ const footerSegmentSettingDescriptions: Record<FooterSegmentSettingId, string> =
 	codexUsage: "Show OpenAI Codex subscription rate limits on the usage row when available.",
 	configCounts: "Show instruction-file and installed Pi package counts on the project row.",
 	skills: "Show active/available Pi skill counts on the activity row.",
-	mcp: "Show parsed MCP connected/total server counts on the activity row.",
+	mcp: "Show the configured server count from global and project mcp.json, including disabled entries.",
 	runningTools: "Show currently running native tools and their elapsed time.",
 	toolCounts: "Show cumulative completed native-tool counts.",
 	activeAgents: "Show active main agent runs on the activity row (not subagent count).",

package/extensions/hud/config/config-counts.ts

@@ -1,6 +1,7 @@
 import { createRequire } from "node:module";
 import { readFileSync, statSync } from "node:fs";
 import { isAbsolute, join } from "node:path";
+import { countConfiguredMcpServers } from "../segments/mcp-status.js";
 
 export interface ConfigCounts {
 	instructionFiles: {
@@ -9,6 +10,7 @@ export interface ConfigCounts {
 		total: number;
 	};
 	packages: number;
+	mcpServers: number;
 }
 
 export interface ConfigCountOptions {
@@ -82,6 +84,7 @@ export function countConfigEntries(cwd: string, options: ConfigCountOptions = {}
 			total: agentsMd + claudeMd,
 		},
 		packages: countPackages(agentDir),
+		mcpServers: countConfiguredMcpServers(cwd, agentDir),
 	};
 }
 

package/extensions/hud/footer/index.ts

@@ -31,7 +31,6 @@ import {
 } from "../telemetry/format.js";
 import { resolveRuntimeSymbol } from "../ui/icons.js";
 import type { LiveContextOverride } from "../session/live-context.js";
-import { parseMcpStatus } from "../segments/mcp-status.js";
 import type { FooterState } from "../state/index.js";
 import { renderStyleForSource } from "../ui/style.js";
 
@@ -74,7 +73,6 @@ export function installFooter(
 				const colorSource = config.colorSources.starship;
 				const iconMode = config.icons.mode;
 				const rawExtensionStatuses = footerData.getExtensionStatuses();
-				const mcpStatus = parseMcpStatus(rawExtensionStatuses.get("mcp"));
 				const { safeCwd, safeRuntime, safePackageVersion, safeCommit } = sanitizeFooterInputs(
 					ctx,
 					state,
@@ -166,7 +164,7 @@ export function installFooter(
 					runningToolsLabel,
 					activeAgentsLabel,
 					agentIdleLabel,
-				} = buildTelemetryLabels(ctx, state, config, theme, colorSource, mcpStatus);
+				} = buildTelemetryLabels(ctx, state, config, theme, colorSource);
 				const renderVariable = (name: string): string => {
 					const canonical = FOOTER_FORMAT_ALIASES[name] ?? name;
 					switch (canonical) {
@@ -439,14 +437,7 @@ export function installFooter(
 							formatTimeLabel(""),
 						)}`
 					: "";
-				const formatNeedsMcp = /\$\{?mcp\b/.test(config.footerFormat);
-				const dedicatedMcpVisible = Boolean(
-					mcpStatus && (config.footerFormat ? formatNeedsMcp : config.footerSegments.mcp),
-				);
-				const extensionStatusSource = dedicatedMcpVisible
-					? new Map([...rawExtensionStatuses].filter(([key]) => key !== "mcp"))
-					: rawExtensionStatuses;
-				const extensionStatuses = collectExtensionStatusSegments(extensionStatusSource, config);
+				const extensionStatuses = collectExtensionStatusSegments(rawExtensionStatuses, config);
 				const renderExtensionStatus = (segment: ExtensionStatusSegment) =>
 					segment.colorMode === "original"
 						? segment.text

package/extensions/hud/footer/render-labels.ts

@@ -11,7 +11,6 @@
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth } from "@earendil-works/pi-tui";
 import type { ColorSource, PolishedTuiConfig } from "../config/config.js";
-import type { McpStatus } from "../segments/mcp-status.js";
 import { formatSkillCounts } from "../segments/skill-activity.js";
 import type { FooterState } from "../state/index.js";
 import { getTelemetryStats } from "../state/telemetry.js";
@@ -164,7 +163,6 @@ export function buildTelemetryLabels(
 	config: PolishedTuiConfig,
 	theme: ThemeLike,
 	colorSource: ColorSource,
-	mcpStatus: McpStatus | undefined,
 ): TelemetryLabels {
 	const statusStyle = (style: string, text: string) =>
 		text ? renderStyleForSource(theme, colorSource, style, text) : "";
@@ -267,9 +265,10 @@ export function buildTelemetryLabels(
 			: "";
 	const configCountsLabel = [instructionFilesLabel, extensionsLabel].filter(Boolean).join(" ");
 
-	const mcpLabel = mcpStatus
-		? statusStyle(config.colors.gitStatus, `MCP ${mcpStatus.connected}/${mcpStatus.total}`)
-		: "";
+	const mcpLabel =
+		state.configCounts.mcpServers > 0
+			? statusStyle(config.colors.gitStatus, `MCP ${state.configCounts.mcpServers}`)
+			: "";
 
 	const telemetryStats = getTelemetryStats(state.telemetry);
 	const toolCountsText = Object.entries(telemetryStats.completedToolCounts)

package/extensions/hud/segments/mcp-status.ts

@@ -1,26 +1,31 @@
-import { stripVTControlCharacters } from "node:util";
+import { readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
 
-export interface McpStatus {
-	connected: number;
-	total: number;
+const MAX_CONFIG_BYTES = 1024 * 1024;
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 
-/** Parses the adapter's public status text without intercepting or modifying UI methods. */
-export function parseMcpStatus(text: string | undefined): McpStatus | undefined {
-	if (typeof text !== "string" || text.length === 0) return undefined;
-	const status = stripVTControlCharacters(text.slice(0, 2048));
-	const enabledMatch = status.match(
-		/MCP:\s*(\d{1,5})\s+servers?\s+enabled(?:\s*\(\s*(\d{1,5})\s+connected\s*\))?(?:\s*\(\s*(\d{1,5})\s+disabled\s*\))?\s*$/i,
-	);
-	const legacyMatch = status.match(/MCP:\s*(\d{1,5})\s*\/\s*(\d{1,5})\s+servers\b/i);
-	if (!enabledMatch && !legacyMatch) return undefined;
-	const connected = Number(enabledMatch ? (enabledMatch[2] ?? 0) : legacyMatch![1]);
-	const total = Number(enabledMatch ? enabledMatch[1] : legacyMatch![2]);
-	const disabled = enabledMatch?.[3] === undefined ? 0 : Number(enabledMatch[3]);
-	if (![connected, total, disabled].every(Number.isSafeInteger)) return undefined;
-	if (connected < 0 || total < 0 || connected > total || total > 10_000 || disabled > 10_000)
-		return undefined;
-	return { connected, total };
+function readServerNames(path: string): string[] {
+	try {
+		const stats = statSync(path);
+		if (!stats.isFile() || stats.size > MAX_CONFIG_BYTES) return [];
+		const config: unknown = JSON.parse(readFileSync(path, "utf8"));
+		if (!isRecord(config) || !isRecord(config.mcpServers)) return [];
+		return Object.entries(config.mcpServers)
+			.filter(([name, entry]) => /^[A-Za-z0-9_-]+$/.test(name) && isRecord(entry))
+			.map(([name]) => name);
+	} catch {
+		return [];
+	}
 }
 
-export const parseMcpAdapterStatus = parseMcpStatus;
+/** Count file-configured server entries, including disabled ones, without resolving secrets
+ * or starting connections. Project entries override global entries with the same name.
+ * This is not a connection count or a validation of individual server settings. */
+export function countConfiguredMcpServers(cwd: string, agentDir: string): number {
+	const globalNames = agentDir ? readServerNames(join(agentDir, "mcp.json")) : [];
+	const projectNames = readServerNames(join(cwd, ".pi", "mcp.json"));
+	return new Set([...globalNames, ...projectNames]).size;
+}

package/extensions/hud/state/index.ts

@@ -42,6 +42,7 @@ export function createInitialState(gitDefaults: GitStatusSummary): FooterState {
 		configCounts: {
 			instructionFiles: { agentsMd: 0, claudeMd: 0, total: 0 },
 			packages: 0,
+			mcpServers: 0,
 		},
 		skillCounts: undefined,
 		codexUsageStatus: undefined,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rinco-pi-hud",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "A dynamic HUD footer for Pi, ported from Sakura Zentui Footer.",
   "type": "module",
   "license": "MIT",