@albinocrabs/o-switcher 0.1.0 → 0.2.0

package/src/tui.tsx

@@ -0,0 +1,214 @@
+/**
+ * O-Switcher TUI plugin for OpenCode.
+ *
+ * Provides:
+ *  - sidebar_footer: compact one-line status (active profile, health %, target count)
+ *  - /o-switcher-status route: full dashboard with all targets and their states
+ *  - /switcher slash command: navigates to the dashboard
+ *
+ * State is read from a file bridge written by the server plugin (state-bridge.ts).
+ * TUI plugins are loaded by Bun with babel-preset-solid transform — this file
+ * ships as source .tsx and is compiled at load time.
+ *
+ * NOTE: This file is excluded from tsconfig typecheck and tsup bundling.
+ * It runs in Bun's Solid.js context, not Node.js.
+ */
+
+import { createSignal, onCleanup } from 'solid-js';
+import type {
+  TuiPluginModule,
+  TuiPluginApi,
+  TuiSlotContext,
+} from '@opencode-ai/plugin/tui';
+import { readTuiState } from './state-bridge.js';
+import type { TuiStateFile, TuiTargetSummary } from './state-bridge.js';
+
+// ── Constants ─────────────────────────────────────────────────────
+
+const POLL_INTERVAL_MS = 2000;
+
+// ── Helpers ───────────────────────────────────────────────────────
+
+/** Format health score as percentage string. */
+const healthPct = (score: number): string => `${Math.round(score * 100)}%`;
+
+/** State icon by target state. */
+const stateIcon = (state: TuiTargetSummary['state']): string => {
+  const icons: Record<TuiTargetSummary['state'], string> = {
+    Active: '●',
+    CoolingDown: '◐',
+    ReauthRequired: '⚠',
+    PolicyBlocked: '✕',
+    CircuitOpen: '○',
+    CircuitHalfOpen: '◑',
+    Draining: '▽',
+    Disabled: '—',
+  };
+  return icons[state];
+};
+
+/** Display name: prefer profile, fall back to target_id. */
+const displayName = (t: TuiTargetSummary): string =>
+  t.profile ?? t.target_id;
+
+// ── State polling hook ────────────────────────────────────────────
+
+const useTuiState = () => {
+  const [state, setState] = createSignal<TuiStateFile | undefined>();
+
+  const timer = setInterval(async () => {
+    const s = await readTuiState();
+    setState(s);
+  }, POLL_INTERVAL_MS);
+
+  // Immediate first read
+  readTuiState().then((s) => setState(s));
+
+  onCleanup(() => clearInterval(timer));
+
+  return state;
+};
+
+// ── Components ────────────────────────────────────────────────────
+
+/** Sidebar footer: compact one-line status indicator. */
+const SidebarFooter = () => {
+  const state = useTuiState();
+
+  const label = (): string => {
+    const s = state();
+    if (!s || s.targets.length === 0) return '◌ o-switcher: no targets';
+
+    const activeTargets = s.targets.filter(
+      (t) => t.enabled && t.state === 'Active',
+    );
+    const totalEnabled = s.targets.filter((t) => t.enabled).length;
+
+    // Show the current active target name + health
+    const current = s.active_target_id
+      ? s.targets.find((t) => t.target_id === s.active_target_id)
+      : activeTargets[0];
+
+    if (!current) {
+      return `○ o-switcher: 0/${totalEnabled} active`;
+    }
+
+    const name = displayName(current);
+    const health = healthPct(current.health_score);
+    return `◉ ${name} (${health}) | ${activeTargets.length}/${totalEnabled} active`;
+  };
+
+  return <text truncate={true}>{label()}</text>;
+};
+
+/** Full status dashboard route. */
+const StatusDashboard = () => {
+  const state = useTuiState();
+
+  const content = (): string => {
+    const s = state();
+    if (!s) return '  Loading O-Switcher state...';
+    if (s.targets.length === 0) return '  No targets configured.';
+
+    const lines: string[] = [
+      '  O-Switcher Status',
+      '  ' + '─'.repeat(50),
+      '',
+    ];
+
+    // Header row
+    lines.push(
+      '  ' +
+        'Target'.padEnd(24) +
+        'State'.padEnd(14) +
+        'Health'.padEnd(10) +
+        'Latency',
+    );
+    lines.push('  ' + '─'.repeat(50));
+
+    for (const t of s.targets) {
+      const icon = stateIcon(t.state);
+      const name = displayName(t).slice(0, 22);
+      const stateStr = `${icon} ${t.state}`;
+      const health = healthPct(t.health_score);
+      const latency = t.latency_ema_ms > 0 ? `${Math.round(t.latency_ema_ms)}ms` : '—';
+      const activeMarker = t.target_id === s.active_target_id ? ' ◀' : '';
+      const disabledMark = t.enabled ? '' : ' (off)';
+
+      lines.push(
+        '  ' +
+          (name + disabledMark).padEnd(24) +
+          stateStr.padEnd(14) +
+          health.padEnd(10) +
+          latency +
+          activeMarker,
+      );
+    }
+
+    // Summary
+    const activeCount = s.targets.filter(
+      (t) => t.enabled && t.state === 'Active',
+    ).length;
+    const totalEnabled = s.targets.filter((t) => t.enabled).length;
+    const avgHealth =
+      totalEnabled > 0
+        ? s.targets
+            .filter((t) => t.enabled)
+            .reduce((sum, t) => sum + t.health_score, 0) / totalEnabled
+        : 0;
+
+    lines.push('');
+    lines.push('  ' + '─'.repeat(50));
+    lines.push(
+      `  ${activeCount}/${totalEnabled} targets active  |  avg health: ${healthPct(avgHealth)}`,
+    );
+
+    const age = Date.now() - s.updated_at;
+    const ageSec = Math.round(age / 1000);
+    lines.push(`  Updated ${ageSec}s ago`);
+
+    return lines.join('\n');
+  };
+
+  return <text wrapMode="none">{content()}</text>;
+};
+
+// ── Plugin entry point ────────────────────────────────────────────
+
+const tui = async (api: TuiPluginApi) => {
+  // Register sidebar footer slot
+  api.slots.register({
+    slots: {
+      sidebar_footer: (_ctx: TuiSlotContext, _props: { session_id: string }) => (
+        <SidebarFooter />
+      ),
+    },
+  });
+
+  // Register status dashboard route
+  api.route.register([
+    {
+      name: 'o-switcher-status',
+      render: () => <StatusDashboard />,
+    },
+  ]);
+
+  // Register /switcher slash command
+  api.command.register(() => [
+    {
+      title: 'O-Switcher Status',
+      value: 'o-switcher-status',
+      description: 'Show target health and routing status',
+      slash: {
+        name: 'switcher',
+        aliases: ['osw'],
+      },
+      onSelect: () => {
+        api.route.navigate('o-switcher-status');
+      },
+    },
+  ]);
+};
+
+const tuiModule: TuiPluginModule = { tui };
+export default tuiModule;

