fix: drop the blank release-notes row and cut CHANGELOG on publish (#7)

GitHub treated the empty table header as a blank row above Plugin.
semantic-release now promotes Keep a Changelog Unreleased into the
released version, and the post-release sync PR commits CHANGELOG.md.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: BrainerVirus

.github/workflows/release.yml

@@ -48,7 +48,7 @@ jobs:
         run: |
           git checkout -- package.json manifest.json 2>/dev/null || true
           bun run scripts/sync-release-manifests.ts
-          if [[ -z "$(git status --porcelain -- package.json manifest.json)" ]]; then
+          if [[ -z "$(git status --porcelain -- package.json manifest.json CHANGELOG.md)" ]]; then
             echo "manifests already match the latest tag"
             exit 0
           fi
@@ -58,11 +58,11 @@ jobs:
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git remote set-url origin "https://x-access-token:${GH_TOKEN}@github.com/${GITHUB_REPOSITORY}.git"
           git checkout -b "${BRANCH}"
-          git add package.json manifest.json
+          git add package.json manifest.json CHANGELOG.md
           git commit -m "chore(release): sync manifests to v${VERSION}"
           git push -u origin "${BRANCH}"
           gh pr create \
             --title "chore(release): sync manifests to v${VERSION}" \
-            --body "Automated post-release manifest alignment. Sets package.json and manifest.json to the released ${VERSION}." \
+            --body "Automated post-release manifest alignment. Sets package.json, manifest.json, and CHANGELOG.md to the released ${VERSION}." \
             --base main --head "${BRANCH}"
           gh pr merge --auto --squash --delete-branch || echo "auto-merge unavailable — merge the sync PR after CI is green"

CHANGELOG.md

@@ -9,6 +9,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- semantic-release now cuts Keep a Changelog `[Unreleased]` into `## [version]` on publish and includes `CHANGELOG.md` in the post-release sync PR.
+
+### Fixed
+
+- Catalog GitHub release notes table no longer renders a blank header row above Plugin.
+- Credits sentence no longer mentions Command Code wiring or restates MIT copyright.
+
+## [0.6.0] - 2026-08-28
+
+### Changed
+
+- Renamed the published package and GitHub repository to `@brainervirus/opencode-commandcode`.
+
+## [0.5.1] - 2026-08-28
+
+### Fixed
+
+- Price Command Code free SKUs at `$0` before models.dev, and fill remaining paid gaps from models.dev.
+
+## [0.5.0] - 2026-08-28
+
+### Added
+
 - GitHub flow: PR-gated `main`, CI matrix (`check (test|typecheck|pack)`), semantic-release on merge, catalog updates as PRs.
 - Release notes open with a catalog summary table and collapsed lists of fallback / unpriced models.
 - `manifest.json` describing the bundled catalog (status, cost sources, command-code version).

README.md

@@ -12,7 +12,7 @@ Previously published as `@brainervirus/commandcode-go-opencode-provider`. Use th
 
 ## Credits
 
-This package is based on **[FanFan4204/opencode-commandcode-provider](https://github.com/FanFan4204/opencode-commandcode-provider)**. That work started from **[brent-weatherall/opencode-commandcode-provider](https://github.com/brent-weatherall/opencode-commandcode-provider)** by **[Brent Weatherall](https://github.com/brent-weatherall)**. Thank you both — FanFan for the OpenCode provider this repo continues, and Brent for the original plugin, catalog extraction, and Command Code wiring. The license remains MIT; copyright stays with Brent Weatherall.
+This package is based on **[FanFan4204/opencode-commandcode-provider](https://github.com/FanFan4204/opencode-commandcode-provider)**. That work started from **[brent-weatherall/opencode-commandcode-provider](https://github.com/brent-weatherall/opencode-commandcode-provider)** by **[Brent Weatherall](https://github.com/brent-weatherall)**. Thank you both — FanFan for the OpenCode provider this repo continues, and Brent for the original plugin, catalog extraction.
 
 ### What this package adds
 

release.config.cjs

@@ -4,6 +4,7 @@ module.exports = {
     "@semantic-release/commit-analyzer",
     "./scripts/semantic-release-catalog-notes.cjs",
     "@semantic-release/release-notes-generator",
+    "./scripts/semantic-release-changelog.cjs",
     "@semantic-release/npm",
     "@semantic-release/github",
   ],

scripts/catalog-release-notes.ts

@@ -8,4 +8,5 @@ import type { PricedModel } from "../src/catalog-release-notes.js";
 const ROOT = join(import.meta.dir, "..");
 const manifest = JSON.parse(readFileSync(join(ROOT, "manifest.json"), "utf-8")) as CatalogManifest;
 const models = JSON.parse(readFileSync(join(ROOT, "models.json"), "utf-8")) as PricedModel[];
-process.stdout.write(catalogReleaseNotesFromFiles({ manifest, models }));
+const pluginVersion = process.argv[2];
+process.stdout.write(catalogReleaseNotesFromFiles({ manifest, models, pluginVersion }));

scripts/cut-changelog.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env bun
+import { readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { cutKeepAChangelog } from "../src/cut-changelog.ts";
+
+const version = process.argv[2];
+const date = process.argv[3] ?? new Date().toISOString().slice(0, 10);
+if (!version) throw new Error("usage: cut-changelog.ts <version> [YYYY-MM-DD]");
+const path = join(import.meta.dir, "..", "CHANGELOG.md");
+writeFileSync(path, cutKeepAChangelog(readFileSync(path, "utf8"), version, date));

scripts/semantic-release-catalog-notes.cjs

@@ -2,9 +2,9 @@ const { execFileSync } = require("node:child_process");
 const { join } = require("node:path");
 
 module.exports = {
-  generateNotes() {
-    return execFileSync("bun", [join(__dirname, "catalog-release-notes.ts")], {
-      encoding: "utf8",
-    });
+  generateNotes(_config, context) {
+    const args = [join(__dirname, "catalog-release-notes.ts")];
+    if (context.nextRelease?.version) args.push(context.nextRelease.version);
+    return execFileSync("bun", args, { encoding: "utf8" });
   },
 };

scripts/semantic-release-changelog.cjs

@@ -0,0 +1,14 @@
+const { execFileSync } = require("node:child_process");
+const { join } = require("node:path");
+
+// Keep a Changelog: promote ## [Unreleased] into ## [version] - date during
+// prepare. The post-release sync PR commits CHANGELOG.md (protected main).
+module.exports = {
+  prepare(_config, context) {
+    const version = context.nextRelease.version;
+    const date = new Date().toISOString().slice(0, 10);
+    execFileSync("bun", [join(__dirname, "cut-changelog.ts"), version, date], {
+      stdio: "inherit",
+    });
+  },
+};

src/catalog-release-notes.ts

@@ -89,9 +89,8 @@ export function renderCatalogReleaseNotes(input: CatalogReleaseInput): string {
   const sections = [
     headline(input.status),
     "",
-    "| | |",
-    "| --- | --- |",
     `| Plugin | ${input.pluginVersion} |`,
+    "| --- | --- |",
     `| Command Code | ${input.commandCodeVersion} |`,
     `| Models | ${input.modelCount} (${input.reasoningModelCount} with reasoning) |`,
     `| Prices | ${priceSummary(input.costSources)} |`,
@@ -157,9 +156,10 @@ export function renderCatalogReleaseNotes(input: CatalogReleaseInput): string {
 export function catalogReleaseNotesFromFiles(input: {
   manifest: CatalogManifest;
   models: PricedModel[];
+  pluginVersion?: string;
 }): string {
   return renderCatalogReleaseNotes({
-    pluginVersion: input.manifest.pluginVersion,
+    pluginVersion: input.pluginVersion ?? input.manifest.pluginVersion,
     commandCodeVersion: input.manifest.commandCodeVersion,
     modelCount: input.manifest.modelCount,
     reasoningModelCount: input.manifest.reasoningModelCount,

src/cut-changelog.ts

@@ -0,0 +1,40 @@
+const UNRELEASED = /^## \[Unreleased\]\s*$/;
+const VERSION = /^## \[/;
+
+export function cutKeepAChangelog(markdown: string, version: string, date: string): string {
+  if (new RegExp(`^## \\[${escapeRegExp(version)}\\]`, "m").test(markdown)) return markdown;
+
+  const lines = markdown.split(/(?<=\n)/);
+  let start: number | null = null;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (line !== undefined && UNRELEASED.test(line.replace(/\n$/, ""))) {
+      start = i;
+      break;
+    }
+  }
+  if (start === null) throw new Error("CHANGELOG.md has no ## [Unreleased] heading");
+
+  let end = lines.length;
+  for (let j = start + 1; j < lines.length; j++) {
+    const line = lines[j];
+    if (line === undefined) continue;
+    const stripped = line.replace(/\n$/, "");
+    if (VERSION.test(stripped) && !UNRELEASED.test(stripped)) {
+      end = j;
+      break;
+    }
+  }
+
+  const before = lines.slice(0, start + 1).join("");
+  const body = lines
+    .slice(start + 1, end)
+    .join("")
+    .replace(/^\n+/, "\n");
+  const after = lines.slice(end).join("");
+  return `${before}\n## [${version}] - ${date}\n${body}${after}`;
+}
+
+function escapeRegExp(value: string): string {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}