From 5bf9f839e2efc85c8e002551165426bc88e6ee98 Mon Sep 17 00:00:00 2001 From: Willie Date: Mon, 11 May 2026 15:27:43 +0800 Subject: [PATCH] docs: add v0.19.9 changelog entry Context budget warnings (issue #150), --quiet flag, Web UI context cost display, and HTTP protocol install fix. --- CHANGELOG.md | 23 +++++++++++++++++++++++ website/src/pages/changelog.md | 23 +++++++++++++++++++++++ 2 files changed, 46 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index e909183ba..f61a78b9d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,28 @@ # Changelog +## [0.19.9] - 2026-05-11 + +### New Features + +- **Context cost summary after sync** — `skillshare sync` now displays a one-line token cost summary showing always-loaded and on-demand context usage per target. Targets with identical token counts are grouped on a single line. Refs: #150 + ``` + ✔ Synced 47 skill(s) to 4 target(s) in 312ms + Context: ~12.4K always-loaded · ~58.2K on-demand (claude, cursor, codex, opencode) + ``` +- **Configurable budget warnings** — set token budget thresholds in `config.yaml`. When `sync` or `analyze` detects a target exceeding the budget, a warning shows the top 3 offenders by token count + ```yaml + context_budget: + warn_always_loaded_tokens: 10000 # default; 0 = disabled + warn_on_demand_tokens: 100000 # default; 0 = disabled + ``` + Defaults to 10K always-loaded / 100K on-demand. Set to `0` to disable +- **`--quiet` / `-q` flag for sync** — suppresses the token summary and budget warnings. JSON output (`--json`) always includes `context_cost` regardless of `--quiet` +- **Context cost in Web UI** — the Sync page now displays token cost groups and budget violation warnings after each sync + +### Bug Fixes + +- Fixed `skillshare install` failing with `http://` protocol URLs (contributed by @eekryuos) + ## [0.19.8] - 2026-05-08 ### New Features diff --git a/website/src/pages/changelog.md b/website/src/pages/changelog.md index 9c2cea414..5e4e8a960 100644 --- a/website/src/pages/changelog.md +++ b/website/src/pages/changelog.md @@ -9,6 +9,29 @@ All notable changes to skillshare are documented here. For the full commit histo --- +## [0.19.9] - 2026-05-11 + +### New Features + +- **Context cost summary after sync** — `skillshare sync` now displays a one-line token cost summary showing always-loaded and on-demand context usage per target. Targets with identical token counts are grouped on a single line. Refs: #150 + ``` + ✔ Synced 47 skill(s) to 4 target(s) in 312ms + Context: ~12.4K always-loaded · ~58.2K on-demand (claude, cursor, codex, opencode) + ``` +- **Configurable budget warnings** — set token budget thresholds in `config.yaml`. When `sync` or `analyze` detects a target exceeding the budget, a warning shows the top 3 offenders by token count + ```yaml + context_budget: + warn_always_loaded_tokens: 10000 # default; 0 = disabled + warn_on_demand_tokens: 100000 # default; 0 = disabled + ``` + Defaults to 10K always-loaded / 100K on-demand. Set to `0` to disable +- **`--quiet` / `-q` flag for sync** — suppresses the token summary and budget warnings. JSON output (`--json`) always includes `context_cost` regardless of `--quiet` +- **Context cost in Web UI** — the Sync page now displays token cost groups and budget violation warnings after each sync + +### Bug Fixes + +- Fixed `skillshare install` failing with `http://` protocol URLs (contributed by @eekryuos) + ## [0.19.8] - 2026-05-08 ### New Features