oc-deepseek-pricing 0.1.0 → 0.1.1

package/README.md

@@ -2,13 +2,14 @@
 
 An OpenCode v2 TUI plugin that displays the current DeepSeek API pricing window in the prompt footer and session sidebar.
 
-The indicator is intended for the direct DeepSeek provider. DeepSeek off-peak rates are half of peak rates.
+The indicator is shown when the selected model ID contains `deepseek`. DeepSeek off-peak rates are half of peak rates.
 
 ## Features
 
 - Displays the current pricing window in the prompt footer.
-- Displays pricing details in the session sidebar.
-- Distinguishes peak and off-peak periods.
+- Displays a compact pricing status in the session sidebar.
+- Exposes complete pricing details through `/deepseek-pricing`.
+- Distinguishes peak and off-peak periods with whale emoji indicators.
 - Shows the next pricing transition and a countdown.
 - Treats weekends as fully off-peak.
 - Supports Chinese public-holiday overrides.
@@ -19,23 +20,44 @@ The indicator is intended for the direct DeepSeek provider. DeepSeek off-peak ra
 
 Peak windows are evaluated in UTC:
 
-- `01:00-04:00 UTC`, Monday through Friday.
-- `06:00-10:00 UTC`, Monday through Friday.
+- 01:00-04:00 UTC, Monday through Friday;
+- 06:00-10:00 UTC, Monday through Friday.
 
 All other times are off-peak, including:
 
-- `04:00-06:00 UTC` on weekdays;
-- all hours after `10:00 UTC` and before `01:00 UTC`;
+- 04:00-06:00 UTC on weekdays;
+- all hours after 10:00 UTC and before 01:00 UTC;
 - Saturdays and Sundays in full;
 - Chinese public holidays in full.
 
-The off-peak price multiplier is `0.5`.
+The off-peak price multiplier is 0.5.
+
+## Installation
+
+Install the published plugin directly with the OpenCode CLI:
+
+```sh
+opencode plugin add oc-deepseek-pricing
+```
+
+To install this exact release:
+
+```sh
+opencode plugin add oc-deepseek-pricing@0.1.0
+```
+
+OpenCode registers the plugin automatically. No manual change to `cli.json`, `opencode.json`, or `tui.jsonc` is required.
+
+Verify the installation with:
+
+```sh
+opencode plugin list
+```
 
 ## Requirements
 
-- OpenCode v2 with TUI plugin support.
-- Bun.
-- A terminal supported by OpenCode.
+- OpenCode v2 with TUI plugin support;
+- a terminal supported by OpenCode.
 
 Development dependencies include:
 
@@ -50,6 +72,7 @@ Development dependencies include:
 ```text
 oc-deepseek-pricing/
 ├── CALENDAR_UPDATE.md
+├── LICENSE
 ├── README.md
 ├── bun.lock
 ├── package.json
@@ -58,7 +81,8 @@ oc-deepseek-pricing/
 │   ├── pricing.test.ts
 │   ├── pricing.ts
 │   └── tui.tsx
-└── tsconfig.json
+├── tsconfig.json
+└── tui.ts
 ```
 
 ## Development setup
@@ -69,10 +93,10 @@ Install dependencies:
 bun install
 ```
 
-Run the TypeScript check:
+Run all validation checks:
 
 ```sh
-bun check
+bun run check
 ```
 
 Run the test suite:
@@ -81,86 +105,60 @@ Run the test suite:
 bun test
 ```
 
-A successful validation should complete without TypeScript errors and with all pricing tests passing.
+A successful validation completes without formatting, lint, TypeScript, or test errors.
 
-## OpenCode CLI configuration
+## Restarting OpenCode
 
-Register the local TUI package in:
+After changing the plugin source or configuration, close the OpenCode TUI completely and start it again.
 
-```text
-~/.config/opencode/cli.json
-```
+Opening a new conversation is not necessarily sufficient because plugin entrypoints are loaded during TUI startup.
 
-Keep existing plugins and add `./plugins/oc-deepseek-pricing` to the `plugins` array.
+## Expected interface
 
-Example:
+When a DeepSeek model is selected during an off-peak window, the prompt and home footers display:
 
-```json
-{
-  "diffs": {
-    "wrap": "word",
-    "fullscreen": true
-  },
-  "session": {
-    "sidebar": "auto",
-    "scrollbar": false,
-    "thinking": "hide"
-  },
-  "animations": true,
-  "plugins": ["./herdr-opencode", "./plugins/oc-deepseek-pricing"]
-}
+```text
+🐋💤 off-peak · 9h 13m left
 ```
 
-Relative paths are resolved from the OpenCode configuration directory.
+During a peak window, they display:
 
-The package exposes its TUI entrypoint through `package.json`:
-
-```json
-{
-  "exports": {
-    "./tui": "./src/tui.tsx"
-  }
-}
+```text
+🐳 peak · 1h 15m left
 ```
 
