@osovv/vv-opencode 1.3.2 → 1.3.3

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## <small>1.3.3 (2026-08-19)</small>
+
+### Summary
+
+In this release the TUI branding footer is upgraded to show a single combined version line in the sidebar — `• OpenCode <version> · vvoc vX.Y.Z` — replacing the previous standalone vvoc label in the bottom app bar. The new footer reads the OpenCode version from the running app, renders with the active theme colors, and deliberately wins the sidebar footer slot so it appears in a native-looking, always-visible location. This makes it easier for users to see at a glance which OpenCode and vvoc versions are active in a session.
+
+* feat(tui): render combined OpenCode and vvoc versions in the sidebar footer ([ea5aa66](https://github.com/osovv/vv-opencode/commit/ea5aa66))
+
 ## <small>1.3.2 (2026-08-19)</small>
 
 ### Summary

package/README.md

@@ -183,7 +183,7 @@ OpenCode is a strong, flexible base for agentic coding, but it intentionally lea
 | **WebToolsPlugin** | Register the provider-neutral `web_search` and `web_fetch` tools, return direct image/PDF attachments, and hide OpenCode's built-in web tools at runtime unless the user explicitly configured their permissions. |
 | **ContextTuiPlugin** | Add a native scrollable `/context` dialog with measured usage plus detailed observable per-tool and per-MCP schema/history estimates, explicitly marking data that OpenCode does not expose. |
 | **ToolHistoryCompactionPlugin** | Shrink the replayed conversation context non-destructively by compacting old tool outputs in the model replay (old reads to `[Read <file>, lines X-Y]`, over-budget ephemeral outputs pruned), while retaining web/search/skill knowledge results. |
-| **AnalyticsPlugin** | Persist per-step token and cache telemetry with vvoc/OpenCode version attribution, show a live `cache NN%` indicator next to the session prompt plus a `vvoc vX.Y.Z` label in the bottom app bar, and answer "did my cache optimizations help?" via `vvoc analytics cache-hit-rate`. |
+| **AnalyticsPlugin** | Persist per-step token and cache telemetry with vvoc/OpenCode version attribution, show a live `cache NN%` indicator next to the session prompt plus a combined OpenCode/vvoc version line in the sidebar footer, and answer "did my cache optimizations help?" via `vvoc analytics cache-hit-rate`. |
 
 Workflow work items are opened with explicit intent. For implementation loops, controllers use:
 
@@ -265,7 +265,7 @@ Set `outputMaxChars` to `0` to disable pruning, or `"enabled": false` to disable
 
 `AnalyticsPlugin` records one line per completed model step — fresh input, cache read, cache write, output, reasoning, recorded cost — to `$XDG_DATA_HOME/vvoc/analytics/usage-YYYY-MM.jsonl`, attributed with the vvoc version, the OpenCode version (from session telemetry), project, provider, model, and agent. Telemetry never leaves the machine; disable collection with `"plugins": { "analytics": false }` and delete old monthly files freely.
 
-In the TUI you get a live `cache NN%` indicator next to the session prompt (green at 80%+, yellow at 50%+, red below, muted `n/a` before the first cache-eligible step) and a `vvoc vX.Y.Z` label in the bottom app bar. Both use append-mode host slots, so OpenCode's own footer and prompt content stay intact. The indicator is per-session and computed in memory.
+In the TUI you get a live `cache NN%` indicator next to the session prompt (green at 80%+, yellow at 50%+, red below, muted `n/a` before the first cache-eligible step) and a combined footer line `• OpenCode <version> · vvoc vX.Y.Z` in the sidebar (the stock version line, extended with the vvoc version). The indicator is per-session and computed in memory.
 
 Retrospective analysis lives in the CLI:
 

package/dist/tui/branding/footer.d.ts

@@ -1,19 +1,29 @@
 import type { JSX } from "@opentui/solid";
 import type { RGBA } from "@opentui/core";
 import type { TuiPluginApi } from "@opencode-ai/plugin/tui";
+export type BrandingVersionInfo = {
+    opencodeVersion: string;
+    vvocLabel: string;
+};
+export type BrandingColors = {
+    muted: RGBA;
+    success: RGBA;
+    text: RGBA;
+};
 export type BrandingDependencies = {
-    /** Renders the label node; defaults to the muted text element. */
-    renderLabel: (text: string, color: RGBA) => JSX.Element;
+    /** Renders the combined version line; defaults to the native-looking OpenCode footer line extended with the vvoc label. */
+    renderLabel: (info: BrandingVersionInfo, colors: BrandingColors) => JSX.Element;
 };
-/** The rendered label, e.g. "vvoc v1.2.11". */
+/** The vvoc label text, e.g. "vvoc v1.2.11". */
 export declare function brandingFooterLabel(): string;
 /**
- * Registers the branding label in the "app_bottom" host slot.
+ * Registers the combined version line in the "sidebar_footer" host slot.
  *
- * app_bottom renders in append mode at the bottom of the app on every screen,
- * so the label coexists with any other plugin content and never displaces the
- * OpenCode sidebar or home footers (those slots are single_winner and owned by
- * OpenCode's internal footer plugins). Always on (independent of analytics
+ * sidebar_footer renders in single_winner mode: only the first registered
+ * plugin (lowest order) is displayed. OpenCode's internal footer registers
+ * with order 100; this plugin uses order 50 so it deterministically wins the
+ * slot and renders the stock-looking footer line extended with the vvoc
+ * version ("• OpenCode <oc> · vvoc v<x>"). Always on (independent of analytics
  * config); returns silently when the slot API is unavailable or registration
  * fails.
  */

package/dist/tui/branding/footer.js

@@ -1,20 +1,21 @@
-import { jsx as _jsx } from "@opentui/solid/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "@opentui/solid/jsx-runtime";
 import { getPackageVersionSync } from "../../lib/package.js";
 const DEFAULT_DEPENDENCIES = {
-    renderLabel: (text, color) => (_jsx("text", { children: _jsx("span", { style: { fg: color }, children: text }) })),
+    renderLabel: (info, colors) => (_jsxs("text", { fg: colors.muted, children: [_jsx("span", { style: { fg: colors.success }, children: "\u2022" }), " ", _jsx("b", { children: "Open" }), _jsx("span", { style: { fg: colors.text }, children: _jsx("b", { children: "Code" }) }), " ", _jsx("span", { children: info.opencodeVersion }), _jsxs("span", { children: [" \u00B7 ", info.vvocLabel] })] })),
 };
-/** The rendered label, e.g. "vvoc v1.2.11". */
+/** The vvoc label text, e.g. "vvoc v1.2.11". */
 export function brandingFooterLabel() {
     return `vvoc v${getPackageVersionSync()}`;
 }
 // START_BLOCK_REGISTER_BRANDING_FOOTER
 /**
- * Registers the branding label in the "app_bottom" host slot.
+ * Registers the combined version line in the "sidebar_footer" host slot.
  *
- * app_bottom renders in append mode at the bottom of the app on every screen,
- * so the label coexists with any other plugin content and never displaces the
- * OpenCode sidebar or home footers (those slots are single_winner and owned by
- * OpenCode's internal footer plugins). Always on (independent of analytics
+ * sidebar_footer renders in single_winner mode: only the first registered
+ * plugin (lowest order) is displayed. OpenCode's internal footer registers
+ * with order 100; this plugin uses order 50 so it deterministically wins the
+ * slot and renders the stock-looking footer line extended with the vvoc
+ * version ("• OpenCode <oc> · vvoc v<x>"). Always on (independent of analytics
  * config); returns silently when the slot API is unavailable or registration
  * fails.
  */
@@ -26,17 +27,18 @@ export function registerBrandingFooter(api, dependencies = DEFAULT_DEPENDENCIES)
         // the SDK's TuiSlotPlugin type still types id as never; cast bridges the two.
         const plugin = {
             id: "vvoc-branding",
-            order: 1000,
+            order: 50,
             slots: {
-                app_bottom: (ctx) => {
-                    return dependencies.renderLabel(brandingFooterLabel(), ctx.theme.current.textMuted);
+                sidebar_footer: (ctx) => {
+                    const theme = ctx.theme.current;
+                    return dependencies.renderLabel({ opencodeVersion: api.app.version, vvocLabel: brandingFooterLabel() }, { muted: theme.textMuted, success: theme.success, text: theme.text });
                 },
             },
         };
         api.slots.register(plugin);
     }
     catch {
-        // Fail-soft: no label for this session.
+        // Fail-soft: no combined footer for this session.
     }
 }
 //# sourceMappingURL=footer.js.map

package/dist/tui/branding/footer.js.map

@@ -1 +1 @@
-{"version":3,"file":"footer.js","sourceRoot":"","sources":["../../../src/tui/branding/footer.tsx"],"names":[],"mappings":";AAwBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAO7D,MAAM,oBAAoB,GAAyB;IACjD,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAC5B,yBACE,eAAM,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,YAAG,IAAI,GAAQ,GACpC,CACR;CACF,CAAC;AAEF,+CAA+C;AAC/C,MAAM,UAAU,mBAAmB;IACjC,OAAO,SAAS,qBAAqB,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED,uCAAuC;AACvC;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAiB,EACjB,eAAqC,oBAAoB;IAEzD,IAAI,OAAO,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,UAAU;QAAE,OAAO;IACtD,IAAI,CAAC;QACH,8EAA8E;QAC9E,8EAA8E;QAC9E,MAAM,MAAM,GAAG;YACb,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,IAAI;YACX,KAAK,EAAE;gBACL,UAAU,EAAE,CAAC,GAAmB,EAAE,EAAE;oBAClC,OAAO,YAAY,CAAC,WAAW,CAAC,mBAAmB,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBACtF,CAAC;aACF;SAC6D,CAAC;QACjE,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;AACH,CAAC"}
+{"version":3,"file":"footer.js","sourceRoot":"","sources":["../../../src/tui/branding/footer.tsx"],"names":[],"mappings":";AA0BA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAkB7D,MAAM,oBAAoB,GAAyB;IACjD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAC7B,gBAAM,EAAE,EAAE,MAAM,CAAC,KAAK,aACpB,eAAM,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,uBAAU,OAAC,+BAAW,EACzD,eAAM,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,YAC9B,+BAAW,GACN,EAAC,GAAG,EACX,yBAAO,IAAI,CAAC,eAAe,GAAQ,EACnC,uCAAU,IAAI,CAAC,SAAS,IAAQ,IAC3B,CACR;CACF,CAAC;AAEF,gDAAgD;AAChD,MAAM,UAAU,mBAAmB;IACjC,OAAO,SAAS,qBAAqB,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED,uCAAuC;AACvC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAiB,EACjB,eAAqC,oBAAoB;IAEzD,IAAI,OAAO,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,UAAU;QAAE,OAAO;IACtD,IAAI,CAAC;QACH,8EAA8E;QAC9E,8EAA8E;QAC9E,MAAM,MAAM,GAAG;YACb,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,EAAE;YACT,KAAK,EAAE;gBACL,cAAc,EAAE,CAAC,GAAmB,EAAE,EAAE;oBACtC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC;oBAChC,OAAO,YAAY,CAAC,WAAW,CAC7B,EAAE,eAAe,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,EAAE,EACtE,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CACrE,CAAC;gBACJ,CAAC;aACF;SAC6D,CAAC;QACjE,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osovv/vv-opencode",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "A curated, opinionated set of OpenCode plugins for spec-first, review-driven, safer agentic development.",
   "type": "module",
   "main": "./dist/index.js",

package/schemas/vvoc/v3.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://cdn.jsdelivr.net/npm/@osovv/vv-opencode@1.3.2/schemas/vvoc/v3.json",
+  "$id": "https://cdn.jsdelivr.net/npm/@osovv/vv-opencode@1.3.3/schemas/vvoc/v3.json",
   "title": "vvoc config",
   "description": "Canonical vvoc configuration document.",
   "type": "object",