@linxiraos/pi-stats 1.3.2 → 1.4.1

package/dist/types/types.d.ts

@@ -174,11 +174,57 @@ export interface UserMessageStats {
     emphasis: number;
     /** 1 when the prose leans on a script no lexicon covers; such rows are unscored, not calm. */
     unsupportedScript: number;
-    /** Judge-facing prose (see `judgeProse`); empty when the message was all markup. */
+    /** Judge-facing prose (see `analysisProse`); empty when the message was all markup. */
     prose: string;
     /** Hex `Bun.hash` of `prose`, keying the shared verdict cache; empty when `prose` is. */
     proseHash: string;
 }
+/**
+ * Model-side analysis for one assistant turn: the text body stored for
+ * offline analysis plus the signals computed from it at ingest (see
+ * `model-metrics.ts`). Keyed like `user_messages` by (session_file, entry_id).
+ * Turns without prose (tool-call-only replies) emit no row.
+ */
+export interface AssistantTextStats {
+    /** Database ID */
+    id?: number;
+    /** Session file path */
+    sessionFile: string;
+    /** Assistant message entry ID within the session */
+    entryId: string;
+    /** Folder/project path (extracted from session filename) */
+    folder: string;
+    /** Unix timestamp in ms */
+    timestamp: number;
+    /** Model that produced the turn */
+    model: string;
+    /** Provider that served the turn */
+    provider: string;
+    /** Which agent produced the turn (main agent, task subagent, advisor) */
+    agentType: AgentType;
+    /** Analyzed-prose characters (code and markup stripped, capped) */
+    chars: number;
+    /** Analyzed-prose words */
+    words: number;
+    /** Apology / self-blame markers */
+    selfBlame: number;
+    /** Repeated-restatement markers plus near-duplicate previous turn */
+    restatement: number;
+    /** Hedged fallback markers */
+    hedge: number;
+    /** 1 when the turn is long-winded */
+    verbose: number;
+    /** Failed tool results preceding the turn */
+    toolErrors: number;
+    /** 1 when the preceding failures form a spiral */
+    toolSpiral: number;
+    /** Per-turn aggregate (see `AssistantMessageMetrics`) */
+    collapse: number;
+    /** 1 when the prose leans on a script no lexicon covers */
+    unsupportedScript: number;
+    /** Stored analysis prose (see `analysisProse`); never empty for an emitted row. */
+    prose: string;
+}
 /**
  * Pair emitted by the parser when it sees an assistant message whose
  * `parentId` points to a user message that wasn't parsed in the same pass

package/dist/types/user-metrics.d.ts

@@ -91,14 +91,34 @@ export interface UserMessageMetrics {
      */
     unsupportedScript: number;
 }
+export declare const WORD_RE: RegExp;
+/** 1 when the prose leans on a script the lexicons do not cover. */
+export declare function detectUnsupportedScript(prose: string): number;
+/**
+ * 1 when the message says essentially the same thing as the one before it -
+ * the one frustration signal that needs no lexicon and therefore works for
+ * any language and survives every transcription error.
+ */
+export declare function detectRepeatedMessage(prose: string, prevProse: string): number;
+/** Count regex hits without materializing the match array. */
+export declare function countMatches(text: string, re: RegExp): number;
+/**
+ * Strip structured content so that pasted code, harness wrappers, file
+ * mentions and quoted blocks don't dilute or fake behavior signals.
+ * Each strip is replaced with a newline so subsequent line counting
+ * reflects what was removed instead of merging neighbors.
+ */
+export declare function stripStructuredContent(text: string): string;
 /** Cap on the judge-facing prose stored per user message; longer prose is truncated. */
 export declare const PROSE_MAX_CHARS = 4000;
 /**
- * The prose a user message contributes to frustration judging: the same
+ * The prose a message contributes to behavioral analysis: the same
  * structured-content strip the regex signals score on, trimmed and capped at
  * {@link PROSE_MAX_CHARS}. Empty when the message was nothing but markup.
+ * Shared by the user-message judge and the model-side analyzer so both store
+ * exactly the same body.
  */