-The legacy or integration-specific `tui.jsonc` file does not need to contain this plugin when the package is loaded through `cli.json`.
-
-## Restarting OpenCode
-
-After changing the plugin source or configuration, close the OpenCode TUI completely and start it again.
-
-Opening a new conversation is not necessarily sufficient because plugin entrypoints are loaded during TUI startup.
-
-## Expected interface
-
-When loaded, the prompt footer displays a compact indicator similar to:
+The session sidebar displays only the current status and remaining time:
 
 ```text
-DeepSeek: OFF-PEAK 50% · PEAK in 11h 36m
+Status 🐋💤 off-peak
+9h 13m left
 ```
 
-During a peak window it displays a value similar to:
+During a peak window, the sidebar displays:
 
 ```text
-DeepSeek: PEAK · OFF-PEAK 50% in 1h 15m
+Status 🐳 peak
+1h 15m left
 ```
 
-The session sidebar displays details similar to:
+Run `/deepseek-pricing` to display the complete pricing details:
 
 ```text
 DeepSeek pricing
-Status OFF-PEAK 50%
+Status 🐋💤 off-peak
 Reason outside peak windows
-Next PEAK in 11h 36m
+Next peak in 9h 13m
 At 10/28/2026, 2:00:00 AM
 China 2026-10-27
 ```
 
-The exact local transition time depends on the operating-system timezone and daylight-saving rules. Pricing classification itself is based on UTC, while holiday lookup uses the `Asia/Shanghai` calendar date.
+The `Next` line intentionally uses the state name without an emoji. If the Chinese public-holiday calendar does not cover the current year, the command also displays a warning.
+
+The exact local transition time depends on the operating-system timezone and daylight-saving rules. Pricing classification is based on UTC, while holiday lookup uses the Asia/Shanghai calendar date.
 
 ## Chinese public holidays
 
-The holiday data is stored in:
+Holiday data is stored in:
 
 ```text
 src/holidays.ts
@@ -168,7 +166,7 @@ src/holidays.ts
 
 Only officially verified calendar years should be added to `COVERED_HOLIDAY_YEARS`.
 
-For the full annual update procedure, source requirements, timezone rules, validation checklist, and required tests, see [CALENDAR_UPDATE.md](./CALENDAR_UPDATE.md).
+For the complete annual update procedure, source requirements, timezone rules, validation checklist, and required tests, see [CALENDAR_UPDATE.md](./CALENDAR_UPDATE.md).
 
 If the current Chinese calendar year is not covered, the plugin continues to apply the normal UTC weekday and weekend schedule but displays a coverage warning. Do not suppress the warning by adding a year without adding and reviewing the complete official calendar.
 
@@ -200,11 +198,15 @@ bun test
 Run:
 
 ```sh
