Merge pull request #264 from Tencent/release/0.3.0

chore(release): prepare 0.3.0

Author: iuyo5678

CHANGELOG.md

@@ -5,7 +5,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
 Starting from 0.2.0, CLI / Extension / DSH Plugin share the same version number.
 
-## [Unreleased]
+## [0.3.0] - 2026-09-16
 
 ### Added
 

Cargo.lock

@@ -7,7 +7,7 @@ members = [
 default-members = ["crates/bsk-cli"]
 
 [workspace.package]
-version = "0.2.1"
+version = "0.3.0"
 edition = "2024"
 rust-version = "1.85"
 license = "MIT"
@@ -43,7 +43,7 @@ rand = "0.8"
 uuid = { version = "1", features = ["v4", "serde"] }
 
 # Workspace crates (version required for `cargo publish` of dependents)
-bsk-protocol = { version = "0.2.1", path = "crates/bsk-protocol" }
+bsk-protocol = { version = "0.3.0", path = "crates/bsk-protocol" }
 
 [profile.release]
 strip = "symbols"

Cargo.toml

@@ -1,6 +1,6 @@
 {
   "name": "@browser-skill/extension",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "private": true,
   "type": "module",
   "scripts": {

apps/extension/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wxg-prc-cpg/browser-skill-dsh-plugin",
   "description": "DeepSeek Harness tool plugin that exposes BrowserSkill browser automation (browser_* tools) to the model",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "license": "MIT",
   "publishConfig": {
     "access": "public",

packages/dsh-plugin-browserskill/package.json

@@ -193,6 +193,10 @@ function updateChangelog(version) {
     }
   }
 
+  // Remove an empty development placeholder after preparing the release.
+  // Keep future release notes when this version already has a prepared entry.
+  content = content.replace(/^## \[Unreleased\][ \t]*(?:\r?\n[ \t]*)*(?=^## |(?![\s\S]))/m, "");
+
   return { path: changelogPath, content };
 }
 

scripts/release.mjs

@@ -0,0 +1,79 @@
+import assert from "node:assert/strict";
+import { execFileSync } from "node:child_process";
+import { mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import test from "node:test";
+import { fileURLToPath } from "node:url";
+
+const scriptPath = fileURLToPath(new URL("./release.mjs", import.meta.url));
+
+function prepareRelease(t, changelog, extraArgs = []) {
+  const cwd = mkdtempSync(join(tmpdir(), "bsk-release-test-"));
+  t.after(() => rmSync(cwd, { recursive: true, force: true }));
+  for (const dir of ["apps/extension", "packages/dsh-plugin-browserskill", "bin"]) {
+    mkdirSync(join(cwd, dir), { recursive: true });
+  }
+  writeFileSync(join(cwd, "Cargo.toml"), '[workspace.package]\nversion = "0.2.1"\n');
+  for (const dir of ["apps/extension", "packages/dsh-plugin-browserskill"]) {
+    writeFileSync(join(cwd, dir, "package.json"), '{"version":"0.2.1"}\n');
+  }
+  writeFileSync(join(cwd, "CHANGELOG.md"), changelog);
+  // Exercise the real file-writing path without compiling Rust or creating Git tags.
+  const windows = process.platform === "win32";
+  writeFileSync(
+    join(cwd, "bin", windows ? "cargo.cmd" : "cargo"),
+    windows ? "@exit /b 0\r\n" : "#!/bin/sh\nexit 0\n",
+    { mode: 0o755 },
+  );
+  const pathKey = Object.keys(process.env).find((key) => key.toLowerCase() === "path") ?? "PATH";
+  execFileSync(process.execPath, [scriptPath, "0.3.0", "--no-commit", ...extraArgs], {
+    cwd,
+    env: {
+      ...process.env,
+      [pathKey]: `${join(cwd, "bin")}${windows ? ";" : ":"}${process.env[pathKey] ?? ""}`,
+    },
+  });
+  return readFileSync(join(cwd, "CHANGELOG.md"), "utf8");
+}
+
+const history = "## [0.2.1] - 2026-09-09\n\n### Fixed\n\n- Previous fix.\n";
+const notes = "### Added\n\n- New release feature.\n\n";
+const prepared = `## [0.3.0] - 2026-09-16\n\n${notes}${history}`;
+
+test("moves unreleased notes into the release without an empty heading", (t) => {
+  const actual = prepareRelease(t, `# Changelog\n\n## [Unreleased]\n\n${notes}${history}`);
+  assert.match(actual, /^# Changelog\n\n## \[0\.3\.0\] - \d{4}-\d{2}-\d{2}\n\n/);
+  assert.ok(actual.endsWith(`${notes}${history}`));
+  assert.doesNotMatch(actual, /\[Unreleased\]/);
+});
+
+test("removes an empty heading without changing a prepared release", (t) => {
+  const actual = prepareRelease(t, `# Changelog\n\n## [Unreleased]\n \t\n${prepared}`);
+  assert.equal(actual, `# Changelog\n\n${prepared}`);
+});
+
+test("preserves future unreleased notes when the target release is already prepared", (t) => {
+  const changelog = `# Changelog\n\n## [Unreleased]\n\n### Changed\n\n- Future feature.\n\n${prepared}`;
+  assert.equal(prepareRelease(t, changelog), changelog);
+});
+
+test("fills a prepared release date and removes its empty unreleased placeholder", (t) => {
+  const actual = prepareRelease(
+    t,
+    `# Changelog\n\n## [Unreleased]\n\n## [0.3.0] - 2026-09-XX\n\n${notes}${history}`,
+  );
+  assert.match(actual, /^# Changelog\n\n## \[0\.3\.0\] - \d{4}-\d{2}-\d{2}\n\n/);
+  assert.ok(actual.endsWith(`${notes}${history}`));
+  assert.doesNotMatch(actual, /\[Unreleased\]/);
+});
+
+test("leaves a prepared release unchanged when there is no unreleased heading", (t) => {
+  const changelog = `# Changelog\n\n${prepared}`;
+  assert.equal(prepareRelease(t, changelog), changelog);
+});
+
+test("dry run preserves the original changelog", (t) => {
+  const changelog = `# Changelog\n\n## [Unreleased]\n\n${notes}${history}`;
+  assert.equal(prepareRelease(t, changelog, ["--dry-run"]), changelog);
+});