pi-deepseek-tariff 0.1.0 → 0.3.1

package/README.md

@@ -3,12 +3,15 @@
 [![npm](https://img.shields.io/npm/v/pi-deepseek-tariff?color=blue)](https://www.npmjs.com/package/pi-deepseek-tariff)
 [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![pi-package](https://img.shields.io/badge/pi-package-8a2be2)](https://pi.dev/packages)
+[![changelog](https://img.shields.io/badge/changelog-Keep%20a%20Changelog-orange)](CHANGELOG.md)
 
 A [pi](https://pi.dev) extension that shows the current **DeepSeek API tariff window** — peak or off-peak — with a countdown, and a panel with live prices parsed from the official DeepSeek pricing page.
 
 DeepSeek charges double during peak hours, so knowing the current window is worth real money.
 
 ```
+● DeepSeek Off-peak for 11h 59m          ← footer line, always visible
+
 Now OFF-PEAK
 Computer: 14:43:52 26-10-2026(MSK) | UTC: 2026-10-26 11:43
 Next window: 04:00 - 07:00 27-10-2026(MSK) in 13h 16m
@@ -25,18 +28,18 @@ Peak windows (MSK): 04:00-07:00 and 09:00-13:00, Mon-Fri
 Off-peak = night, weekends and Chinese holidays
 Price source: api-docs.deepseek.com, updated 11:20 26-10 (next in 5h 59m)
 ────────────────────────────────────────────────────────────
-Commands: /deepseek-peak on|off|refresh|en|ru
+Commands: /dsp on|off|refresh|en|ru · /dsp footer on|off
 ```
 
 ## Install
 
 ```bash
-# from git (tags are pinned)
-pi install git:github.com/valderan/pi-deepseek-tariff@v0.1.0
-
-# from npm
+# from npm (always the `latest` dist-tag)
 pi install npm:pi-deepseek-tariff
 
+# from git: tags mirror the npm versions, so pin whichever you want
+pi install git:github.com/valderan/pi-deepseek-tariff@v0.3.0
+
 # local checkout, for development
 git clone git@github.com:valderan/pi-deepseek-tariff.git
 pi install ./pi-deepseek-tariff
@@ -45,20 +48,27 @@ pi install ./pi-deepseek-tariff
 pi -e ./pi-deepseek-tariff
 ```
 
-Then run `/deepseek-peak`. Afterwards `pi list`, `pi update --extensions`, `pi remove …` manage it like any other package.
+Then run `/dsp`. Afterwards `pi list`, `pi update --extensions`, `pi remove …` manage it like any other package.
 
 ## Commands
 
+`/dsp` is the short form of the command. The full name `/deepseek-peak` works too, and `/deepseek-peek` is accepted for muscle memory.
+
 | Command | Effect |
 |---|---|
-| `/deepseek-peak` | toggle the panel |
-| `/deepseek-peak on` / `off` | show or hide it |
-| `/deepseek-peak refresh` | re-parse prices from the docs page now |
-| `/deepseek-peak en` / `ru` | switch the panel language (persisted) |
+| `/dsp` | toggle the panel |
+| `/dsp on` / `off` | show or hide the panel (the footer line stays while a DeepSeek model is active) |
+| `/dsp refresh` | re-parse prices from the docs page now |
+| `/dsp en` / `ru` | switch the panel language (persisted) |
+| `/dsp footer on` / `off` (or `/dsp footeron` / `footeroff`) | show or hide the footer line (persisted) |
 
 ## What it does
 
-- **Footer line** — `deepseek: PEAK → off-peak 13:00 (1h 40m)`. Shown only while a DeepSeek model is active; red for peak, green for off-peak.
+- **Footer line** — one compact status line: `● DeepSeek Off-peak for 11h 59m`, or `● DeepSeek Peak for 1h 40m` during peak. The text is always yellow and only the dot changes colour — green for off-peak, red for peak. Shown only while a DeepSeek model is active; `/dsp footer off` hides it for good.
+
+  Russian looks like `● DeepSeek Обычный ещё 11ч 59м` / `● DeepSeek Пиковый ещё 1ч 40м`.
+
+  Pi renders every extension status on a single footer line, joined alphabetically, so the segment is kept short.
 - **Peak rules** — DeepSeek defines peak as `01:00-04:00` and `06:00-10:00` **UTC, Monday to Friday**; weekends and Chinese public holidays are off-peak all day.
 - **Local time everywhere** — the UTC clock comes from the machine clock, so peak windows, weekday labels and countdowns are rendered in *your* zone (`(MSK)`, `(UTC-04:00)`, …). Weekday labels shift with the zone: at UTC−4 the windows land on Sun–Thu.
 - **Prices** — parsed from `api-docs.deepseek.com/quick_start/pricing/`: cache hit, cache miss and output per model, plus the Search & Fetch request rates. The tariff in effect is highlighted.
@@ -74,6 +84,7 @@ Then run `/deepseek-peak`. Afterwards `pi list`, `pi update --extensions`, `pi r
   "intervalMs": 30000,
   "pricingTtlHours": 6,
   "alwaysShow": false,
+  "footer": true,
   "models": ["deepseek"],
   "providerPrefix": "deepseek:",
   "holidays": ["2026-10-01", "2026-10-02"]
@@ -86,6 +97,7 @@ Then run `/deepseek-peak`. Afterwards `pi list`, `pi update --extensions`, `pi r
 | `intervalMs` | `30000` | minimum refresh cadence (clamped to ≥ 5000) |
 | `pricingTtlHours` | `6` | how long parsed prices stay valid |
 | `alwaysShow` | `false` | show the footer line for non-DeepSeek models too |
+| `footer` | `true` | show the footer status line at all; `/dsp footer off` writes this |
 | `models` | `["deepseek"]` | id substrings that count as DeepSeek |
 | `providerPrefix` | `"deepseek:"` | prefix used when printing model ids |
 | `holidays` | `[]` | Chinese public holidays as Beijing dates (`YYYY-MM-DD`), off-peak all day |
@@ -117,12 +129,41 @@ The rules and parsing modules are pure and take injectable inputs, so tests neve
 
 ## Release
 
+Git tags and npm versions are kept in lockstep: the tag `vX.Y.Z` always points at
+the commit whose `package.json` says `X.Y.Z`, and npm publishes that same version.
+
 ```bash
-git tag -a v0.1.0 -m "v0.1.0"
+# 1. bump package.json, add a CHANGELOG entry, commit
+npm version 0.3.2 --no-git-tag-version     # or edit by hand
+git commit -am "chore: release 0.3.2"
+
+# 2. tag the release commit and push
+git tag -a v0.3.2 -m v0.3.2
 git push origin main --tags
+
+# 3. publish the tag to npm (2FA prompt, or --otp=123456)
+npm publish --access public
+```
+
+`npm publish` sets the `latest` dist-tag automatically for a plain semver version.
+Check the result:
+
+```bash
+npm view pi-deepseek-tariff dist-tags    # { latest: '0.3.2' }
+npm view pi-deepseek-tariff versions
 ```
 
-Tags are pinnable with `pi install git:…@v0.1.0`. Publishing to npm (`.github/workflows/ci.yml` runs it on a `v*` tag) puts the package into the [pi package gallery](https://pi.dev/packages).
+`.github/workflows/ci.yml` can publish on a `v*` tag instead of step 3 when the
+`NPM_TOKEN` secret is configured; with trusted publishing enabled on npmjs.com the
+token is not needed at all and the build is signed with provenance.
+
+Tags are pinnable with `pi install git:…@v0.3.2`. Published versions show up in the
+[pi package gallery](https://pi.dev/packages) through the `pi-package` keyword.
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md). Git tags and npm versions are kept in lockstep, so
+`vX.Y.Z` always matches the published `X.Y.Z`.
 
 ## License
 

package/extensions/deepseek-peak.ts

@@ -40,7 +40,7 @@ export default function deepseekPeak(pi: ExtensionAPI) {
 	};
 
 	const renderFooter = (ctx: ExtensionContext | ExtensionCommandContext, current: Pricing = pricing.get()) => {
-		if (!config.alwaysShow && !isDeepSeekModel(ctx)) {
+		if (!config.footer || (!config.alwaysShow && !isDeepSeekModel(ctx))) {
 			ctx.ui.setStatus(STATUS_KEY, undefined);
 			return;
 		}
@@ -117,41 +117,61 @@ export default function deepseekPeak(pi: ExtensionAPI) {
 	pi.on("agent_start", async (_event, ctx) => render(ctx));
 	pi.on("turn_start", async (_event, ctx) => render(ctx));
 
-	pi.registerCommand("deepseek-peak", {
-		description: "DeepSeek peak/off-peak panel · Панель DeepSeek peak/off-peak",
-		handler: async (args, ctx) => {
-			config = loadConfig();
-			lang = config.language ?? "en";
-			pricing.setTtl(ttlMs());
-			const arg = args.trim().toLowerCase();
-
-			if (arg === "ru" || arg === "en") {
-				lang = arg;
-				config.language = arg;
-				saveConfig({ language: arg });
-				panelVisible = true;
-				render(ctx);
-				return;
-			}
+	const commandHandler = async (args: string, ctx: ExtensionCommandContext) => {
+		config = loadConfig();
+		lang = config.language ?? "en";
+		pricing.setTtl(ttlMs());
+		const parts = args.trim().toLowerCase().split(/\s+/).filter(Boolean);
+		const arg = parts[0] ?? "";
+		const option = parts[1] ?? "";
+
+		// Footer line: /dsp footer on|off, or the one-word /dsp footeron|footeroff.
+		if (arg === "footer" || arg === "footeron" || arg === "footeroff") {
+			const next =
+				arg === "footeron" ? true : arg === "footeroff" ? false : option === "on" ? true : option === "off" ? false : !config.footer;
+			config.footer = next;
+			saveConfig({ footer: next });
+			render(ctx);
+			ctx.ui.notify(
+				next ? "DeepSeek footer line: on · Строка футера: вкл" : "DeepSeek footer line: off · Строка футера: выкл",
+				"info",
+			);
+			return;
+		}
 
-			if (arg === "off" || (arg === "" && panelVisible)) {
-				panelVisible = false;
-				ctx.ui.setWidget(WIDGET_KEY, undefined);
-				renderFooter(ctx);
-				return;
-			}
+		if (arg === "ru" || arg === "en") {
+			lang = arg;
+			config.language = arg;
+			saveConfig({ language: arg });
+			panelVisible = true;
+			render(ctx);
+			return;
+		}
 
-			if (arg === "refresh") {
-				const value = await pricing.refresh(true);
-				panelVisible = true;
-				render(ctx, value);
-				return;
-			}
+		if (arg === "off" || (arg === "" && panelVisible)) {
+			panelVisible = false;
+			ctx.ui.setWidget(WIDGET_KEY, undefined);
+			renderFooter(ctx);
+			return;
+		}
 
+		if (arg === "refresh") {
+			const value = await pricing.refresh(true);
 			panelVisible = true;
-			render(ctx);
-		},
-	});
+			render(ctx, value);
+			return;
+		}
+
+		panelVisible = true;
+		render(ctx);
+	};
+
+	const description = "DeepSeek peak/off-peak panel · Панель DeepSeek peak/off-peak";
+	// `/dsp` is the short form; `deepseek-peek` accepts the spelling people reach
+	// for when they type "peak" wrong, so the command still resolves.
+	for (const name of ["deepseek-peak", "dsp", "deepseek-peek"]) {
+		pi.registerCommand(name, { description, handler: commandHandler });
+	}
 }
 
 export { STRINGS };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-deepseek-tariff",
-  "version": "0.1.0",
+  "version": "0.3.1",
   "description": "DeepSeek peak/off-peak tariff panel for pi: local clock, next window, live per-model prices and Search & Fetch rates",
   "keywords": [
     "pi-package",
@@ -30,7 +30,8 @@
   "pi": {
     "extensions": [
       "./extensions/deepseek-peak.ts"
-    ]
+    ],
+    "image": "https://raw.githubusercontent.com/valderan/pi-deepseek-tariff/main/assets/banner.png"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "*",

package/src/config.ts

@@ -21,6 +21,7 @@ export type Config = {
 	intervalMs: number;
 	pricingTtlHours: number;
 	alwaysShow: boolean;
+	footer: boolean;
 	models: string[];
 	providerPrefix: string;
 	holidays: Set<string>;
@@ -41,6 +42,7 @@ export function loadConfig(): Config {
 		intervalMs: 30_000,
 		pricingTtlHours: DEFAULT_TTL_HOURS,
 		alwaysShow: false,
+		footer: true,
 		models: ["deepseek"],
 		providerPrefix: "deepseek:",
 		holidays: new Set<string>(),
@@ -54,6 +56,7 @@ export function loadConfig(): Config {
 			config.pricingTtlHours = raw.pricingTtlHours;
 		}
 		if (typeof raw.alwaysShow === "boolean") config.alwaysShow = raw.alwaysShow;
+		if (typeof raw.footer === "boolean") config.footer = raw.footer;
 		if (typeof raw.providerPrefix === "string" && raw.providerPrefix.length > 0) {
 			config.providerPrefix = raw.providerPrefix;
 		}

package/src/i18n.ts

@@ -34,6 +34,10 @@ type Strings = {
 	sourceBuiltin: string;
 	requestPricing: string;
 	commands: string;
+	statusBrand: string;
+	statusPeak: string;
+	statusOffPeak: string;
+	statusFor: (duration: string) => string;
 	locale: string;
 	hourUnit: string;
 	minuteUnit: string;
@@ -60,6 +64,10 @@ export const STRINGS: Record<Lang, Strings> = {
 		sourceBuiltin: "built-in values (page unavailable)",
 		requestPricing: "Search & Fetch:",
 		commands: "Commands:",
+		statusBrand: "DeepSeek",
+		statusPeak: "Peak",
+		statusOffPeak: "Off-peak",
+		statusFor: (duration) => `for ${duration}`,
 		locale: "en-GB",
 		hourUnit: "h",
 		minuteUnit: "m",
@@ -84,6 +92,10 @@ export const STRINGS: Record<Lang, Strings> = {
 		sourceBuiltin: "встроенные значения (страница недоступна)",
 		requestPricing: "Search & Fetch:",
 		commands: "Команды:",
+		statusBrand: "DeepSeek",
+		statusPeak: "Пиковый",
+		statusOffPeak: "Обычный",
+		statusFor: (duration) => `ещё ${duration}`,
 		locale: "ru-RU",
 		hourUnit: "ч",
 		minuteUnit: "м",

package/src/view.ts

@@ -10,7 +10,6 @@ import type { Config } from "./config.ts";
 import { localizeUnit, STRINGS, type Lang } from "./i18n.ts";
 import type { Pricing, RequestPricing } from "./pricing.ts";
 import {
-	clockTime,
 	dayRangeLabel,
 	humanize,
 	isHoliday,
@@ -54,16 +53,21 @@ export function requestPricingText(entries: RequestPricing[], lang: Lang): strin
 	return `${parts.join(" · ")}${sharedUnit ? ` ${localized(sharedUnit)}` : ""}`.trim();
 }
 
+/**
+ * Compact footer line: a coloured dot plus always-yellow text, for example
+ * "● DeepSeek Off-peak for 11h 59m" or "● DeepSeek Peak for 1h 40m".
+ * Only the dot changes colour, so the line reads calmly in both states.
+ */
 export function statusText(theme: Theme, config: Config, lang: Lang, pricing: Pricing): string {
 	void pricing;
+	const text = STRINGS[lang];
 	const now = new Date();
 	const peak = isPeak(now, config.holidays);
 	const next = nextTransition(now, config.holidays);
-	const label = peak ? "PEAK" : "off-peak";
-	const color = theme.fg(peak ? "error" : "success", label);
-	const hint = peak ? "→ off-peak" : "→ peak";
-	const when = `${clockTime(next, lang)} (${humanize(next.getTime() - now.getTime(), lang)})`;
-	return `${theme.fg("dim", "deepseek:")} ${color} ${theme.fg("dim", `${hint} ${when}`)}`;
+	const dot = theme.fg(peak ? "error" : "success", "●");
+	const label = peak ? text.statusPeak : text.statusOffPeak;
+	const duration = humanize(next.getTime() - now.getTime(), lang);
+	return `${dot} ${theme.fg("warning", `${text.statusBrand} ${label} ${text.statusFor(duration)}`)}`;
 }
 
 export function panelLines(
@@ -153,7 +157,7 @@ export function panelLines(
 	lines.push(SEPARATOR);
 
 	// 8. Command hints.
-	lines.push(`${theme.fg("dim", text.commands)} ${white("/deepseek-peak on|off|refresh|en|ru")}`);
+	lines.push(`${theme.fg("dim", text.commands)} ${white("/dsp on|off|refresh|en|ru · /dsp footer on|off")}`);
 
 	return lines;
 }