-export declare function judgeProse(text: string): string;
+export declare function analysisProse(text: string): string;
 /**
  * Compute behavioral metrics for a user message.
  *

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@linxiraos/pi-stats",
-	"version": "1.3.2",
+	"version": "1.4.1",
 	"description": "Local observability dashboard for omp AI usage statistics",
 	"homepage": "https://linxira-os.github.io/zeta/",
 	"author": "Linxira-OS",
@@ -39,9 +39,9 @@
 		"fmt": "oxfmt --no-error-on-unmatched-pattern 'src/**/*.{ts,tsx}' '{test,bench,examples,scripts}/**/*.ts' '*.ts'"
 	},
 	"dependencies": {
-		"@linxiraos/pi-ai": "1.3.2",
-		"@linxiraos/pi-catalog": "1.3.2",
-		"@linxiraos/pi-utils": "1.3.2",
+		"@linxiraos/pi-ai": "1.4.1",
+		"@linxiraos/pi-catalog": "1.4.1",
+		"@linxiraos/pi-utils": "1.4.1",
 		"lucide-react": "^1.24.0",
 		"react": "19.2.7",
 		"react-dom": "19.2.7"

package/src/aggregator.ts

@@ -415,6 +415,7 @@ async function syncAllSessionsLocked(
 		pendingRows +=
 			result.stats.length +
 			result.userStats.length +
+			result.assistantTexts.length +
 			result.userLinks.length +
 			result.toolCalls.length +
 			result.toolResults.length;

package/src/client/App.tsx

@@ -1,6 +1,7 @@
 import { useCallback, useRef, useState } from "react";
 import type { DashboardSection } from "./app/nav";
 import { Shell } from "./app/Shell";
+import { useLocale } from "./i18n/useLocale";
 import { LiveProvider } from "./data/live";
 import { useHashRoute } from "./data/useHashRoute";
 import {
@@ -27,6 +28,9 @@ export default function App() {
 }
 
 function Dashboard() {
+	// A topbar language switch re-renders the whole tree: translated copy is
+	// read through `t()` at render time, including the mounted-but-hidden pages.
+	useLocale();
 	const { section, setSection, range, setRange, session, setSession } = useHashRoute();
 	const [selectedRequestId, setSelectedRequestId] = useState<number | null>(null);
 	// Stable identity so the drawer's effects don't tear down on every render.

package/src/client/app/LanguageToggle.tsx

@@ -0,0 +1,30 @@
+import { Languages } from "lucide-react";
+import { setUserLocale, t } from "../i18n";
+import { useLocale } from "../i18n/useLocale";
+
+/**
+ * Topbar language switch: EN ⇄ 中文. The label shows the language the click
+ * will install (the dashboard is already in the other one), and the choice is
+ * remembered in localStorage so a reload keeps it over the host's injected
+ * locale.
+ */
+export function LanguageToggle() {
+	const locale = useLocale();
+	const next = locale === "en" ? "zh-CN" : "en";
+	const label = locale === "en" ? "中文" : "EN";
+
+	return (
+		<button
+			type="button"
+			className="btn"
+			data-variant="ghost"
+			data-locale-toggle={locale}
+			onClick={() => setUserLocale(next)}
+			aria-label={t("shell.switch-language")}
+			title={`${t("shell.language")}: ${label}`}
+		>
+			<Languages size={15} />
+			<span className="topbar-locale-label">{label}</span>
+		</button>
+	);
+}

package/src/client/app/Shell.tsx

@@ -2,9 +2,11 @@ import { Menu } from "lucide-react";
 import { type ReactNode, useEffect, useState } from "react";
 import { rangeMeta, TIME_RANGES } from "../data/range";
 import { t } from "../i18n";
+import { useLocale } from "../i18n/useLocale";
 import { useLiveStatus } from "../data/live";
 import type { TimeRange } from "../types";
 import { Segmented } from "../ui";
+import { LanguageToggle } from "./LanguageToggle";
 import { LiveChip } from "./LiveChip";
 import { type DashboardSection, NAV } from "./nav";
 import { ThemeToggle } from "./ThemeToggle";
@@ -17,18 +19,20 @@ export interface ShellProps {
 	children: ReactNode;
 }
 
-const RANGE_OPTIONS = TIME_RANGES.map((range, i) => ({
-	value: range,
-	label: t(rangeMeta(range).labelKey),
-	title: `${t(rangeMeta(range).windowKey)} (${i + 1})`,
-}));
-
 /**
  * Fixed glass topbar + naked sidebar framing one inset content panel. Owns
  * the global keyboard shortcuts: `1`–`6` pick a range, `g` then a letter jumps
  * to a page.
  */
 export function Shell({ section, onSectionChange, range, onRangeChange, children }: ShellProps) {
+	// Range labels are translated copy, so they are rebuilt on a locale switch
+	// instead of being frozen in a module-level table.
+	useLocale();
+	const rangeOptions = TIME_RANGES.map((range, i) => ({
+		value: range,
+		label: t(rangeMeta(range).labelKey),
+		title: `${t(rangeMeta(range).windowKey)} (${i + 1})`,
+	}));
 	const [menuOpen, setMenuOpen] = useState(false);
 	const scrolled = useScrolled();
 	const { sync } = useLiveStatus();
@@ -87,11 +91,12 @@ export function Shell({ section, onSectionChange, range, onRangeChange, children
 						<LiveChip />
 					</span>
 					<Segmented
-						options={RANGE_OPTIONS}
+						options={rangeOptions}
 						value={range}
 						onChange={onRangeChange}
 						aria-label={t("common.time-range")}
 					/>
+					<LanguageToggle />
 					<ThemeToggle />
 				</div>
 				{progress !== undefined && (

package/src/client/app/ThemeToggle.tsx

@@ -1,6 +1,7 @@
 import { type LucideIcon, Monitor, Moon, Sun } from "lucide-react";
 import { type ThemePreference, useThemePreference } from "../useSystemTheme";
 import { t } from "../i18n";
+import { useLocale } from "../i18n/useLocale";
 
 const NEXT_PREFERENCE: Record<ThemePreference, ThemePreference> = {
 	system: "light",
@@ -8,22 +9,24 @@ const NEXT_PREFERENCE: Record<ThemePreference, ThemePreference> = {
 	dark: "system",
 };
 
+const PREFERENCE_LABEL_KEY = {
+	system: "shell.system-theme",
+	light: "shell.light-theme",
+	dark: "shell.dark-theme",
+} as const;
+
 const PREFERENCE_ICON: Record<ThemePreference, LucideIcon> = {
 	system: Monitor,
 	light: Sun,
 	dark: Moon,
 };
 
-const PREFERENCE_LABEL: Record<ThemePreference, string> = {
-	system: t("shell.system-theme"),
-	light: t("shell.light-theme"),
-	dark: t("shell.dark-theme"),
-};
-
 /** Cycles system → light → dark. */
 export function ThemeToggle() {
+	useLocale();
 	const { preference, setPreference } = useThemePreference();
 	const Icon = PREFERENCE_ICON[preference];
+	const label = t(PREFERENCE_LABEL_KEY[preference]);
 
 	return (
 		<button
@@ -32,8 +35,8 @@ export function ThemeToggle() {
 			data-variant="ghost"
 			data-icon="true"
 			onClick={() => setPreference(NEXT_PREFERENCE[preference])}
-			aria-label={`${PREFERENCE_LABEL[preference]} (click to switch)`}
-			title={`${PREFERENCE_LABEL[preference]} — click to switch`}
+			aria-label={`${label} (click to switch)`}
+			title={`${label} — click to switch`}
 		>
 			<Icon size={15} />
 		</button>

package/src/client/i18n/index.ts

@@ -11,19 +11,32 @@ function injectedLocale(): string | undefined {
 
 const messages: MessagesByLocale = { en: enLocale.messages, "zh-CN": zhCNLocale.messages };
 
+/** Local override written by the in-page switcher; survives reloads. */
+const LOCALE_STORAGE_KEY = "zeta.stats.locale";
+
+const localeListeners = new Set<() => void>();
+
 let activeLocale: StatsLocale = "en";
 
 // Resolve once at module load. Every `t()` caller imports this module first, so
-// the host language the server injected into `<head>` (or the browser's own
-// preference) is already in effect by the time a component module is evaluated
-// — including module-level label tables such as the range selector's.
+// the stored choice, the host language the server injected into `<head>`, or
+// the browser's own preference is already in effect by the time a component
+// module is evaluated.
 resolveInitialLocale();
 
-/** The locale the dashboard renders in. Fixed at boot; there is no in-page switcher. */
+/** The locale the dashboard renders in. */
 export function getLocale(): StatsLocale {
 	return activeLocale;
 }
 
+/** Subscribe to runtime switches (the topbar toggle); returns the unsubscribe. */
+export function subscribeLocale(listener: () => void): () => void {
+	localeListeners.add(listener);
+	return () => {
+		localeListeners.delete(listener);
+	};
+}
+
 /** Install a locale by tag (`zh`, `zh-CN`, `zh-Hans`; anything else is English). */
 export function setLocale(tag: string | undefined | null): StatsLocale {
 	activeLocale = resolveLocaleTag(tag);
@@ -31,10 +44,40 @@ export function setLocale(tag: string | undefined | null): StatsLocale {
 }
 
 /**
- * The locale to boot with: the host's language when `zetacode stats` injected it,
- * then the browser's own preference, then English.
+ * The user's explicit pick from the topbar: install it, remember it, and
+ * re-render every subscriber.
+ */
+export function setUserLocale(tag: string): StatsLocale {
+	const next = setLocale(tag);
+	try {
+		globalThis.localStorage?.setItem(LOCALE_STORAGE_KEY, next);
+	} catch {
+		// Private-mode storage denial only costs the choice at next reload.
+	}
+	for (const listener of [...localeListeners]) listener();
+	return next;
+}
+
+/** A stored topbar choice, when it still parses as a supported locale. */
+function storedLocale(): StatsLocale | undefined {
+	try {
+		const raw = globalThis.localStorage?.getItem(LOCALE_STORAGE_KEY);
+		if (!raw) return undefined;
+		const resolved = resolveLocaleTag(raw);
+		return resolved === "en" || resolved === "zh-CN" ? resolved : undefined;
+	} catch {
+		return undefined;
+	}
+}
+
+/**
+ * The locale to boot with: an explicit topbar choice, then the host's language
+ * when `zetacode stats` injected it, then the browser's own preference, then
+ * English.
  */
 export function resolveInitialLocale(): StatsLocale {
+	const stored = storedLocale();
+	if (stored) return setLocale(stored);
 	const injected = injectedLocale();
 	if (injected) return setLocale(injected);
 	if (typeof navigator === "undefined") return "en";

package/src/client/i18n/messages/common.ts

@@ -81,6 +81,8 @@ export const common = {
 		"shell.light-theme": "Light theme",
 		"shell.range-suffix": "range",
 		"shell.jump-hint": "then letter to jump",
+		"shell.language": "Language",
+		"shell.switch-language": "Switch dashboard language",
 	},
 	"zh-CN": {
 		"common.provider": "服务商",
@@ -153,5 +155,7 @@ export const common = {
 		"shell.light-theme": "浅色主题",
 		"shell.range-suffix": "范围",
 		"shell.jump-hint": "再按字母跳转",
+		"shell.language": "语言",
+		"shell.switch-language": "切换仪表盘语言",
 	},
 } as const;

package/src/client/i18n/messages/frustration.ts

@@ -101,6 +101,46 @@ export const frustration = {
 		"frustration.cancelled": "Cancelled",
 		"frustration.failed": "Failed",
 		"frustration.done": "Done",
+		"frustration.model-side-title": "AI breakdown",
+		"frustration.model-side-description": "How the model's own replies read, per model version, in {window}.",
+		"frustration.model-turns": "Assistant turns",
+		"frustration.model-turns-title":
+			"Assistant replies with text in range; tool-call-only replies and thinking blocks are not analyzed",
+		"frustration.model-breakdown": "Breakdown rate",
+		"frustration.model-breakdown-title": "Share of analyzed turns with at least one breakdown signal",
+		"frustration.model-mean": "Signals / turn",
+		"frustration.model-mean-title": "Average per-turn aggregate: text markers plus capped failed tool results",
+		"frustration.model-self-blame": "Self-blame",
+		"frustration.model-self-blame-title": "Turns containing an apology or admission",
+		"frustration.model-restatement": "Restatement",
+		"frustration.model-restatement-title":
+			"Turns repeating earlier content, by explicit marker or near-duplicate reply",
+		"frustration.model-hedge": "Hedged",
+		"frustration.model-hedge-title": "Turns with hedged fallbacks: uncertainty or suggested alternatives",
+		"frustration.model-spiral": "Tool spirals",
+		"frustration.model-spiral-title": "Turns following three or more failed tool results",
+		"frustration.model-rambling": "Rambling",
+		"frustration.model-rambling-title": "Turns past the verbosity threshold",
+		"frustration.model-unscored-line": "Turns in a language without a lexicon: {count} — unscored, not calm.",
+		"frustration.model-by-model": "AI breakdown by model version",
+		"frustration.model-table-title": "Model breakdown detail",
+		"frustration.model-by-model-description":
+			"Share of each model's analyzed turns carrying a breakdown signal. Hue = model family.",
+		"frustration.model-over-time": "AI breakdown over time",
+		"frustration.model-over-time-description":
+			"Breakdown rate per bucket: turns with a signal over analyzed turns. Gaps are buckets with no turns.",
+		"frustration.model-sessions": "Sessions by breakdown",
+		"frustration.model-sessions-description": "Sessions with the most analyzed assistant turns.",
+		"frustration.model-table-description": "Rates are shares of analyzed assistant turns.",
+		"frustration.column-session": "Session",
+		"frustration.column-turns": "Turns",
+		"frustration.column-mean": "Signals/turn",
+		"frustration.column-tool-errors": "Tool errors",
+		"frustration.model-no-turns": "No assistant turns with text in this range",
+		"frustration.model-try-longer-range": "Try a longer range.",
+		"frustration.model-legend-breakdown": "Breakdown rate",
+		"frustration.turns-n": "{count} turns",
+		"frustration.model-hint-mean": "{value} signals per turn on average",
 	},
 	"zh-CN": {
 		"frustration.estimate-note":
@@ -194,5 +234,42 @@ export const frustration = {
 		"frustration.cancelled": "已取消",
 		"frustration.failed": "失败",
 		"frustration.done": "完成",
+		"frustration.model-side-title": "AI 崩溃度",
+		"frustration.model-side-description": "各模型版本自身回复的读感，统计窗口：{window}。",
+		"frustration.model-turns": "助手回合",
+		"frustration.model-turns-title": "时间范围内带文本的助手回复；仅含工具调用的回复与思考块不参与分析",
+		"frustration.model-breakdown": "崩溃率",
+		"frustration.model-breakdown-title": "至少带一个崩溃信号的已分析回合占比",
+		"frustration.model-mean": "信号 / 回合",
+		"frustration.model-mean-title": "每回合聚合均值：文本标记加上封顶的工具失败数",
+		"frustration.model-self-blame": "自责",
+		"frustration.model-self-blame-title": "包含道歉或认错的回合",
+		"frustration.model-restatement": "重复陈述",
+		"frustration.model-restatement-title": "以显式标记或与上一条回复高度相似的方式重复先前内容的回合",
+		"frustration.model-hedge": "含糊兜底",
+		"frustration.model-hedge-title": "带有含糊兜底的回合：不确定表述或建议替代方案",
+		"frustration.model-spiral": "工具失败螺旋",
+		"frustration.model-spiral-title": "紧随三个及以上工具失败之后的回合",
+		"frustration.model-rambling": "冗长",
+		"frustration.model-rambling-title": "超过冗长阈值的回合",
+		"frustration.model-unscored-line": "使用无词典语言的回合：{count} — 未评分，而非平静。",
+		"frustration.model-by-model": "各模型版本的 AI 崩溃度",
+		"frustration.model-table-title": "模型崩溃明细",
+		"frustration.model-by-model-description": "每个模型已分析回合中带崩溃信号的占比。色相 = 模型家族。",
+		"frustration.model-over-time": "AI 崩溃度随时间变化",
+		"frustration.model-over-time-description":
+			"每个时间桶的崩溃率：带信号的回合除以已分析回合。空白表示该桶没有回合。",
+		"frustration.model-sessions": "按崩溃度查看会话",
+		"frustration.model-sessions-description": "已分析助手回合最多的会话。",
+		"frustration.model-table-description": "比例为已分析助手回合的占比。",
+		"frustration.column-session": "会话",
+		"frustration.column-turns": "回合数",
+		"frustration.column-mean": "信号/回合",
+		"frustration.column-tool-errors": "工具错误",
+		"frustration.model-no-turns": "该时间范围内没有带文本的助手回合",
+		"frustration.model-try-longer-range": "试试更长的时间范围。",
+		"frustration.model-legend-breakdown": "崩溃率",
+		"frustration.turns-n": "{count} 个回合",
+		"frustration.model-hint-mean": "平均每回合 {value} 个信号",
 	},
 } as const;

package/src/client/i18n/useLocale.ts

@@ -0,0 +1,11 @@
+import { useSyncExternalStore } from "react";
+import { getLocale, subscribeLocale, type StatsLocale } from "./index";
+
+/**
+ * Subscribe a component to the active locale. `t()` reads the module-level
+ * catalogue, so a component that renders translated copy must call this —
+ * the topbar switch re-renders subscribers, and everything under them.
+ */
+export function useLocale(): StatsLocale {
+	return useSyncExternalStore(subscribeLocale, getLocale, getLocale);
+}