feat(stats): add autocomplete entry and time-axis groupBy in UI

Author: k1yt

src/services/command/__tests__/built-in-commands.spec.ts

@@ -5,8 +5,8 @@ describe("Built-in Commands", () => {
 		it("should return all built-in commands", async () => {
 			const commands = await getBuiltInCommands()
 
-			expect(commands).toHaveLength(1)
-			expect(commands.map((cmd) => cmd.name)).toEqual(expect.arrayContaining(["init"]))
+			expect(commands).toHaveLength(2)
+			expect(commands.map((cmd) => cmd.name)).toEqual(expect.arrayContaining(["init", "stats"]))
 
 			// Verify all commands have required properties
 			commands.forEach((command) => {
@@ -63,10 +63,10 @@ describe("Built-in Commands", () => {
 		it("should return all built-in command names", async () => {
 			const names = await getBuiltInCommandNames()
 
-			expect(names).toHaveLength(1)
-			expect(names).toEqual(expect.arrayContaining(["init"]))
+			expect(names).toHaveLength(2)
+			expect(names).toEqual(expect.arrayContaining(["init", "stats"]))
 			// Order doesn't matter since it's based on filesystem order
-			expect(names.sort()).toEqual(["init"])
+			expect(names.sort()).toEqual(["init", "stats"])
 		})
 
 		it("should return array of strings", async () => {
@@ -99,5 +99,21 @@ describe("Built-in Commands", () => {
 			expect(content).toContain("rules-ask")
 			expect(content).toContain("rules-architect")
 		})
+
+		it("stats command should expose the /stats token for ChatView interception", async () => {
+			const command = await getBuiltInCommand("stats")
+
+			expect(command).toBeDefined()
+			expect(command!.name).toBe("stats")
+			expect(command!.source).toBe("built-in")
+			expect(command!.filePath).toBe("<built-in:stats>")
+			// Content must be the literal "/stats" so that ChatView's
+			// exact-match interception (text === "/stats") fires when the
+			// user picks this autocomplete entry.
+			expect(command!.content).toBe("/stats")
+			expect(command!.description).toBe(
+				"Open the local usage statistics panel (token usage by model, provider, mode, and time range)",
+			)
+		})
 	})
 })

src/services/command/built-in-commands.ts

@@ -8,6 +8,16 @@ interface BuiltInCommandDefinition {
 }
 
 const BUILT_IN_COMMANDS: Record<string, BuiltInCommandDefinition> = {
+	stats: {
+		name: "stats",
+		description: "Open the local usage statistics panel (token usage by model, provider, mode, and time range)",
+		// Content is the literal "/stats" token so that ChatView's exact-match
+		// interception (text === "/stats") fires when the user picks this
+		// autocomplete entry. A non-empty content is required by the Command
+		// type and also prevents the trimmed input from becoming empty, which
+		// would bypass the interception. No prompt body is sent to the LLM.
+		content: "/stats",
+	},
 	init: {
 		name: "init",
 		description: "Analyze codebase and create concise AGENTS.md files for AI assistants",

webview-ui/src/components/stats/StatsView.tsx

@@ -25,7 +25,7 @@ import UsageHeatmap from "./UsageHeatmap"
 // ── Types ───────────────────────────────────────────────────────────────────
 
 type StatsPreset = "today" | "7d" | "30d" | "all"
-type GroupByOption = "model" | "provider" | "mode" | "status"
+type GroupByOption = "model" | "provider" | "mode" | "status" | "day" | "week" | "month"
 
 interface StatsViewProps {
 	onDone: () => void
@@ -413,8 +413,18 @@ const StatsView = memo(({ onDone }: StatsViewProps) => {
 								<h4 className="text-sm font-medium text-vscode-foreground m-0">
 									{t("stats:breakdown.title")}
 								</h4>
-								<div className="flex gap-1">
-									{(["model", "provider", "mode", "status"] as GroupByOption[]).map((g) => (
+								<div className="flex flex-wrap gap-1">
+									{(
+										[
+											"model",
+											"provider",
+											"mode",
+											"status",
+											"day",
+											"week",
+											"month",
+										] as GroupByOption[]
+									).map((g) => (
 										<Button
 											key={g}
 											variant={groupBy === g ? "primary" : "ghost"}

webview-ui/src/i18n/locales/en/stats.json

@@ -21,6 +21,9 @@
     "provider": "Provider",
     "mode": "Mode",
     "status": "Status",
+    "day": "Day",
+    "week": "Week",
+    "month": "Month",
     "events": "Events",
     "completed": "Completed",
     "failed": "Failed",