@cortexkit/opencode-magic-context 0.27.2 → 0.28.0

package/dist/plugin/conflict-warning-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conflict-warning-hook.d.ts","sourceRoot":"","sources":["../../src/plugin/conflict-warning-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAsLlE;;GAEG;AACH,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,cAAc,GAC/B,OAAO,CAAC,IAAI,CAAC,CAqDf;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CACzC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAwHf;AAkCD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC1C,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAsEf;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CACxC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CACzC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,EAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACpC,OAAO,CAAC,IAAI,CAAC,CAkFf"}
+{"version":3,"file":"conflict-warning-hook.d.ts","sourceRoot":"","sources":["../../src/plugin/conflict-warning-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAsLlE;;GAEG;AACH,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,cAAc,GAC/B,OAAO,CAAC,IAAI,CAAC,CAqDf;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CACzC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAwHf;AAkCD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC1C,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAsEf;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CACxC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GAC/D,OAAO,CAAC,IAAI,CAAC,CA2Cf;AAED;;;;;;;;GAQG;AACH,wBAAsB,uBAAuB,CACzC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,EAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACpC,OAAO,CAAC,IAAI,CAAC,CAkFf"}

package/dist/plugin/dream-timer.d.ts

@@ -14,6 +14,7 @@ interface ProjectRegistration {
     projectIdentity: string;
     client: PluginContext["client"];
     dreamerConfig?: DreamerConfig;
+    language?: string;
     gitCommitIndexing?: {
         enabled: boolean;
         since_days: number;

package/dist/plugin/dream-timer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dream-timer.d.ts","sourceRoot":"","sources":["../../src/plugin/dream-timer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AASpE,OAAO,EAEH,KAAK,wBAAwB,EAChC,MAAM,8DAA8D,CAAC;AA4BtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAGpF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAO7C;;;;;GAKG;AACH,UAAU,mBAAmB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,iBAAiB,CAAC,EAAE;QAChB,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,CACvB,EAAE,EAAE,QAAQ,EACZ,eAAe,EAAE,MAAM,KACtB,wBAAwB,GAAG,IAAI,CAAC;IACrC;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,CACvB,SAAS,EAAE,MAAM,KAChB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,kBAAkB,GAAG,IAAI,CAAC;CACvE;AA+CD;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CACzC,IAAI,EAAE,mBAAmB,GAC1B,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CAyDnC"}
+{"version":3,"file":"dream-timer.d.ts","sourceRoot":"","sources":["../../src/plugin/dream-timer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AASpE,OAAO,EAEH,KAAK,wBAAwB,EAChC,MAAM,8DAA8D,CAAC;AA4BtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAGpF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAO7C;;;;;GAKG;AACH,UAAU,mBAAmB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE;QAChB,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,CACvB,EAAE,EAAE,QAAQ,EACZ,eAAe,EAAE,MAAM,KACtB,wBAAwB,GAAG,IAAI,CAAC;IACrC;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,CACvB,SAAS,EAAE,MAAM,KAChB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,kBAAkB,GAAG,IAAI,CAAC;CACvE;AA+CD;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CACzC,IAAI,EAAE,mBAAmB,GAC1B,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CAyDnC"}

package/dist/plugin/hooks/create-session-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-session-hooks.d.ts","sourceRoot":"","sources":["../../../src/plugin/hooks/create-session-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAO7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BjF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;IACvC,gBAAgB,EAAE,gBAAgB,CAAC;CACtC;;;;;;qBA+B+zJ,CAAC;;;;;;;;;;;;qBAA7lD,CAAC;mBAAyB,CAAC;iBAAuB,CAAC;iBAAuB,CAAC;0BAAc,CAAC;uBAAiB,CAAC;;;;;;0BAAu6lC,CAAC;;;;;;EADvvsC"}
+{"version":3,"file":"create-session-hooks.d.ts","sourceRoot":"","sources":["../../../src/plugin/hooks/create-session-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAO7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BjF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;IACvC,gBAAgB,EAAE,gBAAgB,CAAC;CACtC;;;;;;qBA+By6J,CAAC;;;;;;;;;;;;qBAAvsD,CAAC;mBAAyB,CAAC;iBAAuB,CAAC;iBAAuB,CAAC;0BAAc,CAAC;uBAAiB,CAAC;;;;;;0BAAmtmC,CAAC;;;;;;EADnitC"}

package/dist/shared/announcement.d.ts

@@ -18,7 +18,7 @@
  * Bump only when there are user-visible changes worth a startup dialog.
  * Does NOT need to match the published package version.
  */
-export declare const ANNOUNCEMENT_VERSION = "0.27.0";
+export declare const ANNOUNCEMENT_VERSION = "0.28.0";
 /**
  * Short, user-facing bullet strings. Keep each line ~80 chars or shorter so the
  * TUI dialog renders cleanly without horizontal scroll on a typical terminal.

package/dist/shared/announcement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"announcement.d.ts","sourceRoot":"","sources":["../../src/shared/announcement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAMvD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,qDAAqD,CAAC;AAyBtF;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAS1D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CA0BhD"}
+{"version":3,"file":"announcement.d.ts","sourceRoot":"","sources":["../../src/shared/announcement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAGvD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,qDAAqD,CAAC;AAyBtF;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAS1D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CA0BhD"}

package/dist/shared/tui-preferences.d.ts

@@ -3,7 +3,7 @@ export declare function getTuiPreferencesFile(): string;
 export declare function readTuiPreferencesFile(): Promise<Record<string, unknown>>;
 export declare function readTuiPreferencesFileSync(): Record<string, unknown>;
 export declare const PLUGIN_KEY = "magic-context";
-export declare const DEFAULT_SLOT_ORDER = 200;
+export declare const DEFAULT_SLOT_ORDER = 170;
 export interface MagicContextTuiPrefs {
     forceToTop: boolean;
     order: number;

package/dist/tui/badge-contrast.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pick a readable text color (black or white) for text drawn ON TOP of a given
+ * background color.
+ *
+ * The sidebar header badge previously drew its label with `fg={theme.background}`
+ * on a `theme.accent` background. That breaks for themes that set
+ * `background: "none"` (transparent) to respect terminal transparency: the
+ * resolved background is `RGBA(0,0,0,0)`, so the badge text renders fully
+ * transparent and disappears (issue #186). The badge background (`accent`) is
+ * always opaque, so deriving the text color from it is transparency-proof.
+ *
+ * The pick is WHITE-BIASED off the accent's relative luminance: white for any
+ * accent in the dark half (luminance < 0.5), black only for genuinely light
+ * accents. A strict "higher-contrast-wins" pick (crossover at luminance 0.179)
+ * flips ordinary mid-tone accents to black: a typical orange/amber sidebar
+ * accent (luminance ~0.3) reads black ~5:1 vs white ~3.7:1, so contrast-wins
+ * picks black even though white at ~3.7:1 is perfectly legible for a short bold
+ * label. That looks heavy and clashes with the sibling status badges, so we
+ * prefer white across the whole dark half and only fall to black once the accent
+ * is actually light (pale/pastel/near-white), where white would be unreadable.
+ *
+ * `RGBA` channels from @opentui/core are normalized 0..1 floats. We accept the
+ * minimal `{ r, g, b }` shape so this stays a pure, trivially testable function
+ * independent of the native color class.
+ */
+export declare function readableTextColorOn(bg: {
+    r: number;
+    g: number;
+    b: number;
+}): string;
+//# sourceMappingURL=badge-contrast.d.ts.map

package/dist/tui/badge-contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"badge-contrast.d.ts","sourceRoot":"","sources":["../../src/tui/badge-contrast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAmBH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEnF"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cortexkit/opencode-magic-context",
-	"version": "0.27.2",
+	"version": "0.28.0",
 	"type": "module",
 	"description": "OpenCode plugin for Magic Context — cross-session memory and context management",
 	"main": "dist/index.js",

package/src/shared/announcement.ts

@@ -24,18 +24,15 @@ import { getMagicContextStorageDir } from "./data-path";
  * Bump only when there are user-visible changes worth a startup dialog.
  * Does NOT need to match the published package version.
  */
-export const ANNOUNCEMENT_VERSION = "0.27.0";
+export const ANNOUNCEMENT_VERSION = "0.28.0";
 
 /**
  * Short, user-facing bullet strings. Keep each line ~80 chars or shorter so the
  * TUI dialog renders cleanly without horizontal scroll on a typical terminal.
  */
 export const ANNOUNCEMENT_FEATURES: ReadonlyArray<string> = [
-    "Dreamer V2: each maintenance task now runs on its own schedule (cron), with its own model. Configure them in setup, the dashboard, or magic-context.jsonc.",
-    "New 'classify' task scores each memory's importance so the most relevant stay in context as your work shifts; new 'retrospective' learns from moments you had to correct or re-explain. Both cache-safe, on by default, off anytime.",
-    "New Primers: durable answers to the questions that keep coming up about your project, kept current by the dreamer investigating the actual code.",
-    "Embedding storage no longer wipes your vectors when you change model or endpoint. Different models now coexist, so switching providers keeps your existing vectors.",
-    "Config moved to a shared CortexKit location (~/.config/cortexkit/ and <project>/.cortexkit/). This happens automatically on first run; your old file is preserved.",
+    'New \'language\' option: set a top-level 2-letter language code (e.g. "tr" or "es") and Magic Context writes its summaries, memories, and guidance in that language, while keeping all structure (tags, categories, code, paths) in English. User-level only, off by default.',
+    "The ctx_reduce reminder now reflects how much tool output is actually reclaimable, instead of escalating to 'urgent' just because you're near compaction. It also no longer suggests dropping the agent's task list or tiny status outputs.",
 ];
 
 /**

package/src/shared/tui-preferences.ts

@@ -11,7 +11,7 @@ import { parse, stringify } from "comment-json";
 // Cross-plugin convention (anthropic-auth / aft / magic-context all mirror it):
 //   - same file name + env override + lookup order,
 //   - byte-identical `computeEffectiveOrder` so the three sort consistently,
-//   - a coordinated default-order ladder (anthropic-auth 160, AFT 180, MC 200).
+//   - a coordinated default-order ladder (anthropic-auth 160, MC 170, AFT 180).
 //
 // MC uses `comment-json` (already a dep, Bun-safe) for the WRITE path — a full
 // parse → mutate-one-key → stringify round-trip that preserves comments and
@@ -64,7 +64,7 @@ export function readTuiPreferencesFileSync(): Record<string, unknown> {
 }
 
 export const PLUGIN_KEY = "magic-context";
-export const DEFAULT_SLOT_ORDER = 200;
+export const DEFAULT_SLOT_ORDER = 170;
 
 export interface MagicContextTuiPrefs {
     forceToTop: boolean;

package/src/tui/badge-contrast.test.ts

@@ -0,0 +1,45 @@
+import { describe, expect, test } from "bun:test";
+import { readableTextColorOn } from "./badge-contrast";
+
+describe("readableTextColorOn", () => {
+    test("dark accent gets white text", () => {
+        // A typical dark accent (deep blue/purple) should read as white.
+        expect(readableTextColorOn({ r: 0.1, g: 0.1, b: 0.3 })).toBe("#ffffff");
+        expect(readableTextColorOn({ r: 0, g: 0, b: 0 })).toBe("#ffffff");
+    });
+
+    test("light accent gets black text", () => {
+        // Only accents pale enough that white fails the contrast bar go black.
+        expect(readableTextColorOn({ r: 0.9, g: 0.9, b: 0.7 })).toBe("#000000");
+        expect(readableTextColorOn({ r: 1, g: 1, b: 1 })).toBe("#000000");
+    });
+
+    test("mid-tone orange accent prefers white (white-bias, matches sibling badges)", () => {
+        // A typical orange/amber accent reads white ~4:1 and black ~5:1. A
+        // higher-contrast-wins pick would flip it to black (the #186 over-
+        // correction); the white bias keeps it white, clearing the bold-text bar.
+        expect(readableTextColorOn({ r: 0.69, g: 0.455, b: 0.188 })).toBe("#ffffff");
+        expect(readableTextColorOn({ r: 0.741, g: 0.482, b: 0.2 })).toBe("#ffffff");
+    });
+
+    test("pure green is treated as light (white fails the contrast bar)", () => {
+        // A saturated green is bright enough that white drops below the bar.
+        expect(readableTextColorOn({ r: 0, g: 1, b: 0 })).toBe("#000000");
+    });
+
+    test("pure blue is treated as dark (low luma weight)", () => {
+        // Blue contributes little to perceived brightness, so a saturated blue
+        // badge needs light text.
+        expect(readableTextColorOn({ r: 0, g: 0, b: 1 })).toBe("#ffffff");
+    });
+
+    test("does not depend on the (possibly transparent) background alpha", () => {
+        // The helper only reads r/g/b — the regression in #186 was using a
+        // background color whose alpha could be 0. Two accents with identical
+        // rgb resolve identically regardless of any alpha the caller might pass.
+        const a = readableTextColorOn({ r: 0.2, g: 0.2, b: 0.2 });
+        const b = readableTextColorOn({ r: 0.2, g: 0.2, b: 0.2 });
+        expect(a).toBe(b);
+        expect(a).toBe("#ffffff");
+    });
+});

package/src/tui/badge-contrast.ts

@@ -0,0 +1,46 @@
+/**
+ * Pick a readable text color (black or white) for text drawn ON TOP of a given
+ * background color.
+ *
+ * The sidebar header badge previously drew its label with `fg={theme.background}`
+ * on a `theme.accent` background. That breaks for themes that set
+ * `background: "none"` (transparent) to respect terminal transparency: the
+ * resolved background is `RGBA(0,0,0,0)`, so the badge text renders fully
+ * transparent and disappears (issue #186). The badge background (`accent`) is
+ * always opaque, so deriving the text color from it is transparency-proof.
+ *
+ * The pick is WHITE-BIASED off the accent's relative luminance: white for any
+ * accent in the dark half (luminance < 0.5), black only for genuinely light
+ * accents. A strict "higher-contrast-wins" pick (crossover at luminance 0.179)
+ * flips ordinary mid-tone accents to black: a typical orange/amber sidebar
+ * accent (luminance ~0.3) reads black ~5:1 vs white ~3.7:1, so contrast-wins
+ * picks black even though white at ~3.7:1 is perfectly legible for a short bold
+ * label. That looks heavy and clashes with the sibling status badges, so we
+ * prefer white across the whole dark half and only fall to black once the accent
+ * is actually light (pale/pastel/near-white), where white would be unreadable.
+ *
+ * `RGBA` channels from @opentui/core are normalized 0..1 floats. We accept the
+ * minimal `{ r, g, b }` shape so this stays a pure, trivially testable function
+ * independent of the native color class.
+ */
+
+// Luminance midpoint: accents below this keep white text, accents at/above it
+// (light/pastel/near-white) get black. White-biased relative to the strict
+// equal-contrast crossover (~0.179) so saturated mid-tone accents stay white.
+const LIGHT_ACCENT_LUMINANCE = 0.5;
+
+function srgbChannelToLinear(c: number): number {
+    return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+}
+
+function relativeLuminance(bg: { r: number; g: number; b: number }): number {
+    return (
+        0.2126 * srgbChannelToLinear(bg.r) +
+        0.7152 * srgbChannelToLinear(bg.g) +
+        0.0722 * srgbChannelToLinear(bg.b)
+    );
+}
+
+export function readableTextColorOn(bg: { r: number; g: number; b: number }): string {
+    return relativeLuminance(bg) < LIGHT_ACCENT_LUMINANCE ? "#ffffff" : "#000000";
+}

package/src/tui/slots/sidebar-content.tsx

@@ -2,6 +2,7 @@
 import { Show, createEffect, createMemo, createSignal, on, onCleanup } from "solid-js"
 import type { TuiSlotPlugin, TuiPluginApi, TuiThemeCurrent } from "@opencode-ai/plugin/tui"
 import packageJson from "../../../package.json"
+import { readableTextColorOn } from '../badge-contrast';
 import { loadSidebarSnapshot, type SidebarSnapshot } from "../data/context-db"
 import { formatThresholdPercent } from "../../shared/format-threshold"
 import {
@@ -694,7 +695,7 @@ const SidebarContent = (props: {
                 onMouseDown={() => props.controller.toggleCollapsed()}
             >
                 <box paddingLeft={1} paddingRight={1} backgroundColor={props.theme.accent}>
-                    <text fg={props.theme.background}>
+                    <text fg={readableTextColorOn(props.theme.accent)}>
                         <b>{collapsed() ? "▶ " : "▼ "}{headerLabel()}</b>
                     </text>
                 </box>