@cortexkit/opencode-magic-context 0.21.6 → 0.21.7

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

@@ -21,4 +21,14 @@ export declare function cleanupConflictWarnings(client: unknown, directory: stri
  * Sends an ignored message that auto-deletes after 1 second.
  */
 export declare function sendTuiSetupNotification(client: unknown, directory: string, serverUrl?: string): Promise<void>;
+/**
+ * Desktop startup announcement: post a one-shot ignored message describing
+ * what's new in this release. Mirrors the TUI's RPC-driven dialog path so both
+ * surfaces deliver the same announcement once per ANNOUNCEMENT_VERSION.
+ *
+ * Persistence lives in `getMagicContextStorageDir()/last_announced_version`,
+ * shared with the TUI handlers and the Pi plugin so a dismissal in any harness
+ * suppresses the others for the same announcement.
+ */
+export declare function sendStartupAnnouncement(client: unknown, directory: string, version: string, features: ReadonlyArray<string>, footer: string, markSeen: (version: string) => void): Promise<void>;
 //# sourceMappingURL=conflict-warning-hook.d.ts.map

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;AAmLlE;;GAEG;AACH,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,cAAc,GAC/B,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CACzC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAqHf;AAkCD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC1C,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAkEf"}
+{"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;AAoLlE;;GAEG;AACH,wBAAsB,mBAAmB,CACrC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,cAAc,GAC/B,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CACzC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAqHf;AAkCD;;;GAGG;AACH,wBAAsB,wBAAwB,CAC1C,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAkEf;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,CA8Df"}

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":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAapE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK7C;;;;;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,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,uBAAuB,CAAC,EAAE;QACtB,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,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;CACxE;AAQD;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CACzC,IAAI,EAAE,mBAAmB,GAC1B,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CA0DnC"}
+{"version":3,"file":"dream-timer.d.ts","sourceRoot":"","sources":["../../src/plugin/dream-timer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAapE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK7C;;;;;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,wBAAwB,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5E,uBAAuB,CAAC,EAAE;QACtB,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,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;CACxE;AAQD;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CACzC,IAAI,EAAE,mBAAmB,GAC1B,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC,CA4DnC"}

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;AAU7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;IACvC,gBAAgB,EAAE,gBAAgB,CAAC;CACtC;;;;;;qBAoDkuJ,CAAC;;;;;;;;;;;;qBAA9sC,CAAC;mBAAyB,CAAC;iBAAuB,CAAC;iBAAuB,CAAC;0BAAc,CAAC;uBAAiB,CAAC;;;;;;0BAAwgtB,CAAC;;;;;;EAD1o0B"}
+{"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;AAU7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;IACvC,gBAAgB,EAAE,gBAAgB,CAAC;CACtC;;;;;;qBAoDkuJ,CAAC;;;;;;;;;;;;qBAA9sC,CAAC;mBAAyB,CAAC;iBAAuB,CAAC;iBAAuB,CAAC;0BAAc,CAAC;uBAAiB,CAAC;;;;;;0BAA+luB,CAAC;;;;;;EADju1B"}

package/dist/plugin/rpc-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc-handlers.d.ts","sourceRoot":"","sources":["../../src/plugin/rpc-handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAE,KAAK,eAAe,IAAI,QAAQ,EAAgB,MAAM,mCAAmC,CAAC;AAWnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AASlF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAmDzE,wBAAgB,oBAAoB,CAChC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,qBAAqB,CAAC,EAAE,MAAM,EAK9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,eAAe,CA6UjB;AAED,wBAAgB,iBAAiB,CAC7B,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,qBAAqB,CAAC,EAAE,MAAM,GAC/B,YAAY,CAuKd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,SAAS,EAAE,qBAAqB,EAChC,IAAI,EAAE;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,gBAAgB,CAAC;CACtC,GACF,IAAI,CAwIN"}
+{"version":3,"file":"rpc-handlers.d.ts","sourceRoot":"","sources":["../../src/plugin/rpc-handlers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGzE,OAAO,EAAE,KAAK,eAAe,IAAI,QAAQ,EAAgB,MAAM,mCAAmC,CAAC;AAWnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAgBlF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAmDzE,wBAAgB,oBAAoB,CAChC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,qBAAqB,CAAC,EAAE,MAAM,EAK9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,eAAe,CA6UjB;AAED,wBAAgB,iBAAiB,CAC7B,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,qBAAqB,CAAC,EAAE,MAAM,GAC/B,YAAY,CAuKd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,SAAS,EAAE,qBAAqB,EAChC,IAAI,EAAE;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,gBAAgB,CAAC;CACtC,GACF,IAAI,CAkKN"}

package/dist/plugin/tool-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/plugin/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAe1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;CAC1C,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAyEjC"}
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/plugin/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAgB1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,EAAE,wBAAwB,CAAC;CAC1C,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAyEjC"}

package/dist/shared/announcement.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Release-notes startup announcement shared by OpenCode plugin and Pi plugin.
+ *
+ * Bump `ANNOUNCEMENT_VERSION` and populate `ANNOUNCEMENT_FEATURES` *only* when a
+ * release ships user-facing news worth surfacing once at startup. Patch releases
+ * with no user-visible changes should leave both untouched — that way a user who
+ * already dismissed the dialog for the current `ANNOUNCEMENT_VERSION` won't see
+ * it again on the next bugfix bump.
+ *
+ * The persisted state is a single line of text (`last_announced_version`) under
+ * `getMagicContextStorageDir()`. OpenCode and Pi share the same file because
+ * they share the same storage root — so dismissing in one harness suppresses
+ * the dialog in the other for the same announcement.
+ *
+ * Leave both empty (`""` and `[]`) to skip the dialog entirely.
+ */
+/**
+ * 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.21.7";
+/**
+ * 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 declare const ANNOUNCEMENT_FEATURES: ReadonlyArray<string>;
+/**
+ * Persistent footer rendered below the version-specific bullets in every
+ * announcement. Stays in place across releases so users always see the Discord
+ * invite without us needing to repeat it in `ANNOUNCEMENT_FEATURES` each time.
+ *
+ * Leave empty (`""`) to suppress the footer.
+ */
+export declare const ANNOUNCEMENT_FOOTER = "Join us on Discord: https://discord.gg/F2uWxjGnU";
+/**
+ * Read the most recently dismissed announcement version, or `""` if none.
+ *
+ * Best-effort: any read failure returns `""` (which forces the announcement to
+ * re-show). The cost of a spurious second dialog is much smaller than the cost
+ * of suppressing a real announcement due to a transient FS error.
+ */
+export declare function readLastAnnouncedVersion(): string;
+/**
+ * Persist `version` as the most recently dismissed announcement. Best-effort:
+ * write failures are swallowed so dialog-confirm flows never throw on storage
+ * errors. Worst case the user sees the same dialog once more on next startup.
+ */
+export declare function markAnnouncementSeen(version: string): void;
+/**
+ * True when the configured `ANNOUNCEMENT_VERSION` has not yet been dismissed
+ * AND there is at least one feature to show. Used by both the TUI dialog path
+ * and the Desktop ignored-message fallback.
+ */
+export declare function shouldShowAnnouncement(): boolean;
+//# sourceMappingURL=announcement.d.ts.map

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

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

package/dist/shared/format-threshold.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Format an execute-threshold percentage for human-facing display.
+ *
+ * `executeThreshold` in the snapshot is always a percentage number, but it
+ * comes from two very different config paths:
+ *   1. `execute_threshold_percentage` (or its model-keyed variant) — user
+ *      configures an integer like 65 directly. We must render exactly that.
+ *   2. `execute_threshold_tokens` — user configures absolute token cap (e.g.
+ *      128000). The resolver in `event-resolvers.ts` divides that by the
+ *      model's context limit (`(128000 / 907788) * 100`) and the result is
+ *      a long float like `14.099783080260304` that overflows the TUI cell
+ *      (issue #90).
+ *
+ * Behaviour:
+ *   - Integer input (≤0.05 fractional drift) renders without decimals.
+ *   - Anything else is rendered with one decimal digit, which is precise
+ *     enough to convey the configured token budget without smearing across
+ *     two lines in a narrow sidebar.
+ *
+ * Returns the formatted percentage WITHOUT the trailing `%` so callers can
+ * compose richer strings like `47.5% / 65%` consistently.
+ */
+export declare function formatThresholdPercent(value: number | undefined | null): string;
+//# sourceMappingURL=format-threshold.d.ts.map

package/dist/shared/format-threshold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-threshold.d.ts","sourceRoot":"","sources":["../../src/shared/format-threshold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAK/E"}

package/dist/tui/data/context-db.d.ts

@@ -17,6 +17,20 @@ export interface TuiMessage {
     payload: Record<string, unknown>;
     sessionId?: string;
 }
+/**
+ * Fetch the current startup announcement from the server, if any.
+ * Returns `{show: false}` when there's nothing to announce or when the
+ * configured ANNOUNCEMENT_VERSION has already been dismissed.
+ */
+export interface AnnouncementResponse {
+    show: boolean;
+    version?: string;
+    features?: string[];
+    footer?: string;
+}
+export declare function getAnnouncement(): Promise<AnnouncementResponse>;
+/** Mark the current ANNOUNCEMENT_VERSION as dismissed on the server. */
+export declare function markAnnounced(): Promise<boolean>;
 /** Poll for pending server→TUI notifications via RPC. */
 export declare function consumeTuiMessages(): Promise<TuiMessage[]>;
 //# sourceMappingURL=context-db.d.ts.map

package/dist/tui/data/context-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-db.d.ts","sourceRoot":"","sources":["../../../src/tui/data/context-db.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAA0B,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEpG,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AAc9C,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGrD;AAED,+BAA+B;AAC/B,wBAAgB,QAAQ,IAAI,IAAI,CAI/B;AAwFD,sDAAsD;AACtD,wBAAsB,mBAAmB,CACrC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CA4B1B;AAED,wDAAwD;AACxD,wBAAsB,gBAAgB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CA4CvB;AAED,qCAAqC;AACrC,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ5E;AAED,6CAA6C;AAC7C,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQvE;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,yDAAyD;AACzD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAqBhE"}
+{"version":3,"file":"context-db.d.ts","sourceRoot":"","sources":["../../../src/tui/data/context-db.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAA0B,eAAe,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEpG,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AAc9C,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGrD;AAED,+BAA+B;AAC/B,wBAAgB,QAAQ,IAAI,IAAI,CAI/B;AAwFD,sDAAsD;AACtD,wBAAsB,mBAAmB,CACrC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CA4B1B;AAED,wDAAwD;AACxD,wBAAsB,gBAAgB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CA4CvB;AAED,qCAAqC;AACrC,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ5E;AAED,6CAA6C;AAC7C,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQvE;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAkBrE;AAED,wEAAwE;AACxE,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAQtD;AAED,yDAAyD;AACzD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAqBhE"}

package/package.json

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

package/src/shared/announcement.test.ts

@@ -0,0 +1,143 @@
+import { afterEach, beforeEach, describe, expect, test } from "bun:test";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+
+/**
+ * `announcement.ts` reads/writes a single `last_announced_version` file under
+ * `getMagicContextStorageDir()`. The behavior we test:
+ *   1. `markAnnouncementSeen` then `readLastAnnouncedVersion` round-trips
+ *   2. `shouldShowAnnouncement` returns false after a matching mark
+ *   3. `shouldShowAnnouncement` returns true after a non-matching mark
+ *   4. Empty-version inputs are no-ops (don't crash, don't write garbage)
+ *
+ * We isolate writes by pointing `XDG_DATA_HOME` at a temp dir before requiring
+ * the module fresh per test, since the module captures the storage path at
+ * import time via `getMagicContextStorageDir()`.
+ */
+
+let tmpRoot = "";
+let originalXdg: string | undefined;
+
+beforeEach(() => {
+    tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "mc-announcement-test-"));
+    originalXdg = process.env.XDG_DATA_HOME;
+    process.env.XDG_DATA_HOME = tmpRoot;
+});
+
+afterEach(() => {
+    if (originalXdg === undefined) {
+        delete process.env.XDG_DATA_HOME;
+    } else {
+        process.env.XDG_DATA_HOME = originalXdg;
+    }
+    try {
+        fs.rmSync(tmpRoot, { recursive: true, force: true });
+    } catch {
+        // best-effort
+    }
+});
+
+describe("announcement state persistence", () => {
+    test("round-trips a dismissed version through the file", async () => {
+        // Fresh import after XDG override so the module captures the temp path
+        const mod = await import(`./announcement?t=${Date.now()}-rt`);
+        const { readLastAnnouncedVersion, markAnnouncementSeen } = mod;
+
+        expect(readLastAnnouncedVersion()).toBe("");
+
+        markAnnouncementSeen("9.9.9");
+        expect(readLastAnnouncedVersion()).toBe("9.9.9");
+
+        markAnnouncementSeen("9.9.10");
+        expect(readLastAnnouncedVersion()).toBe("9.9.10");
+    });
+
+    test("ignores empty / zero-length version marks", async () => {
+        const mod = await import(`./announcement?t=${Date.now()}-empty`);
+        const { readLastAnnouncedVersion, markAnnouncementSeen } = mod;
+
+        markAnnouncementSeen("");
+        expect(readLastAnnouncedVersion()).toBe("");
+    });
+
+    test("creates the storage directory if it does not exist", async () => {
+        const mod = await import(`./announcement?t=${Date.now()}-mkdir`);
+        const { markAnnouncementSeen } = mod;
+
+        // Storage dir lives under tmpRoot + cortexkit/magic-context — does not
+        // exist yet at the start of the test
+        const expectedDir = path.join(tmpRoot, "cortexkit", "magic-context");
+        expect(fs.existsSync(expectedDir)).toBe(false);
+
+        markAnnouncementSeen("0.21.7");
+
+        expect(fs.existsSync(expectedDir)).toBe(true);
+        expect(fs.readFileSync(path.join(expectedDir, "last_announced_version"), "utf-8")).toBe(
+            "0.21.7",
+        );
+    });
+
+    test("trims whitespace from stored version on read", async () => {
+        const mod = await import(`./announcement?t=${Date.now()}-trim`);
+        const { readLastAnnouncedVersion } = mod;
+
+        const dir = path.join(tmpRoot, "cortexkit", "magic-context");
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(path.join(dir, "last_announced_version"), "  1.2.3  \n");
+
+        expect(readLastAnnouncedVersion()).toBe("1.2.3");
+    });
+});
+
+describe("shouldShowAnnouncement gating", () => {
+    test("returns false when the live version is already marked", async () => {
+        const mod = await import(`./announcement?t=${Date.now()}-match`);
+        const {
+            ANNOUNCEMENT_VERSION,
+            ANNOUNCEMENT_FEATURES,
+            markAnnouncementSeen,
+            shouldShowAnnouncement,
+        } = mod;
+
+        // Skip the test if announcements are currently disabled (empty constants)
+        // — the gate's empty-input behavior is covered separately below.
+        if (!ANNOUNCEMENT_VERSION || ANNOUNCEMENT_FEATURES.length === 0) {
+            return;
+        }
+
+        markAnnouncementSeen(ANNOUNCEMENT_VERSION);
+        expect(shouldShowAnnouncement()).toBe(false);
+    });
+
+    test("returns true when the live version was never marked", async () => {
+        const mod = await import(`./announcement?t=${Date.now()}-none`);
+        const { ANNOUNCEMENT_VERSION, ANNOUNCEMENT_FEATURES, shouldShowAnnouncement } = mod;
+
+        if (!ANNOUNCEMENT_VERSION || ANNOUNCEMENT_FEATURES.length === 0) {
+            // When empty, the gate is always false regardless of state
+            expect(shouldShowAnnouncement()).toBe(false);
+            return;
+        }
+
+        // No mark has been written in this fresh tmpRoot, so the gate is open
+        expect(shouldShowAnnouncement()).toBe(true);
+    });
+
+    test("returns true when a different (older) version is marked", async () => {
+        const mod = await import(`./announcement?t=${Date.now()}-older`);
+        const {
+            ANNOUNCEMENT_VERSION,
+            ANNOUNCEMENT_FEATURES,
+            markAnnouncementSeen,
+            shouldShowAnnouncement,
+        } = mod;
+
+        if (!ANNOUNCEMENT_VERSION || ANNOUNCEMENT_FEATURES.length === 0) {
+            return;
+        }
+
+        markAnnouncementSeen("0.0.0-pre-historic");
+        expect(shouldShowAnnouncement()).toBe(true);
+    });
+});

package/src/shared/announcement.ts

@@ -0,0 +1,97 @@
+/**
+ * Release-notes startup announcement shared by OpenCode plugin and Pi plugin.
+ *
+ * Bump `ANNOUNCEMENT_VERSION` and populate `ANNOUNCEMENT_FEATURES` *only* when a
+ * release ships user-facing news worth surfacing once at startup. Patch releases
+ * with no user-visible changes should leave both untouched — that way a user who
+ * already dismissed the dialog for the current `ANNOUNCEMENT_VERSION` won't see
+ * it again on the next bugfix bump.
+ *
+ * The persisted state is a single line of text (`last_announced_version`) under
+ * `getMagicContextStorageDir()`. OpenCode and Pi share the same file because
+ * they share the same storage root — so dismissing in one harness suppresses
+ * the dialog in the other for the same announcement.
+ *
+ * Leave both empty (`""` and `[]`) to skip the dialog entirely.
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+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.21.7";
+
+/**
+ * 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> = [
+    "Pi parity sweep: 44 audit findings fixed, including a critical SHIP-BLOCKER where /ctx-flush did not drain the pending Pi compaction queue.",
+    "Pi historian recovery fix: empty/no-op historian returns now clear emergency recovery so sessions cannot loop forever at 95%.",
+    "trimPiMessagesToBoundary now sweeps non-contiguous tool-result orphans, fixing provider 400s after compaction in long Pi sessions.",
+    "Hidden subagent tool isolation: historian, dreamer, and sidekick can no longer spawn subagents or run unsafe tools.",
+    "TUI sidebar and /ctx-status header now show execute threshold inline: '47.5% / 65%' on the left, '475K / 1.0M' on the right.",
+    "doctor --issue now caps GitHub issue bodies at ~60KB with a dedicated 'Recent errors' section so reports stay submittable.",
+];
+
+/**
+ * Persistent footer rendered below the version-specific bullets in every
+ * announcement. Stays in place across releases so users always see the Discord
+ * invite without us needing to repeat it in `ANNOUNCEMENT_FEATURES` each time.
+ *
+ * Leave empty (`""`) to suppress the footer.
+ */
+export const ANNOUNCEMENT_FOOTER = "Join us on Discord: https://discord.gg/F2uWxjGnU";
+
+const STATE_FILENAME = "last_announced_version";
+
+function getStateFilePath(): string {
+    return path.join(getMagicContextStorageDir(), STATE_FILENAME);
+}
+
+/**
+ * Read the most recently dismissed announcement version, or `""` if none.
+ *
+ * Best-effort: any read failure returns `""` (which forces the announcement to
+ * re-show). The cost of a spurious second dialog is much smaller than the cost
+ * of suppressing a real announcement due to a transient FS error.
+ */
+export function readLastAnnouncedVersion(): string {
+    try {
+        const file = getStateFilePath();
+        if (!fs.existsSync(file)) return "";
+        return fs.readFileSync(file, "utf-8").trim();
+    } catch {
+        return "";
+    }
+}
+
+/**
+ * Persist `version` as the most recently dismissed announcement. Best-effort:
+ * write failures are swallowed so dialog-confirm flows never throw on storage
+ * errors. Worst case the user sees the same dialog once more on next startup.
+ */
+export function markAnnouncementSeen(version: string): void {
+    if (!version) return;
+    try {
+        const dir = getMagicContextStorageDir();
+        fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(getStateFilePath(), version);
+    } catch {
+        // best-effort
+    }
+}
+
+/**
+ * True when the configured `ANNOUNCEMENT_VERSION` has not yet been dismissed
+ * AND there is at least one feature to show. Used by both the TUI dialog path
+ * and the Desktop ignored-message fallback.
+ */
+export function shouldShowAnnouncement(): boolean {
+    if (!ANNOUNCEMENT_VERSION || ANNOUNCEMENT_FEATURES.length === 0) return false;
+    return readLastAnnouncedVersion() !== ANNOUNCEMENT_VERSION;
+}

package/src/shared/format-threshold.ts

@@ -0,0 +1,28 @@
+/**
+ * Format an execute-threshold percentage for human-facing display.
+ *
+ * `executeThreshold` in the snapshot is always a percentage number, but it
+ * comes from two very different config paths:
+ *   1. `execute_threshold_percentage` (or its model-keyed variant) — user
+ *      configures an integer like 65 directly. We must render exactly that.
+ *   2. `execute_threshold_tokens` — user configures absolute token cap (e.g.
+ *      128000). The resolver in `event-resolvers.ts` divides that by the
+ *      model's context limit (`(128000 / 907788) * 100`) and the result is
+ *      a long float like `14.099783080260304` that overflows the TUI cell
+ *      (issue #90).
+ *
+ * Behaviour:
+ *   - Integer input (≤0.05 fractional drift) renders without decimals.
+ *   - Anything else is rendered with one decimal digit, which is precise
+ *     enough to convey the configured token budget without smearing across
+ *     two lines in a narrow sidebar.
+ *
+ * Returns the formatted percentage WITHOUT the trailing `%` so callers can
+ * compose richer strings like `47.5% / 65%` consistently.
+ */
+export function formatThresholdPercent(value: number | undefined | null): string {
+    if (typeof value !== "number" || !Number.isFinite(value)) return "—";
+    const rounded = Math.round(value);
+    if (Math.abs(value - rounded) < 0.05) return String(rounded);
+    return value.toFixed(1);
+}

package/src/tui/data/context-db.ts

@@ -233,6 +233,49 @@ export interface TuiMessage {
     sessionId?: string;
 }
 
+/**
+ * Fetch the current startup announcement from the server, if any.
+ * Returns `{show: false}` when there's nothing to announce or when the
+ * configured ANNOUNCEMENT_VERSION has already been dismissed.
+ */
+export interface AnnouncementResponse {
+    show: boolean;
+    version?: string;
+    features?: string[];
+    footer?: string;
+}
+
+export async function getAnnouncement(): Promise<AnnouncementResponse> {
+    if (!rpcClient) return { show: false };
+    try {
+        const result = await rpcClient.call<{
+            show?: boolean;
+            version?: string;
+            features?: string[];
+            footer?: string;
+        }>("get-announcement", {});
+        return {
+            show: result.show === true,
+            version: result.version,
+            features: Array.isArray(result.features) ? result.features : undefined,
+            footer: typeof result.footer === "string" ? result.footer : undefined,
+        };
+    } catch {
+        return { show: false };
+    }
+}
+
+/** Mark the current ANNOUNCEMENT_VERSION as dismissed on the server. */
+export async function markAnnounced(): Promise<boolean> {
+    if (!rpcClient) return false;
+    try {
+        const result = await rpcClient.call<{ ok?: boolean }>("mark-announced", {});
+        return result.ok === true;
+    } catch {
+        return false;
+    }
+}
+
 /** Poll for pending server→TUI notifications via RPC. */
 export async function consumeTuiMessages(): Promise<TuiMessage[]> {
     if (!rpcClient) return [];

package/src/tui/index.tsx

@@ -6,7 +6,8 @@ import { createMemo } from "solid-js"
 import type { TuiPlugin, TuiPluginApi, TuiThemeCurrent } from "@opencode-ai/plugin/tui"
 import { createSidebarContentSlot } from "./slots/sidebar-content"
 import packageJson from "../../package.json"
-import { closeRpc, consumeTuiMessages, getCompartmentCount, initRpcClient, loadStatusDetail, requestRecomp, type StatusDetail } from "./data/context-db"
+import { closeRpc, consumeTuiMessages, getAnnouncement, getCompartmentCount, initRpcClient, loadStatusDetail, markAnnounced, requestRecomp, type StatusDetail } from "./data/context-db"
+import { formatThresholdPercent } from "../shared/format-threshold"
 import { detectConflicts } from "../shared/conflict-detector"
 import { fixConflicts } from "../shared/conflict-fixer"
 import { readJsoncFile } from "../shared/jsonc-parser"
@@ -296,7 +297,7 @@ const StatusDialog = (props: { api: TuiPluginApi; s: StatusDetail }) => {
                 them how close they are to compaction triggering. */}
             <box flexDirection="row" justifyContent="space-between" width="100%">
                 <text fg={s().usagePercentage >= 80 ? t().error : s().usagePercentage >= 65 ? t().warning : t().accent}>
-                    <b>{s().usagePercentage.toFixed(1)}%</b> / {s().executeThreshold}%
+                    <b>{s().usagePercentage.toFixed(1)}%</b> / {formatThresholdPercent(s().executeThreshold)}%
                 </text>
                 <text fg={s().usagePercentage >= 80 ? t().error : s().usagePercentage >= 65 ? t().warning : t().accent}>
                     {fmt(s().inputTokens)} / {contextLimit() > 0 ? fmt(contextLimit()) : "?"} tokens
@@ -341,7 +342,7 @@ const StatusDialog = (props: { api: TuiPluginApi; s: StatusDetail }) => {
                     <R t={t()} l="Configured" v={s().cacheTtl} />
                     <R t={t()} l="Last response" v={s().lastResponseTime > 0 ? `${Math.round(elapsed() / 1000)}s ago` : "never"} />
                     <R t={t()} l="Remaining" v={s().cacheExpired ? "expired" : `${Math.round(s().cacheRemainingMs / 1000)}s`} fg={s().cacheExpired ? t().warning : t().textMuted} />
-                    <R t={t()} l="Auto-execute" v={s().cacheExpired ? "yes (expired)" : `at TTL or ≥${s().executeThreshold}%`} fg={t().textMuted} />
+                    <R t={t()} l="Auto-execute" v={s().cacheExpired ? "yes (expired)" : `at TTL or ≥${formatThresholdPercent(s().executeThreshold)}%`} fg={t().textMuted} />
                     <box marginTop={1}>
                         <text fg={t().text}><b>Memory</b></text>
                     </box>
@@ -351,7 +352,7 @@ const StatusDialog = (props: { api: TuiPluginApi; s: StatusDetail }) => {
                 {/* Right column */}
                 <box flexDirection="column" flexGrow={1} flexBasis={0}>
                     <text fg={t().text}><b>Rolling Nudges</b></text>
-                    <R t={t()} l="Execute threshold" v={`${s().executeThreshold}%`} />
+                    <R t={t()} l="Execute threshold" v={`${formatThresholdPercent(s().executeThreshold)}%`} />
                     <R t={t()} l="Nudge anchor" v={`${fmt(s().lastNudgeTokens)} tok`} />
                     <R t={t()} l="Interval" v={`${fmt(s().nudgeInterval)} tok`} fg={t().textMuted} />
                     <R t={t()} l="Next nudge after" v={`${fmt(s().nextNudgeAfter)} tok`} />
@@ -563,6 +564,63 @@ function registerCommandPaletteEntries(api: TuiPluginApi): void {
     // via RPC.
 }
 
+/**
+ * Show the one-shot "What's new" dialog on TUI startup if the server tells us
+ * to. The server is the source of truth: it has the version + features
+ * constants AND owns the persistence file. We just render and report back.
+ *
+ * Failure-tolerant by design — if the server isn't ready or the RPC fails,
+ * we silently skip (the next TUI launch will retry).
+ */
+/**
+ * URLs render as plain text. Modern terminals (iTerm2, kitty, WezTerm, Ghostty,
+ * recent macOS Terminal) auto-detect URLs and let users Cmd-click; older
+ * terminals require manual copy. We tried opentui's `<a href>` JSX intrinsic
+ * for application-level OSC 8 clickability, but it's a span-like element that
+ * forced text out of opentui's word-wrap mode, causing bullets to bleed past
+ * the dialog border. Pure-string children of `<text>` wrap correctly, so the
+ * AFT-style DialogAlert + plain string is the right surface here.
+ */
+async function showStartupAnnouncement(api: TuiPluginApi): Promise<void> {
+    try {
+        const ann = await getAnnouncement()
+        if (!ann.show || !ann.version || !ann.features || ann.features.length === 0) return
+
+        const title = `Magic Context v${ann.version}`
+        const lines: string[] = [
+            "What's new:",
+            "",
+            ...ann.features.map((line) => `  • ${line}`),
+        ]
+        if (ann.footer && ann.footer.trim().length > 0) {
+            // Blank-line separator keeps the persistent footer (Discord invite,
+            // etc.) visually distinct from the version-specific bullets.
+            lines.push("", ann.footer)
+        }
+        const message = lines.join("\n")
+
+        api.ui.dialog.replace(
+            () => (
+                <api.ui.DialogAlert
+                    title={title}
+                    message={message}
+                    onConfirm={() => {
+                        void markAnnounced()
+                    }}
+                />
+            ),
+            () => {
+                // User dismissed via Escape rather than confirming. Mark
+                // dismissed anyway — they saw the dialog, that's the contract.
+                void markAnnounced()
+            },
+        )
+    } catch {
+        // RPC not ready yet (port file missing or transient HTTP failure) —
+        // silently skip. The next TUI start re-checks.
+    }
+}
+
 const tui: TuiPlugin = async (api, _options, meta) => {
     // Initialize RPC client for server communication
     const directory = api.state.path.directory ?? ""
@@ -623,6 +681,12 @@ const tui: TuiPlugin = async (api, _options, meta) => {
         return
     }
 
+    // Show one-shot release announcement after conflict gate.
+    // Fire-and-forget: if the server isn't ready or RPC fails, the next TUI
+    // launch will retry. Dialog only appears once per ANNOUNCEMENT_VERSION
+    // (persisted via mark-announced RPC writing last_announced_version).
+    void showStartupAnnouncement(api)
+
     // Note: if TUI plugin is loaded, tui.json already has our entry.
     // But if the user added it manually and later removes it, or if they
     // use setup/doctor which handles tui.json, this code is already running.

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

@@ -3,6 +3,7 @@ import { createEffect, createMemo, createSignal, on, onCleanup } from "solid-js"
 import type { TuiSlotPlugin, TuiPluginApi, TuiThemeCurrent } from "@opencode-ai/plugin/tui"
 import packageJson from "../../../package.json"
 import { loadSidebarSnapshot, type SidebarSnapshot } from "../data/context-db"
+import { formatThresholdPercent } from "../../shared/format-threshold"
 
 const SINGLE_BORDER = { type: "single" } as any
 const REFRESH_DEBOUNCE_MS = 150
@@ -47,7 +48,15 @@ const TokenBreakdown = (props: {
     theme: TuiThemeCurrent
     snapshot: SidebarSnapshot
 }) => {
-    const barWidth = 36
+    // Bar width is hardcoded because the @opencode-ai/plugin/tui slot API does
+    // not expose the rendered sidebar width to plugins. 24 chars is the safe
+    // floor that fits every realistic sidebar configuration we've observed —
+    // OpenCode TUI's sidebar narrows with the terminal, and 36 (the previous
+    // value) overflowed users' actual layouts (issue #90), wrapping the bar
+    // onto a second line. If/when the slot API surfaces a real width, this
+    // should become Math.max(20, providedWidth) like the Pi status dialog
+    // already does (`Math.max(20, innerWidth)`).
+    const barWidth = 24
 
     const segments = createMemo<TokenSegment[]>(() => {
         const s = props.snapshot
@@ -370,7 +379,7 @@ const SidebarContent = (props: {
                                 "47.5% / 65%" tells the user how close they
                                 are to the next compaction trigger. */}
                             <text fg={contextSummaryColor()}>
-                                <b>{s()!.usagePercentage.toFixed(1)}%</b> / {s()!.executeThreshold}%
+                                <b>{s()!.usagePercentage.toFixed(1)}%</b> / {formatThresholdPercent(s()!.executeThreshold)}%
                             </text>
                             {/* Right: absolute token usage vs the model's
                                 full context window (separate from the