From f2192d273b337f730a5c9c2c13c3a2f09ccde471 Mon Sep 17 00:00:00 2001 From: Suppaseth Charoenkarnka Date: Wed, 20 May 2026 10:34:34 +0700 Subject: [PATCH] feat: pin plugin to CLI v3.0 (Rust) Bumps plugin version 2.4.13 -> 3.0.0-alpha.1 and declares a hard requirement on the Rust CLI rewrite via the new requires.cli field in plugin.json. Major bump rationale: the v3 CLI replaces the Bun/TypeScript binary with a native Rust executable. All 13 subcommands referenced by plugin skills retain parity with v2.3.3 (smoke-tested), so existing skill prose continues to work unchanged. The version jump signals to consumers that downgrading the CLI back to 2.x is unsupported under this plugin release. Audit of plugin shell-outs surfaced one follow-up: several skills and startup/scripts/open-in-obsidian.sh shell out to `node -e ...` with the comment "Node is reliably on PATH because the OneBrain CLI requires it." The Rust CLI no longer carries Node as a transitive dependency, so this assumption is broken. Per the minimal-changes rule, this is documented in PLUGIN-CHANGELOG and deferred to a dedicated follow-up PR rather than rewritten here. --- .claude/plugins/onebrain/.claude-plugin/plugin.json | 5 ++++- PLUGIN-CHANGELOG.md | 11 +++++++++-- 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/.claude/plugins/onebrain/.claude-plugin/plugin.json b/.claude/plugins/onebrain/.claude-plugin/plugin.json index 5241a9a2..06487008 100644 --- a/.claude/plugins/onebrain/.claude-plugin/plugin.json +++ b/.claude/plugins/onebrain/.claude-plugin/plugin.json @@ -1,8 +1,11 @@ { "name": "onebrain", - "version": "2.4.13", + "version": "3.0.0-alpha.1", "description": "OneBrain — Where human and AI thinking become one. A powerful thinking partner powered by AI synergy.", "author": { "name": "OneBrain Contributors" + }, + "requires": { + "cli": ">=3.0.0-alpha.1" } } diff --git a/PLUGIN-CHANGELOG.md b/PLUGIN-CHANGELOG.md index 6db69195..c907a72b 100644 --- a/PLUGIN-CHANGELOG.md +++ b/PLUGIN-CHANGELOG.md @@ -1,6 +1,6 @@ --- -latest_version: 2.4.13 -released: 2026-05-19 +latest_version: 3.0.0-alpha.1 +released: 2026-05-20 --- # Plugin Changelog @@ -11,6 +11,13 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). > **Versioning:** Plugin version is tracked in `plugin.json`. Bump when ANY harness config changes — skills, agents, hooks, INSTRUCTIONS, Gemini settings, slash commands, etc. > For CLI binary (`@onebrain-ai/cli`) changes, see [CHANGELOG.md](CHANGELOG.md). +## v3.0.0-alpha.1 — 2026-05-20 + +- chore(plugin.json): bump version 2.4.13 → 3.0.0-alpha.1 to mark prerelease compatibility with the Rust CLI rewrite +- feat(plugin.json): add `requires.cli: ">=3.0.0-alpha.1"` — refuses to load against the Bun-era CLI (v2.x) where the new internal CLI shape would silently misbehave +- audit(skills): all 13 CLI subcommands referenced by skills (`session-init`, `checkpoint stop`, `checkpoint reset`, `orphan-scan`, `vault-sync`, `register-hooks`, `register-schedule`, `qmd-reindex`, `run-skill`, `update`, plus `--version`) preserved on the Rust side per the v3.0.0-alpha.1 parity smoke test — no skill rewrites required for this bump +- audit(skills): flagged `node -e "…"` usage in `skills/qmd/SKILL.md`, `skills/update/SKILL.md`, `skills/reorganize/SKILL.md`, `skills/import/**`, and `startup/scripts/open-in-obsidian.sh` as a follow-up — these assume Node is on PATH "because the OneBrain CLI requires it", which the Rust CLI no longer guarantees; deferred per minimal-changes rule, tracked separately + ## v2.4.13 — 2026-05-19 - docs(update): add Known Gotcha about WebFetch returning summarized markdown — recommend `curl -fsSL` for raw-content fetches (`plugin.json`/`settings.json` JSON parsing, `PLUGIN-CHANGELOG.md` verbatim display, `SKILL.md` self-update bootstrap). Symptoms section helps diagnose silent corruption from summarized fetches.