amicus 1.3.0 → 1.5.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "amicus",
-  "version": "1.3.0",
+  "version": "1.5.0",
   "description": "Multi-model LLM Council + parallel AI window for Claude Code. Run structured council reviews across Gemini, GPT, DeepSeek and more — or fork a conversation to any model and fold the results back.",
   "author": { "name": "Christian Wagner" },
   "homepage": "https://bourbondog.github.io/amicus/",

package/CHANGELOG.md

@@ -5,6 +5,42 @@ All notable changes to Amicus are documented here. Format follows
 
 ## [Unreleased]
 
+## [1.5.0] - 2026-06-29
+
+A visual refresh plus a council-reliability fix and a config-dir consolidation.
+
+### Added
+- **Amicus design system**: the Electron app (setup wizard, toolbar, fold overlay), the council
+  HTML report, and the marketing site now render from one shared token layer (`src/design/tokens.css`
+  + a `src/design/tokens.js` loader) — the clay/gold rail-yard brand on a neutral-black ramp, with
+  bundled Outfit + IBM Plex Mono fonts. Previously each surface defined its own colors independently;
+  the site is pixel-identical to before, now bound to the shared tokens by a drift-guard test.
+
+### Fixed
+- **Council reliability ledger now persists.** `amicus council tally` (and the MCP
+  `amicus_council_tally`) computed the tally record but never wrote it, so `council-ledger.jsonl`
+  stayed empty and `amicus council stats` always reported "No council runs recorded yet." The tally
+  finalize step now auto-appends the row(s) — best-effort, so a ledger write failure never fails the
+  tally — and a new `--no-ledger` flag computes a record without recording it (e.g. a re-tally).
+
+### Changed
+- **Unified config directory.** On startup Amicus now migrates a legacy `~/.config/sidecar` directory
+  onto the canonical `~/.config/amicus` once, non-destructively (copy; the legacy dir is kept as a
+  backup). This collapses the two-directory split that could let config resolution flip between them
+  and orphan your config, catalog, and ledger. A `CONFIG_DIR` override opts out.
+
+## [1.4.0] - 2026-06-28
+
+### Added
+- **Free OpenRouter council**: a new `amicus setup` option (readline wizard + Electron Models step)
+  that stands up a zero-cost council of free `:free` OpenRouter models, saved as a first-class
+  `councils` config primitive. Run it with `amicus fanout --council free` or the `amicus_fanout` MCP
+  `council` param; the second-opinion skill reads `councils.free`. Free-model picks are detected
+  live from the catalog (the `:free` suffix is authoritative), seeded under collision-safe `free-*`
+  aliases, and a delisted member degrades gracefully (dropped with a warning) instead of failing the
+  wave. Needs only an `OPENROUTER_API_KEY`; the wizard discloses the free-tier caveats (rate limits,
+  variable quality, the OpenRouter data-sharing prerequisite). `config.default` is left untouched.
+
 ## [1.3.0] - 2026-06-24
 
 Making the mature council/fan-out engine legible: live per-leg progress, cost

package/README.md

@@ -152,6 +152,16 @@ Then the council waits for your confirmation.
 
 The skill lives at **[`skills/second-opinion/SKILL.md`](./skills/second-opinion/SKILL.md)**; the design spec behind it is **[`skills/second-opinion/COUNCIL-DESIGN.md`](./skills/second-opinion/COUNCIL-DESIGN.md)**.
 
