@cortexkit/aft-opencode 0.39.0 → 0.39.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/aft-opencode",
-  "version": "0.39.0",
+  "version": "0.39.2",
   "type": "module",
   "description": "OpenCode plugin for Agent File Tools (AFT) — tree-sitter and lsp powered code analysis",
   "main": "dist/index.js",
@@ -30,19 +30,19 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@cortexkit/aft-bridge": "0.39.0",
+    "@cortexkit/aft-bridge": "0.39.2",
     "@xterm/headless": "^5.5.0",
     "comment-json": "^4.6.2",
     "undici": "^7.25.0",
     "zod": "^4.1.8"
   },
   "optionalDependencies": {
-    "@cortexkit/aft-darwin-arm64": "0.39.0",
-    "@cortexkit/aft-darwin-x64": "0.39.0",
-    "@cortexkit/aft-linux-arm64": "0.39.0",
-    "@cortexkit/aft-linux-x64": "0.39.0",
-    "@cortexkit/aft-win32-arm64": "0.39.0",
-    "@cortexkit/aft-win32-x64": "0.39.0"
+    "@cortexkit/aft-darwin-arm64": "0.39.2",
+    "@cortexkit/aft-darwin-x64": "0.39.2",
+    "@cortexkit/aft-linux-arm64": "0.39.2",
+    "@cortexkit/aft-linux-x64": "0.39.2",
+    "@cortexkit/aft-win32-arm64": "0.39.2",
+    "@cortexkit/aft-win32-x64": "0.39.2"
   },
   "devDependencies": {
     "@opencode-ai/plugin": "^1.15.11",

package/src/tui/index.tsx

@@ -727,7 +727,7 @@ const tui: TuiPlugin = async (api) => {
   // command palette entry so the sidebar is available immediately when the
   // user opens their first session.
   try {
-    api.slots.register(createAftSidebarSlot(api, packageVersion));
+    api.slots.register(await createAftSidebarSlot(api, packageVersion));
   } catch {
     // Older OpenCode TUI hosts may not implement api.slots; fall through
     // and keep the slash command working.

package/src/tui/preferences.ts

@@ -0,0 +1,243 @@
+import { watch } from "node:fs";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, dirname, join } from "node:path";
+import { parse, stringify } from "comment-json";
+
+export const TUI_PREFS_FILE_ENV = "OPENCODE_TUI_PREFERENCES_FILE";
+const FILE_NAME = "tui-preferences.jsonc";
+
+export function getTuiPreferencesFile(): string {
+  const override = process.env[TUI_PREFS_FILE_ENV];
+  if (override) return override;
+  const configDir =
+    process.env.OPENCODE_CONFIG_DIR ||
+    join(process.env.XDG_CONFIG_HOME || join(homedir(), ".config"), "opencode");
+  return join(configDir, FILE_NAME);
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+export async function readTuiPreferencesFile(): Promise<Record<string, unknown>> {
+  try {
+    const raw = await readFile(getTuiPreferencesFile(), "utf8");
+    const root: unknown = parse(raw);
+    return isRecord(root) ? (root as Record<string, unknown>) : {};
+  } catch {
+    return {};
+  }
+}
+
+export const PLUGIN_KEY = "aft";
+export const DEFAULT_SLOT_ORDER = 180;
+
+export interface AftTuiPrefs {
+  forceToTop: boolean;
+  order: number;
+  startCollapsed: boolean;
+  rememberCollapsed: boolean;
+  collapsed: boolean | null;
+  header: {
+    label: string;
+    showVersion: boolean;
+  };
+  sections: {
+    searchIndex: boolean;
+    semanticIndex: boolean;
+    codeHealth: boolean;
+    compression: boolean;
+  };
+}
+
+export const DEFAULT_PREFS: AftTuiPrefs = {
+  forceToTop: false,
+  order: DEFAULT_SLOT_ORDER,
+  startCollapsed: false,
+  rememberCollapsed: true,
+  collapsed: null,
+  header: { label: "AFT", showVersion: true },
+  sections: {
+    searchIndex: true,
+    semanticIndex: true,
+    codeHealth: true,
+    compression: true,
+  },
+};
+
+function bool(value: unknown, fallback: boolean): boolean {
+  return typeof value === "boolean" ? value : fallback;
+}
+
+function int(value: unknown, fallback: number, min: number, max: number): number {
+  if (typeof value !== "number" || !Number.isFinite(value)) return fallback;
+  return Math.min(Math.max(Math.round(value), min), max);
+}
+
+function label(value: unknown, fallback: string, maxLength: number): string {
+  if (typeof value !== "string" || value.length === 0) return fallback;
+  return value.slice(0, maxLength);
+}
+
+/** Initial collapsed state from persisted prefs or startCollapsed default. */
+export function seedCollapsedFromPrefs(prefs: AftTuiPrefs): boolean {
+  return prefs.collapsed ?? prefs.startCollapsed;
+}
+
+export function resolveAftPrefs(root: Record<string, unknown>): AftTuiPrefs {
+  const entry = root[PLUGIN_KEY];
+  if (!isRecord(entry)) return structuredClone(DEFAULT_PREFS);
+
+  const d = DEFAULT_PREFS;
+  const header = isRecord(entry.header) ? entry.header : {};
+  const sections = isRecord(entry.sections) ? entry.sections : {};
+
+  return {
+    forceToTop: bool(entry.forceToTop, d.forceToTop),
+    order: int(entry.order, d.order, -10000, 10000),
+    startCollapsed: bool(entry.startCollapsed, d.startCollapsed),
+    rememberCollapsed: bool(entry.rememberCollapsed, d.rememberCollapsed),
+    collapsed: typeof entry.collapsed === "boolean" ? entry.collapsed : null,
+    header: {
+      label: label(header.label, d.header.label, 20),
+      showVersion: bool(header.showVersion, d.header.showVersion),
+    },
+    sections: {
+      searchIndex: bool(sections.searchIndex, d.sections.searchIndex),
+      semanticIndex: bool(sections.semanticIndex, d.sections.semanticIndex),
+      codeHealth: bool(sections.codeHealth, d.sections.codeHealth),
+      compression: bool(sections.compression, d.sections.compression),
+    },
+  };
+}
+
+const FORCE_TOP_BASE = -100000;
+
+export function computeEffectiveOrder(
+  root: Record<string, unknown>,
+  pluginKey: string,
+  defaultOrder: number,
+): number {
+  const entry = root[pluginKey];
+  if (!isRecord(entry)) return defaultOrder;
+  if (entry.forceToTop === true) {
+    return FORCE_TOP_BASE + Object.keys(root).indexOf(pluginKey);
+  }
+  return int(entry.order, defaultOrder, -10000, 10000);
+}
+
+const TEMPLATE = `// Shared preferences for opencode TUI plugins.
+// One top-level key per plugin (short name). See each plugin's README for
+// its supported settings. This file is safe to hand-edit; plugins update
+// individual keys in place and preserve comments.
+{}
+`;
+
+type JsonValue = string | number | boolean | null;
+
+function setNested(target: Record<string, unknown>, path: string[], value: JsonValue): void {
+  let current: Record<string, unknown> = target;
+  for (let i = 0; i < path.length - 1; i++) {
+    const key = path[i];
+    if (key === undefined) return;
+    const next = current[key];
+    if (!isRecord(next)) {
+      const created: Record<string, unknown> = {};
+      current[key] = created;
+      current = created;
+    } else {
+      current = next;
+    }
+  }
+  const leaf = path[path.length - 1];
+  if (leaf === undefined) return;
+  current[leaf] = value;
+}
+
+async function writePreference(pluginKey: string, path: string[], value: JsonValue): Promise<void> {
+  const file = getTuiPreferencesFile();
+  await mkdir(dirname(file), { recursive: true });
+  let text: string;
+  try {
+    text = await readFile(file, "utf8");
+  } catch {
+    text = "";
+  }
+  if (text.trim() === "") text = TEMPLATE;
+
+  let root: Record<string, unknown>;
+  try {
+    const parsed = parse(text);
+    root = isRecord(parsed) ? (parsed as Record<string, unknown>) : {};
+  } catch {
+    root = {};
+  }
+
+  if (!isRecord(root[pluginKey])) {
+    root[pluginKey] = {};
+  }
+  const entry = root[pluginKey] as Record<string, unknown>;
+  setNested(entry, path, value);
+
+  const next = `${stringify(root, null, 2)}\n`;
+  const tmp = `${file}.${process.pid}.tmp`;
+  await writeFile(tmp, next, "utf8");
+  await rename(tmp, file);
+}
+
+let writeChain: Promise<void> = Promise.resolve();
+
+export function queueTuiPreferenceUpdate(
+  pluginKey: string,
+  path: string[],
+  value: JsonValue,
+): Promise<void> {
+  writeChain = writeChain.then(() => writePreference(pluginKey, path, value)).catch(() => {});
+  return writeChain;
+}
+
+const WATCH_DEBOUNCE_MS = 150;
+
+export function watchTuiPreferences(onChange: () => void): () => void {
+  const file = getTuiPreferencesFile();
+  const name = basename(file);
+  let timer: ReturnType<typeof setTimeout> | null = null;
+  let lastSeen: string | null = null;
+  void readFile(file, "utf8")
+    .then((text) => {
+      if (lastSeen === null) lastSeen = text;
+    })
+    .catch(() => {});
+  try {
+    const watcher = watch(dirname(file), (_event, filename) => {
+      const isOurs =
+        filename === name || (filename?.startsWith(`${name}.`) && filename.endsWith(".tmp"));
+      if (filename != null && !isOurs) return;
+      if (timer) clearTimeout(timer);
+      timer = setTimeout(() => {
+        timer = null;
+        void readFile(file, "utf8")
+          .catch(() => null)
+          .then((text) => {
+            if (text === null) return;
+            if (text === lastSeen) return;
+            lastSeen = text;
+            onChange();
+          });
+      }, WATCH_DEBOUNCE_MS);
+    });
+    return () => {
+      if (timer) clearTimeout(timer);
+      watcher.close();
+    };
+  } catch {
+    return () => {};
+  }
+}
+
+export function persistCollapsedIfEnabled(prefs: AftTuiPrefs, collapsed: boolean): void {
+  if (prefs.rememberCollapsed) {
+    void queueTuiPreferenceUpdate(PLUGIN_KEY, ["collapsed"], collapsed);
+  }
+}

package/src/tui/sidebar.tsx

@@ -20,6 +20,18 @@ import {
   type StatusCompression,
 } from "../shared/status";
 import { resolveCortexKitStorageRoot } from "../shared/storage-paths";
+import {
+  type AftTuiPrefs,
+  computeEffectiveOrder,
+  DEFAULT_PREFS,
+  DEFAULT_SLOT_ORDER,
+  PLUGIN_KEY,
+  persistCollapsedIfEnabled,
+  readTuiPreferencesFile,
+  resolveAftPrefs,
+  seedCollapsedFromPrefs,
+  watchTuiPreferences,
+} from "./preferences";
 
 const SINGLE_BORDER = { type: "single" } as any;
 const REFRESH_DEBOUNCE_MS = 200;
@@ -182,6 +194,25 @@ export function collapsedCompressionValue(
 
 export type HealthLightTone = "ok" | "warn" | "err";
 
+// Degraded-mode reason → human-readable hint. Distinct strings per reason
+// because the UX direction is different: "home_root" tells the user to open a
+// real project subdirectory, "search_too_many_files" tells them the tree is too
+// big for full indexing, and "watcher_unavailable" is an honest soft
+// degradation (AFT continues without live external-change invalidation).
+export function degradedReasonLabel(reason: string): string {
+  if (reason === "home_root") {
+    return "project root is your home directory";
+  }
+  if (reason.startsWith("search_too_many_files:")) {
+    const threshold = reason.split(":")[1] ?? "20000";
+    return `project exceeds ${threshold} files`;
+  }
+  if (reason === "watcher_unavailable") {
+    return "file watcher unavailable; continuing without live external-change invalidation";
+  }
+  return reason; // unknown reason — surface verbatim so users can grep logs
+}
+
 export interface HealthLights {
   // Diagnostics: red if any errors, yellow if any warnings, else green.
   diagnostics: HealthLightTone;
@@ -307,9 +338,8 @@ const SidebarContent = (props: {
   pluginVersion: string;
 }) => {
   const [status, setStatus] = createSignal<ScopedSidebarStatus | null>(null);
-  // Collapsed/expanded toggle — local UI state (not persisted), mirroring
-  // OpenCode's native MCP sidebar section. Default expanded.
-  const [collapsed, setCollapsed] = createSignal(false);
+  const [prefs, setPrefs] = createSignal<AftTuiPrefs>(structuredClone(DEFAULT_PREFS));
+  const [collapsed, setCollapsed] = createSignal(seedCollapsedFromPrefs(DEFAULT_PREFS));
   let inflight: {
     controller: AbortController;
     generation: number;
@@ -428,7 +458,21 @@ const SidebarContent = (props: {
     }, REFRESH_DEBOUNCE_MS);
   };
 
+  const reloadPrefs = async () => {
+    const root = await readTuiPreferencesFile();
+    const next = resolveAftPrefs(root);
+    setPrefs(next);
+    setCollapsed(seedCollapsedFromPrefs(next));
+    requestRender();
+  };
+
+  void reloadPrefs();
+  const unwatchPrefs = watchTuiPreferences(() => {
+    void reloadPrefs();
+  });
+
   onCleanup(() => {
+    unwatchPrefs();
     generation++;
     abortInflight();
     if (debounceTimer) clearTimeout(debounceTimer);
@@ -518,20 +562,6 @@ const SidebarContent = (props: {
   const compressionRows = () => formatCompressionSidebarRows(s()?.compression);
   const statusBar = () => s()?.status_bar;
 
-  // Degraded-mode reason → human-readable hint. Distinct strings per reason
-  // because the UX direction is different: "home_root" tells the user to
-  // open a real project subdirectory, "search_too_many_files" tells them the
-  // tree is too big for full indexing.
-  const degradedReasonLabel = (reason: string): string => {
-    if (reason === "home_root") {
-      return "project root is your home directory";
-    }
-    if (reason.startsWith("search_too_many_files:")) {
-      const threshold = reason.split(":")[1] ?? "20000";
-      return `project exceeds ${threshold} files`;
-    }
-    return reason; // unknown reason — surface verbatim so users can grep logs
-  };
   const degradedSummary = () => {
     const snap = s();
     if (!snap?.degraded) return null;
@@ -560,7 +590,12 @@ const SidebarContent = (props: {
         justifyContent="space-between"
         alignItems="center"
         onMouseDown={() => {
-          if (!notInitialized()) setCollapsed((x) => !x);
+          if (notInitialized()) return;
+          setCollapsed((x) => {
+            const next = !x;
+            persistCollapsedIfEnabled(prefs(), next);
+            return next;
+          });
         }}
       >
         <box flexDirection="row" alignItems="center">
@@ -570,7 +605,7 @@ const SidebarContent = (props: {
             <text fg={props.theme.background}>
               <b>
                 {notInitialized() ? "" : collapsed() ? "▶ " : "▼ "}
-                AFT
+                {prefs().header.label}
               </b>
             </text>
           </box>
@@ -587,7 +622,7 @@ const SidebarContent = (props: {
             </box>
           )}
         </box>
-        {!notInitialized() && (
+        {!notInitialized() && prefs().header.showVersion && (
           <text fg={props.theme.textMuted}>v{s()?.version ?? props.pluginVersion}</text>
         )}
       </box>
@@ -622,13 +657,17 @@ const SidebarContent = (props: {
           order of the expanded grid. */}
       {!notInitialized() && collapsed() && (
         <box width="100%" flexDirection="column">
-          <CollapsedRow theme={props.theme} label="Search Index">
-            <text fg={toneColor(props.theme, searchStatus().tone)}>●</text>
-          </CollapsedRow>
-          <CollapsedRow theme={props.theme} label="Semantic Index">
-            <text fg={toneColor(props.theme, semanticStatus().tone)}>●</text>
-          </CollapsedRow>
-          {collapsedHealthLights(statusBar()) && (
+          {prefs().sections.searchIndex && (
+            <CollapsedRow theme={props.theme} label="Search Index">
+              <text fg={toneColor(props.theme, searchStatus().tone)}>●</text>
+            </CollapsedRow>
+          )}
+          {prefs().sections.semanticIndex && (
+            <CollapsedRow theme={props.theme} label="Semantic Index">
+              <text fg={toneColor(props.theme, semanticStatus().tone)}>●</text>
+            </CollapsedRow>
+          )}
+          {prefs().sections.codeHealth && collapsedHealthLights(statusBar()) && (
             <CollapsedRow theme={props.theme} label="Code Health">
               <box flexDirection="row" gap={1}>
                 <text fg={toneColor(props.theme, collapsedHealthLights(statusBar())!.diagnostics)}>
@@ -641,7 +680,7 @@ const SidebarContent = (props: {
               </box>
             </CollapsedRow>
           )}
-          {collapsedCompressionValue(s()?.compression) && (
+          {prefs().sections.compression && collapsedCompressionValue(s()?.compression) && (
             <CollapsedRow theme={props.theme} label="Compression">
               <text fg={props.theme.textMuted}>
                 <b>{collapsedCompressionValue(s()?.compression)}</b>
@@ -654,69 +693,76 @@ const SidebarContent = (props: {
       {/* Search index */}
       {!notInitialized() && !collapsed() && (
         <>
-          <SectionHeader theme={props.theme} title="Search Index" />
-          <StatRow
-            theme={props.theme}
-            label="Status"
-            value={searchStatus().label}
-            tone={searchStatus().tone}
-          />
-          {(s()?.search_index?.files ?? null) != null && (
-            <StatRow
-              theme={props.theme}
-              label="Files"
-              value={formatCount(s()!.search_index.files)}
-              tone="muted"
-            />
+          {prefs().sections.searchIndex && (
+            <>
+              <SectionHeader theme={props.theme} title="Search Index" />
+              <StatRow
+                theme={props.theme}
+                label="Status"
+                value={searchStatus().label}
+                tone={searchStatus().tone}
+              />
+              {(s()?.search_index?.files ?? null) != null && (
+                <StatRow
+                  theme={props.theme}
+                  label="Files"
+                  value={formatCount(s()!.search_index.files)}
+                  tone="muted"
+                />
+              )}
+              <StatRow
+                theme={props.theme}
+                label="Disk"
+                value={formatBytes(trigramBytes())}
+                tone="muted"
+              />
+            </>
           )}
-          <StatRow
-            theme={props.theme}
-            label="Disk"
-            value={formatBytes(trigramBytes())}
-            tone="muted"
-          />
 
-          {/* Semantic index */}
-          <SectionHeader theme={props.theme} title="Semantic Index" />
-          <StatRow
-            theme={props.theme}
-            label="Status"
-            value={semanticStatus().label}
-            tone={semanticStatus().tone}
-          />
-          {semanticRefreshing() && (
-            <box width="100%">
-              <text fg={props.theme.textMuted}>{semanticRefreshing()}</text>
-            </box>
-          )}
-          {/* When loading, magic-context-style progress hint helps users see
+          {prefs().sections.semanticIndex && (
+            <>
+              <SectionHeader theme={props.theme} title="Semantic Index" />
+              <StatRow
+                theme={props.theme}
+                label="Status"
+                value={semanticStatus().label}
+                tone={semanticStatus().tone}
+              />
+              {semanticRefreshing() && (
+                <box width="100%">
+                  <text fg={props.theme.textMuted}>{semanticRefreshing()}</text>
+                </box>
+              )}
+              {/* When loading, magic-context-style progress hint helps users see
           background work is making progress instead of stuck. */}
-          {s()?.semantic_index?.status === "loading" &&
-            s()?.semantic_index?.entries_total != null &&
-            s()!.semantic_index.entries_total! > 0 && (
+              {s()?.semantic_index?.status === "loading" &&
+                s()?.semantic_index?.entries_total != null &&
+                s()!.semantic_index.entries_total! > 0 && (
+                  <StatRow
+                    theme={props.theme}
+                    label="Progress"
+                    value={`${formatCount(s()!.semantic_index.entries_done)} / ${formatCount(
+                      s()!.semantic_index.entries_total,
+                    )}`}
+                    tone="warn"
+                  />
+                )}
+              {(s()?.semantic_index?.entries ?? null) != null && (
+                <StatRow
+                  theme={props.theme}
+                  label="Entries"
+                  value={formatCount(s()!.semantic_index.entries)}
+                  tone="muted"
+                />
+              )}
               <StatRow
                 theme={props.theme}
-                label="Progress"
-                value={`${formatCount(s()!.semantic_index.entries_done)} / ${formatCount(
-                  s()!.semantic_index.entries_total,
-                )}`}
-                tone="warn"
+                label="Disk"
+                value={formatBytes(semanticBytes())}
+                tone="muted"
               />
-            )}
-          {(s()?.semantic_index?.entries ?? null) != null && (
-            <StatRow
-              theme={props.theme}
-              label="Entries"
-              value={formatCount(s()!.semantic_index.entries)}
-              tone="muted"
-            />
+            </>
           )}
-          <StatRow
-            theme={props.theme}
-            label="Disk"
-            value={formatBytes(semanticBytes())}
-            tone="muted"
-          />
 
           {/* Code Health — the agent status-bar glance, surfaced for users.
           Hidden until the Tier-2 cache is populated (status_bar undefined),
@@ -724,7 +770,7 @@ const SidebarContent = (props: {
           diagnostics; D/U/C/T come from the last background scan. A `~` on
           the section header flags the Tier-2 counts as predating the latest
           edit. */}
-          {statusBar() && (
+          {prefs().sections.codeHealth && statusBar() && (
             <>
               <SectionHeader
                 theme={props.theme}
@@ -774,7 +820,7 @@ const SidebarContent = (props: {
           subheader followed by two StatRows (Tokens Saved, Compression
           Ratio). Keeps numbers right-aligned in the value column instead
           of jamming them after the label on the same line. */}
-          {compressionRows().length > 0 && (
+          {prefs().sections.compression && compressionRows().length > 0 && (
             <>
               <SectionHeader theme={props.theme} title="Compression" />
               {compressionRows().map((row) =>
@@ -802,12 +848,17 @@ const SidebarContent = (props: {
   );
 };
 
-export function createAftSidebarSlot(api: TuiPluginApi, pluginVersion: string): TuiSlotPlugin {
+export async function createAftSidebarSlot(
+  api: TuiPluginApi,
+  pluginVersion: string,
+): Promise<TuiSlotPlugin> {
+  const root = await readTuiPreferencesFile();
+  const order = computeEffectiveOrder(root, PLUGIN_KEY, DEFAULT_SLOT_ORDER);
   return {
-    // 150 matches magic-context's order — chosen so AFT renders below
-    // higher-priority panels but above default plugin slots. If both
-    // plugins are loaded together, magic-context will appear first.
-    order: 160,
+    // DEFAULT_SLOT_ORDER (180) is AFT's coordinated default in the shared
+    // tui-preferences ladder (anthropic-auth 160, AFT 180, magic-context 200).
+    // Override via `order` or `forceToTop` in tui-preferences.jsonc.
+    order,
     slots: {
       sidebar_content: (ctx, value) => {
         const theme = createMemo(() => (ctx as any).theme.current);