package/CONTRIBUTING.md

@@ -1,72 +0,0 @@
-# Contributing to O-Switcher
-
-Thank you for your interest in contributing!
-
-## Getting Started
-
-```bash
-git clone https://github.com/<owner>/o-switcher.git
-cd o-switcher
-npm install
-npm test        # 351 tests, all must pass
-npm run typecheck  # zero TypeScript errors
-```
-
-## Development Workflow
-
-1. **Fork** the repository
-2. **Create a branch** from `main`: `git checkout -b feat/my-feature`
-3. **Write tests first** (TDD) — tests live next to source files (`*.test.ts`)
-4. **Implement** — make the tests pass
-5. **Verify** — `npm test && npm run typecheck`
-6. **Commit** — use [conventional commits](https://www.conventionalcommits.org/):
-   `feat(routing):`, `fix(config):`, `test(execution):`, `docs:`
-7. **Open a PR** against `main`
-
-## Project Structure
-
-```
-src/
-├── config/       Config loading, Zod schema validation
-├── registry/     Target registry, health scoring, mode detection
-├── errors/       Error taxonomy (10 classes), dual-mode classifier
-├── retry/        Bounded retry with backoff, jitter, Retry-After
-├── routing/      Policy engine, circuit breaker, admission, failover
-├── execution/    Mode adapters, stream stitcher, audit collector
-├── operator/     Operator commands, config reload, plugin tools
-├── integration/  End-to-end integration tests
-├── audit/        Pino-based structured audit logger
-├── mode/         Deployment mode types and capabilities
-└── spike/        Proof-of-concept explorations
-```
-
-## Code Conventions
-
-- **TypeScript strict mode** — `noUncheckedIndexedAccess`, `verbatimModuleSyntax`
-- **ESM** — `"type": "module"` in package.json
-- **Factory functions** — `createXxx()` returning interfaces (not classes)
-- **Pure functions** — routing/scoring logic has no I/O
-- **No `let`** — use `const` only, restructure if needed
-- **No `!!`** — use `Boolean()` for explicit coercion
-- **Vitest** for testing — co-located `*.test.ts` files
-
-## Testing
-
-```bash
-npm test                           # all tests
-npx vitest run src/routing/        # specific module
-npx vitest run --watch             # watch mode
-```
-
-## Architecture
-
-See [README.md](README.md) for the architecture diagram and module overview.
-
-## Reporting Issues
-
-- Use GitHub Issues
-- Include: steps to reproduce, expected vs actual behavior, Node.js version
-
-## License
-
-By contributing, you agree that your contributions will be licensed under the MIT License.