@tmustier/pi-usage-extension 0.9.5 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.10.0] - 2026-10-26
+
+### Added
+- **This Month period.** New tab between Last Week and Last 30 Days covering the current calendar month from local midnight on the 1st, in the graph, table, insights, and exports. Useful when a usage budget resets on the 1st of each month.
+
+### Fixed
+- Collapse Windows home directories in project labels. Backslash paths are normalised, `C:\Users\<name>\...` collapses to `~/...` like `/Users/<name>` and `/home/<name>`, and other drive paths drop the drive letter (`D:\work\repo` becomes `work/repo`). Previously the project mix insight showed raw Windows paths.
+- Make the usage tests pass on Windows.
+
+Thanks to @mturley for This Month ([#114](https://github.com/tmustier/pi-extensions/pull/114), requested in [#107](https://github.com/tmustier/pi-extensions/issues/107)) and @dawidmachon for the Windows fix ([#110](https://github.com/tmustier/pi-extensions/pull/110)).
+
 ## [0.9.5] - 2026-09-22
 
 ### Changed

package/README.md

@@ -136,7 +136,7 @@ The **Graphs** view plots usage over time for the active period as a braille lin
 - **Grouping** (`g` to cycle): by provider, by model, by thinking level, or total only. The top 6 series are shown individually; the rest merge into an `other` series. A bold **Total** line is always drawn.
 - **Cumulative vs per-bucket** (`c` to toggle): running total across the period (default), or the raw per-bucket rate.
 - **Filtering**: move the legend cursor with `↑`/`↓` and toggle series visibility with `Enter`/`Space` (`a` shows all again). The y-axis rescales to the visible series — hide the big lines to zoom into the small ones.
-- **Buckets**: hourly for Today / This Week / Last Week, daily for Last 30 Days / All Time.
+- **Buckets**: hourly for Today / This Week / Last Week (and This Month during its first 8 days), daily for This Month after its first 8 days / Last 30 Days / All Time.
 - **Line clipping**: every series (provider, model, thinking level, `other`, Total) is drawn only between its first and last bucket with usage, so late-starting or retired series don't drag a flat zero/flat tail across the whole period.
 
 Thinking levels are replayed from `thinking_level_change` entries in each session file; messages before the first recorded change appear as `unknown`. Auxiliary usage has no reliable thinking-level attribution and appears as `Tools/summaries` in that grouping. Reasoning token counts come from `usage.reasoning` where providers report them; pi only records this field since **pi 0.80.3 (30 June 2026)**, so earlier sessions show zero reasoning tokens even though thinking models were in use.
@@ -148,6 +148,7 @@ Thinking levels are replayed from `thinking_level_change` entries in each sessio
 | **Today** | From midnight (00:00) today |
 | **This Week** | From Monday 00:00 of the current week |
 | **Last Week** | Previous week (Monday 00:00 → this Monday 00:00) |
+| **This Month** | From local midnight on the first day of the current month |
 | **Last 30 Days** | Rolling window: the last 30 calendar days including today (from midnight 29 days back) |
 | **All Time** | All recorded sessions |
 

package/data.ts

@@ -149,6 +149,7 @@ export interface PeriodBounds {
 	todayMs: number;
 	weekStartMs: number;
 	lastWeekStartMs: number;
+	thisMonthStartMs: number;
 	last30DaysStartMs: number;
 	nowMs: number;
 }
@@ -157,6 +158,7 @@ export interface UsageData {
 	today: TimeFilteredStats;
 	thisWeek: TimeFilteredStats;
 	lastWeek: TimeFilteredStats;
+	thisMonth: TimeFilteredStats;
 	last30Days: TimeFilteredStats;
 	allTime: TimeFilteredStats;
 	/** Deduped usage bucketed by hour start (ms) → series key → metrics. */
@@ -164,9 +166,9 @@ export interface UsageData {
 	bounds: PeriodBounds;
 }
 
-export type TabName = "today" | "thisWeek" | "lastWeek" | "last30Days" | "allTime";
+export type TabName = "today" | "thisWeek" | "lastWeek" | "thisMonth" | "last30Days" | "allTime";
 
-export const TAB_ORDER: TabName[] = ["today", "thisWeek", "lastWeek", "last30Days", "allTime"];
+export const TAB_ORDER: TabName[] = ["today", "thisWeek", "lastWeek", "thisMonth", "last30Days", "allTime"];
 
 export type UsageSource = "assistant" | "auxiliary";
 
@@ -1038,23 +1040,32 @@ function emptyPeriodRawData(): PeriodRawData {
  */
 export function projectLabelFromCwd(cwd: string): string {
 	if (!cwd) return "(unknown)";
+	// Normalize Windows separators so backslash paths (C:\Users\me\...) match the
+	// forward-slash forms compared below. Path text after the home prefix keeps
+	// its normalized forward slashes, which is what the label displays.
+	const normalized = cwd.replaceAll("\\", "/");
 	// Collapse any home-directory prefix to "~", not just the current user's —
 	// session stores merged from other machines can carry a different username.
-	const home = homedir();
+	const home = homedir().replaceAll("\\", "/");
 	let homePrefix: string | null = null;
-	if (cwd === home || cwd.startsWith(home + "/")) {
+	if (normalized === home || normalized.startsWith(home + "/")) {
 		homePrefix = home;
 	} else {
-		const m = /^(\/Users\/[^/]+|\/home\/[^/]+)(?=\/|$)/.exec(cwd);
+		const m = /^(\/Users\/[^/]+|\/home\/[^/]+|[A-Za-z]:\/Users\/[^/]+)(?=\/|$)/.exec(normalized);
 		if (m) homePrefix = m[1]!;
 	}
-	if (homePrefix !== null && cwd.length <= homePrefix.length) return "~";
-	let rel = homePrefix !== null ? cwd.slice(homePrefix.length + 1) : cwd;
+	if (homePrefix !== null && normalized.length <= homePrefix.length) return "~";
+	let rel = homePrefix !== null ? normalized.slice(homePrefix.length + 1) : normalized;
 	const wt = rel.indexOf("/.worktrees/");
 	if (wt !== -1) rel = rel.slice(0, wt);
 	const parts = rel.split("/").filter(Boolean);
-	const label = parts.slice(0, 2).join("/");
-	return homePrefix !== null ? `~/${label}` : `/${label}`;
+	if (homePrefix !== null) return `~/${parts.slice(0, 2).join("/")}`;
+	// Windows drive paths outside a home (D:/work/repo/sub): drop the drive segment
+	// so the label keeps meaningful segments (work/repo) and stays slash-separated.
+	const segments = /^[A-Za-z]:$/.test(parts[0] ?? "") ? parts.slice(1) : parts;
+	const label = segments.slice(0, 2).join("/");
+	if (/^[A-Za-z]:\//.test(normalized)) return label;
+	return `/${label}`;
 }
 
 function emptyUsageData(bounds: PeriodBounds): UsageData {
@@ -1062,6 +1073,7 @@ function emptyUsageData(bounds: PeriodBounds): UsageData {
 		today: emptyTimeFilteredStats(),
 		thisWeek: emptyTimeFilteredStats(),
 		lastWeek: emptyTimeFilteredStats(),
+		thisMonth: emptyTimeFilteredStats(),
 		last30Days: emptyTimeFilteredStats(),
 		allTime: emptyTimeFilteredStats(),
 		hourly: new Map(),
@@ -1115,6 +1127,7 @@ function getPeriodsForTimestamp(
 	todayMs: number,
 	weekStartMs: number,
 	lastWeekStartMs: number,
+	thisMonthStartMs: number,
 	last30DaysStartMs: number
 ): TabName[] {
 	const periods: TabName[] = ["allTime"];
@@ -1124,6 +1137,7 @@ function getPeriodsForTimestamp(
 	} else if (timestamp >= lastWeekStartMs) {
 		periods.push("lastWeek");
 	}
+	if (timestamp >= thisMonthStartMs) periods.push("thisMonth");
 	if (timestamp >= last30DaysStartMs) periods.push("last30Days");
 	return periods;
 }
@@ -1140,11 +1154,12 @@ function addMessagesToUsageData(
 	todayMs: number,
 	weekStartMs: number,
 	lastWeekStartMs: number,
+	thisMonthStartMs: number,
 	last30DaysStartMs: number,
 	rawByPeriod: Record<TabName, PeriodRawData>,
 	costByDayIdx: Map<number, number>
 ): void {
-	const sessionContributed = { today: false, thisWeek: false, lastWeek: false, last30Days: false, allTime: false };
+	const sessionContributed = { today: false, thisWeek: false, lastWeek: false, thisMonth: false, last30Days: false, allTime: false };
 
 	for (let mi = 0; mi < messages.length; mi++) {
 		const msg = messages[mi]!;
@@ -1161,7 +1176,14 @@ function addMessagesToUsageData(
 
 		addToHourlyBuckets(data.hourly, msg);
 
-		const periods = getPeriodsForTimestamp(msg.timestamp, todayMs, weekStartMs, lastWeekStartMs, last30DaysStartMs);
+		const periods = getPeriodsForTimestamp(
+			msg.timestamp,
+			todayMs,
+			weekStartMs,
+			lastWeekStartMs,
+			thisMonthStartMs,
+			last30DaysStartMs
+		);
 		const tokens = {
 			// Count fresh tokens processed this turn.
 			// Include cacheWrite because those prompt tokens were newly written and billed.
@@ -1240,6 +1262,7 @@ function addMessagesToUsageData(
 	if (sessionContributed.today) data.today.totals.sessions++;
 	if (sessionContributed.thisWeek) data.thisWeek.totals.sessions++;
 	if (sessionContributed.lastWeek) data.lastWeek.totals.sessions++;
+	if (sessionContributed.thisMonth) data.thisMonth.totals.sessions++;
 	if (sessionContributed.last30Days) data.last30Days.totals.sessions++;
 	if (sessionContributed.allTime) data.allTime.totals.sessions++;
 }
@@ -1397,6 +1420,12 @@ export async function collectUsageData(options: CollectUsageOptions = {}): Promi
 	startOfLastWeek.setDate(startOfLastWeek.getDate() - 7);
 	const lastWeekStartMs = startOfLastWeek.getTime();
 
+	// Calendar month to date, from local midnight on the first.
+	const startOfThisMonth = new Date(now);
+	startOfThisMonth.setDate(1);
+	startOfThisMonth.setHours(0, 0, 0, 0);
+	const thisMonthStartMs = startOfThisMonth.getTime();
+
 	// Rolling 30-day window: the last 30 calendar days including today,
 	// i.e. from midnight 29 days before today. setDate handles DST correctly.
 	const startOfLast30Days = new Date(startOfToday);
@@ -1526,11 +1555,19 @@ export async function collectUsageData(options: CollectUsageOptions = {}): Promi
 	}
 
 	// 6. Aggregate in sorted path order with cross-file dedupe.
-	const data = emptyUsageData({ todayMs, weekStartMs, lastWeekStartMs, last30DaysStartMs, nowMs: now.getTime() });
+	const data = emptyUsageData({
+		todayMs,
+		weekStartMs,
+		lastWeekStartMs,
+		thisMonthStartMs,
+		last30DaysStartMs,
+		nowMs: now.getTime(),
+	});
 	const rawByPeriod: Record<TabName, PeriodRawData> = {
 		today: emptyPeriodRawData(),
 		thisWeek: emptyPeriodRawData(),
 		lastWeek: emptyPeriodRawData(),
+		thisMonth: emptyPeriodRawData(),
 		last30Days: emptyPeriodRawData(),
 		allTime: emptyPeriodRawData(),
 	};
@@ -1597,6 +1634,7 @@ export async function collectUsageData(options: CollectUsageOptions = {}): Promi
 			todayMs,
 			weekStartMs,
 			lastWeekStartMs,
+			thisMonthStartMs,
 			last30DaysStartMs,
 			rawByPeriod,
 			costByDayIdx

package/graph.ts

@@ -118,6 +118,8 @@ function domainFor(period: TabName, bounds: PeriodBounds, hourly: Map<number, Ma
 			return { startMs: bounds.weekStartMs, endMs: bounds.nowMs };
 		case "lastWeek":
 			return { startMs: bounds.lastWeekStartMs, endMs: bounds.weekStartMs };
+		case "thisMonth":
+			return { startMs: bounds.thisMonthStartMs, endMs: bounds.nowMs };
 		case "last30Days":
 			return { startMs: bounds.last30DaysStartMs, endMs: bounds.nowMs };
 		case "allTime": {

package/index.ts

@@ -2,7 +2,7 @@
  * /usage - Usage statistics dashboard
  *
  * Shows an inline view with usage stats grouped by provider.
- * - Tab cycles: Today → This Week → Last Week → All Time
+ * - Tab cycles: Today → This Week → Last Week → This Month → All Time
  * - Arrow keys navigate providers
  * - Enter expands/collapses to show models
  *
@@ -273,6 +273,7 @@ const TAB_LABELS: Record<TabName, string> = {
 	today: "Today",
 	thisWeek: "This Week",
 	lastWeek: "Last Week",
+	thisMonth: "This Month",
 	last30Days: "Last 30 Days",
 	allTime: "All Time",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-usage-extension",
-  "version": "0.9.5",
+  "version": "0.10.0",
   "description": "Usage statistics dashboard for Pi sessions.",
   "license": "MIT",
   "author": "Thomas Mustier",