+**Free council (zero-cost).** Want the cross-examination without the model spend? `amicus setup` offers a **Free OpenRouter council** mode — readline wizard option 2, and the Electron **Models** step. It detects the free `:free` models live from the catalog, lets you multi-pick (Enter takes a vendor-diverse default), and saves them as `councils.free` — a first-class `councils` config primitive seeded under collision-safe `free-*` aliases. Your `config.default` is left untouched, and all you need is an `OPENROUTER_API_KEY`.
+
+Run it anywhere a council runs:
+
+```bash
+amicus fanout --council free --prompt "Review this design"
+```
+
+The `amicus_fanout` MCP tool takes the same `council` parameter, and the `second-opinion` skill reads `councils.free` automatically. A member that gets delisted is dropped with a warning — the council still runs as long as ≥2 survive. Free models are **rate-limited and quality-variable**, and some return 404 unless you enable data-sharing at [openrouter.ai/settings/privacy](https://openrouter.ai/settings/privacy).
+
 ---
 
 ## The parallel window
@@ -246,7 +256,8 @@ amicus fanout --models gemini,deepseek,gpt --prompt "Review this design" --json
 
 Fanout runs one **headless wave**: every leg gets the **same** prompt (this is the shared-prompt model the council's review stages are built on). When all legs are terminal it prints **one** JSON wave document on stdout.
 
-- `--models <a,b,c>` — comma-separated aliases or `provider/model` IDs (required).
+- `--models <a,b,c>` — comma-separated aliases or `provider/model` IDs (required, unless `--council`).
+- `--council <name>` — run a saved council (e.g. `free`) instead of `--models`; mutually exclusive with `--models`.
 - `--prompt <text>` / `--prompt-file <path>` — the shared briefing. `--prompt-file` avoids the ~32 KB Windows argument cap and is mutually exclusive with `--prompt`.
 - `--wave-id <id>` — set the wave ID explicitly (leg IDs become `<id>-1..N`).
 - `--json` — emit the wave document.

package/bin/amicus.js

@@ -7,6 +7,17 @@
  * Routes commands to appropriate handlers.
  */
 
+// One-time, non-destructive migration of the legacy ~/.config/sidecar dir onto
+// the canonical ~/.config/amicus (copy; legacy kept as a backup). Runs before
+// any config/credential read so both resolve to the unified dir. Best-effort.
+try {
+  const { migrateLegacyConfigDir } = require('../src/utils/config');
+  const _m = migrateLegacyConfigDir();
+  if (_m && _m.migrated) {
+    process.stderr.write(`[amicus] Migrated config ${_m.from} → ${_m.to} (legacy kept as a backup).\n`);
+  }
+} catch { /* best-effort: never block startup on migration */ }
+
 // Load API keys from all sources: process.env > sidecar .env > auth.json
 const { loadCredentials } = require('../src/utils/env-loader');
 loadCredentials();

package/electron/fold.js

@@ -8,6 +8,7 @@
 const { logger } = require('../src/utils/logger');
 const { requestSummaryFromModel } = require('./summary');
 const { getSummaryTemplate } = require('../src/prompt-builder');
+const { tokenCss } = require('../src/design/tokens');
 
 /**
  * Create a fold handler bound to the window state
@@ -59,11 +60,11 @@ function createFoldHandler(state) {
       if (contentView) {
         await contentView.webContents.executeJavaScript(`
           (function() {
-            var overlay = document.getElementById('sidecar-fold-overlay');
+            var overlay = document.getElementById('amicus-fold-overlay');
             if (overlay) {
               while (overlay.firstChild) { overlay.removeChild(overlay.firstChild); }
               var msg = document.createElement('div');
-              msg.style.cssText = 'color:#E8E0D8;font-family:-apple-system,BlinkMacSystemFont,sans-serif;font-size:15px;font-weight:500;text-align:center;max-width:320px;';
+              msg.style.cssText = 'color:var(--text-1);font-family:var(--font-sans),-apple-system,BlinkMacSystemFont,sans-serif;font-size:15px;font-weight:500;text-align:center;max-width:320px;';
               msg.textContent = 'Summary saved. Tell Claude you\\u2019re done with the Amicus session so it can read the results.';
               overlay.appendChild(msg);
             }
@@ -110,7 +111,7 @@ function showFoldOverlay(mainWindow, contentView) {
           var span = document.createElement('span');
           span.style.cssText = 'display:inline-flex;align-items:center;gap:6px;';
           var spinner = document.createElement('span');
-          spinner.style.cssText = 'width:12px;height:12px;border:2px solid rgba(255,255,255,0.3);border-top-color:#fff;border-radius:50%;animation:spin 0.8s linear infinite;display:inline-block;';
+          spinner.style.cssText = 'width:12px;height:12px;border:2px solid rgba(255,255,255,0.3);border-top-color:var(--on-accent);border-radius:50%;animation:spin 0.8s linear infinite;display:inline-block;';
           span.appendChild(spinner);
           span.appendChild(document.createTextNode('Generating summary\\u2026'));
           btn.appendChild(span);
@@ -128,6 +129,15 @@ function showFoldOverlay(mainWindow, contentView) {
     `).catch(() => {});
   }
   if (contentView) {
+    // Scope token vars to the overlay container so var(--x) resolves without
+    // touching OpenCode's own :root (which would clobber its CSS variables).
+    const rawCss = tokenCss({ absoluteFontUrls: true });
+    // Replace only the :root selector (not occurrences inside comments) so the
+    // custom properties are defined on #amicus-fold-overlay and inherited by
+    // its descendants. @font-face blocks are left at global scope (no selector).
+    const scopedCss = rawCss.replace(/:root\s*\{/, '#amicus-fold-overlay {');
+    contentView.webContents.insertCSS(scopedCss).catch(() => {});
+
     contentView.webContents.executeJavaScript(`
       (function() {
         if (!document.getElementById('fold-spin-style')) {
@@ -137,20 +147,20 @@ function showFoldOverlay(mainWindow, contentView) {
           document.head.appendChild(style);
         }
         var overlay = document.createElement('div');
-        overlay.id = 'sidecar-fold-overlay';
+        overlay.id = 'amicus-fold-overlay';
         overlay.style.cssText = 'position:fixed;inset:0;background:rgba(0,0,0,0.55);display:flex;flex-direction:column;align-items:center;justify-content:center;z-index:99999;';
 
         var spinDiv = document.createElement('div');
-        spinDiv.style.cssText = 'width:32px;height:32px;border:3px solid rgba(217,119,87,0.3);border-top-color:#D97757;border-radius:50%;animation:spin 0.8s linear infinite;margin-bottom:16px;';
+        spinDiv.style.cssText = 'width:32px;height:32px;border:3px solid var(--accent-line);border-top-color:var(--accent);border-radius:50%;animation:spin 0.8s linear infinite;margin-bottom:16px;';
         overlay.appendChild(spinDiv);
 
         var titleDiv = document.createElement('div');
-        titleDiv.style.cssText = 'color:#E8E0D8;font-family:-apple-system,BlinkMacSystemFont,sans-serif;font-size:15px;font-weight:500;';
+        titleDiv.style.cssText = 'color:var(--text-1);font-family:var(--font-sans),-apple-system,BlinkMacSystemFont,sans-serif;font-size:15px;font-weight:500;';
         titleDiv.textContent = 'Generating summary\\u2026';
         overlay.appendChild(titleDiv);
 
         var subtitleDiv = document.createElement('div');
-        subtitleDiv.style.cssText = 'color:#7A756F;font-family:-apple-system,BlinkMacSystemFont,sans-serif;font-size:12px;margin-top:6px;';
+        subtitleDiv.style.cssText = 'color:var(--text-3);font-family:var(--font-sans),-apple-system,BlinkMacSystemFont,sans-serif;font-size:12px;margin-top:6px;';
         subtitleDiv.textContent = 'Folding session back to Claude Code';
         overlay.appendChild(subtitleDiv);
 

package/electron/ipc-setup.js

@@ -97,7 +97,8 @@ function registerSetupHandlers(getMainWindow) {
 
   // Read-modify-write: never rewrite an alias the renderer didn't send.
   // aliasWrites values: string = set, null = delete. First run seeds live.
-  ipcMain.handle('sidecar:save-config', async (_event, defaultModel, aliasWrites) => {
+  // councilPicks (optional): when length >= 2, seeds the free council via seedFreeCouncil.
+  ipcMain.handle('sidecar:save-config', async (_event, defaultModel, aliasWrites, councilPicks) => {
     try {
       const { loadConfig, saveConfig } = require('../src/utils/config');
       let cfg = loadConfig();
@@ -119,6 +120,9 @@ function registerSetupHandlers(getMainWindow) {
         }
       }
       saveConfig(cfg);
+      if (Array.isArray(councilPicks) && councilPicks.length >= 2) {
+        require('../src/sidecar/setup').seedFreeCouncil(councilPicks);
+      }
       return { success: true };
     } catch (err) {
       logger.error('save-config handler error', { error: err.message });
@@ -192,6 +196,19 @@ function registerSetupHandlers(getMainWindow) {
       return { models: [], fetchedAt: null };
     }
   });
+
+  // Free OpenRouter council: returns all free models from the catalog,
+  // marking those in the vendor-diverse suggested set with suggested:true.
+  ipcMain.handle('sidecar:fetch-free-models', async () => {
+    try {
+      const { getCatalog } = require('../src/utils/model-catalog');
+      const { listFreeModels, suggestFreeCouncil } = require('../src/utils/free-models');
+      const catalog = await getCatalog();
+      const free = listFreeModels(catalog);
+      const suggested = new Set(suggestFreeCouncil(free, 3).map(r => r.id));
+      return free.map(r => ({ id: r.id, suggested: suggested.has(r.id) }));
+    } catch (_err) { return []; }
+  });
 }
 
 module.exports = { registerSetupHandlers };

package/electron/preload-setup.js

@@ -22,7 +22,8 @@ contextBridge.exposeInMainWorld('sidecarSetup', {
       'sidecar:get-api-keys',
       'sidecar:fetch-models',
       'sidecar:get-catalog',
-      'sidecar:refresh-catalog'
+      'sidecar:refresh-catalog',
+      'sidecar:fetch-free-models'
     ];
     if (!allowedChannels.includes(channel)) {
       throw new Error(`IPC channel not allowed: ${channel}`);

package/electron/setup-ui-aliases.js

@@ -51,9 +51,9 @@ function buildAliasEditorHTML(aliases) {
   const exampleModel = aliases[exampleAlias] || 'openrouter/google/gemini-3.1-flash-lite-preview';
 
   // SVG icons for the example box
-  const terminalIcon = `<svg width="16" height="16" viewBox="0 0 16 16" fill="none"><rect x="1" y="2" width="14" height="12" rx="2" stroke="#D97757" stroke-width="1.5"/><path d="M4 6l2.5 2L4 10" stroke="#D97757" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/><path d="M8.5 10H11" stroke="#5A5550" stroke-width="1.5" stroke-linecap="round"/></svg>`;
-  const arrowIcon = `<svg width="20" height="12" viewBox="0 0 20 12" fill="none"><path d="M2 6h14" stroke="#D97757" stroke-width="1.5" stroke-linecap="round"/><path d="M13 2l4 4-4 4" stroke="#D97757" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/></svg>`;
-  const modelIcon = `<svg width="16" height="16" viewBox="0 0 16 16" fill="none"><circle cx="8" cy="5" r="3" stroke="#6BBF6B" stroke-width="1.5"/><path d="M8 8v3" stroke="#6BBF6B" stroke-width="1.5" stroke-linecap="round"/><circle cx="4" cy="13" r="1.5" stroke="#6BBF6B" stroke-width="1.2"/><circle cx="8" cy="13" r="1.5" stroke="#6BBF6B" stroke-width="1.2"/><circle cx="12" cy="13" r="1.5" stroke="#6BBF6B" stroke-width="1.2"/><path d="M4 11.5L8 11M8 11l4 .5" stroke="#6BBF6B" stroke-width="1" stroke-linecap="round"/></svg>`;
+  const terminalIcon = `<svg class="alias-icon-accent" width="16" height="16" viewBox="0 0 16 16" fill="none"><rect x="1" y="2" width="14" height="12" rx="2" stroke-width="1.5"/><path d="M4 6l2.5 2L4 10" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/><path d="M8.5 10H11" class="alias-icon-faint-path" stroke-width="1.5" stroke-linecap="round"/></svg>`;
+  const arrowIcon = `<svg class="alias-icon-accent" width="20" height="12" viewBox="0 0 20 12" fill="none"><path d="M2 6h14" stroke-width="1.5" stroke-linecap="round"/><path d="M13 2l4 4-4 4" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/></svg>`;
+  const modelIcon = `<svg class="alias-icon-ok" width="16" height="16" viewBox="0 0 16 16" fill="none"><circle cx="8" cy="5" r="3" stroke-width="1.5"/><path d="M8 8v3" stroke-width="1.5" stroke-linecap="round"/><circle cx="4" cy="13" r="1.5" stroke-width="1.2"/><circle cx="8" cy="13" r="1.5" stroke-width="1.2"/><circle cx="12" cy="13" r="1.5" stroke-width="1.2"/><path d="M4 11.5L8 11M8 11l4 .5" stroke-width="1" stroke-linecap="round"/></svg>`;
 
   const exampleBox = `<div class="routing-example">
         <div class="example-label">How it works</div>

package/electron/setup-ui-council.js

@@ -0,0 +1,77 @@
+/**
+ * Setup UI — Free OpenRouter council picker (mounted on the Models step).
+ * Collapsible section: a checkbox list of free models fetched via IPC. Gated
+ * on the OpenRouter key (recomputed on Step-2 entry by the orchestrator).
+ * window.collectCouncilPicks() returns the checked ids for the save payload.
+ */
+'use strict';
+
+function buildCouncilSectionHTML() {
+  return `<div id="free-council-section" class="council-section">
+      <label class="council-toggle"><input type="checkbox" id="free-council-toggle">
+        <span>Set up a free OpenRouter council (zero-cost)</span></label>
+      <div id="free-council-body" style="display:none">
+        <div id="free-council-meta" class="search-meta"></div>
+        <div id="free-council-results" class="council-results"></div>
+        <div class="council-note">Free tier: rate-limited &amp; quality-variable; some models need
+          data-sharing enabled at openrouter.ai/settings/privacy.</div>
+      </div>
+    </div>`;
+}
+
+function buildCouncilScript() {
+  return `
+  (function() {
+    var toggle = document.getElementById('free-council-toggle');
+    var body = document.getElementById('free-council-body');
+    var results = document.getElementById('free-council-results');
+    var meta = document.getElementById('free-council-meta');
+    var loaded = false;
+
+    function hasOpenRouterKey() { return !!(window.configuredKeys && window.configuredKeys.openrouter); }
+
+    window.refreshCouncilGating = function() {
+      if (!toggle) { return; }
+      var ok = hasOpenRouterKey();
+      toggle.disabled = !ok;
+      if (meta && !ok) { meta.textContent = 'Add an OpenRouter API key (step 1) to enable a free council.'; }
+      else if (meta && !loaded) { meta.textContent = ''; }
+    };
+
+    async function loadFree() {
+      if (loaded) { return; }
+      try {
+        var rows = await window.sidecarSetup.invoke('sidecar:fetch-free-models');
+        loaded = true;
+        results.innerHTML = '';
+        (rows || []).forEach(function(r, i) {
+          var id = 'fc-' + i;
+          var row = document.createElement('label');
+          row.className = 'council-row';
+          var cb = document.createElement('input');
+          cb.type = 'checkbox'; cb.value = r.id; cb.id = id; cb.checked = !!r.suggested;
+          var span = document.createElement('span'); span.textContent = r.id;
+          row.appendChild(cb); row.appendChild(span);
+          results.appendChild(row);
+        });
+        if (meta) { meta.textContent = (rows || []).length + ' free models'; }
+      } catch (_e) { if (meta) { meta.textContent = 'Could not load free models.'; } }
+    }
+
+    if (toggle) {
+      toggle.addEventListener('change', function() {
+        body.style.display = toggle.checked ? '' : 'none';
+        if (toggle.checked) { loadFree(); }
+      });
+    }
+
+    window.collectCouncilPicks = function() {
+      if (!toggle || !toggle.checked) { return []; }
+      return Array.prototype.slice.call(results.querySelectorAll('input[type=checkbox]:checked'))
+        .map(function(cb) { return cb.value; });
+    };
+  })();
+  `;
+}
+
+module.exports = { buildCouncilSectionHTML, buildCouncilScript };