-bun check
+bun run typecheck
 ```
 
-The repository uses `NodeNext` module resolution. Relative TypeScript imports must therefore use the emitted JavaScript extension, for example:
+The repository uses NodeNext module resolution. Relative TypeScript imports must therefore use the emitted JavaScript extension, for example:
 
 ```ts
 import { getPricingSnapshot } from "./pricing.js"
 ```
+
+## License
+
+This project is licensed under the MIT License. See [LICENSE](./LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oc-deepseek-pricing",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "OpenCode TUI plugin showing DeepSeek peak and off-peak pricing windows",
   "type": "module",
   "license": "MIT",
@@ -12,7 +12,9 @@
     "tui"
   ],
   "files": [
-    "src",
+    "src/holidays.ts",
+    "src/pricing.ts",
+    "src/tui.tsx",
     "README.md",
     "LICENSE"
   ],
@@ -35,12 +37,6 @@
     "pack:check": "npm pack --dry-run",
     "prepublishOnly": "bun run check"
   },
-  "peerDependencies": {
-    "@opencode/plugin": ">=2.2.0 <2.3.0",
-    "@opentui/core": "0.7.x",
-    "@opentui/solid": "0.7.x",
-    "solid-js": "1.9.17"
-  },
   "devDependencies": {
     "@biomejs/biome": "2.6.3",
     "@opencode/plugin": "2.2.0",

package/src/pricing.test.ts

@@ -1,121 +0,0 @@
-import { describe, expect, test } from "bun:test"
-
-import { formatDuration, getPricingSnapshot } from "./pricing.js"
-
-const COVERED_YEARS = new Set([2026])
-
-function snapshotAt(iso: string, holidays: ReadonlySet<string> = new Set()) {
-  return getPricingSnapshot(new Date(iso), {
-    chinesePublicHolidays: holidays,
-    coveredHolidayYears: COVERED_YEARS,
-  })
-}
-
-function stateAt(iso: string) {
-  return snapshotAt(iso).state
-}
-
-describe("pricing windows", () => {
-  test("handles both weekday peak windows", () => {
-    expect(stateAt("2026-10-26T00:59:59Z")).toBe("off-peak")
-    expect(stateAt("2026-10-26T01:00:00Z")).toBe("peak")
-    expect(stateAt("2026-10-26T04:00:00Z")).toBe("off-peak")
-    expect(stateAt("2026-10-26T06:00:00Z")).toBe("peak")
-    expect(stateAt("2026-10-26T10:00:00Z")).toBe("off-peak")
-  })
-
-  test("keeps weekends off-peak", () => {
-    const saturday = snapshotAt("2026-10-24T02:00:00Z")
-    const sunday = snapshotAt("2026-10-25T07:00:00Z")
-
-    expect(saturday.state).toBe("off-peak")
-    expect(saturday.reason).toBe("weekend")
-
-    expect(sunday.state).toBe("off-peak")
-    expect(sunday.reason).toBe("weekend")
-  })
-
-  test("marks ordinary weekday hours outside the windows as off-peak", () => {
-    const snapshot = snapshotAt("2026-10-26T05:00:00Z")
-
-    expect(snapshot.state).toBe("off-peak")
-    expect(snapshot.reason).toBe("outside-peak-window")
-    expect(snapshot.rateMultiplier).toBe(0.5)
-  })
-
-  test("uses the full multiplier during peak hours", () => {
-    const snapshot = snapshotAt("2026-10-26T08:00:00Z")
-
-    expect(snapshot.state).toBe("peak")
-    expect(snapshot.reason).toBe("peak-window")
-    expect(snapshot.rateMultiplier).toBe(1)
-  })
-})
-
-describe("Chinese public holidays", () => {
-  test("overrides a weekday peak window", () => {
-    const snapshot = snapshotAt("2026-10-01T02:00:00Z", new Set(["2026-10-01"]))
-
-    expect(snapshot.state).toBe("off-peak")
-    expect(snapshot.reason).toBe("chinese-public-holiday")
-    expect(snapshot.rateMultiplier).toBe(0.5)
-  })
-
-  test("reports whether the Chinese calendar year is covered", () => {
-    expect(snapshotAt("2026-10-27T12:00:00Z").holidayCalendarCovered).toBe(true)
-
-    const uncovered = getPricingSnapshot(new Date("2027-01-05T12:00:00Z"), {
-      chinesePublicHolidays: new Set(),
-      coveredHolidayYears: COVERED_YEARS,
-    })
-
-    expect(uncovered.holidayCalendarCovered).toBe(false)
-  })
-})
-
-describe("next transition", () => {
-  test("finds the end of the first peak window", () => {
-    const snapshot = snapshotAt("2026-10-27T02:15:00Z")
-
-    expect(snapshot.nextState).toBe("off-peak")
-    expect(snapshot.nextTransition).toBe("2026-10-27T04:00:00.000Z")
-    expect(snapshot.secondsUntilTransition).toBe(6_300)
-  })
-
-  test("finds the beginning of the second peak window", () => {
-    const snapshot = snapshotAt("2026-10-27T05:30:00Z")
-
-    expect(snapshot.nextState).toBe("peak")
-    expect(snapshot.nextTransition).toBe("2026-10-27T06:00:00.000Z")
-    expect(snapshot.secondsUntilTransition).toBe(1_800)
-  })
-
-  test("skips the weekend when finding the next peak window", () => {
-    const snapshot = snapshotAt("2026-10-30T10:00:00Z")
-
-    expect(snapshot.state).toBe("off-peak")
-    expect(snapshot.nextState).toBe("peak")
-    expect(snapshot.nextTransition).toBe("2026-11-02T01:00:00.000Z")
-  })
-})
-
-describe("duration formatting", () => {
-  test("formats minutes and hours", () => {
-    expect(formatDuration(60)).toBe("1m")
-    expect(formatDuration(3_600)).toBe("1h")
-    expect(formatDuration(5_400)).toBe("1h 30m")
-  })
-
-  test("rounds partial minutes up", () => {
-    expect(formatDuration(1)).toBe("1m")
-    expect(formatDuration(61)).toBe("2m")
-  })
-})
-
-describe("input validation", () => {
-  test("rejects invalid dates", () => {
-    expect(() => {
-      getPricingSnapshot(new Date("invalid"))
-    }).toThrow("Invalid date")
-  })
-})