@kinqs/brainrouter-cli 0.3.6 → 0.3.8

package/dist/runtime/vendorSnippets.js

@@ -0,0 +1,153 @@
+/**
+ * Per-vendor MCP install snippets (0.3.8-I5 / roadmap §9).
+ *
+ * Pattern adapted from semble's per-agent install docs
+ * (openSrc/semble/src/semble/agents/*.md) — one focused entry per vendor
+ * with the exact JSON shape and config file path. Where semble ships
+ * markdown, we ship structured templates so the CLI can substitute the
+ * user's live profile URL + API key on the fly.
+ *
+ * Notes
+ * - Tool name examples use the single-underscore convention
+ *   `mcp_<server>_<tool>` (0.3.8-R5 decision).
+ * - Each template is pinned to a "verified against vendor docs as of …"
+ *   comment. Vendor MCP schemas drift; bump the date when you re-verify.
+ * - We never auto-write the vendor config file. Print only — direct-write
+ *   is a future enhancement (roadmap: future item; do not file a follow-up).
+ */
+import os from 'node:os';
+import path from 'node:path';
+// Helpers ------------------------------------------------------------------
+function home(platform) {
+    // Tests can override HOME / APPDATA; in production this is os.homedir().
+    if (platform === 'win32')
+        return process.env.APPDATA ?? path.join(os.homedir(), 'AppData', 'Roaming');
+    return os.homedir();
+}
+/** Render a config path for human display — backslashes on Windows. */
+export function displayPath(p, platform = process.platform) {
+    return platform === 'win32' ? p.replace(/\//g, '\\') : p;
+}
+// Vendor definitions -------------------------------------------------------
+export const VENDORS = {
+    'claude-desktop': {
+        id: 'claude-desktop',
+        label: 'Claude Desktop',
+        schema: 'http',
+        restart: 'Quit and reopen Claude Desktop fully — it only re-reads this file on cold start.',
+        // Verified against Anthropic docs as of 2026-05.
+        configPath: (p) => p === 'win32'
+            ? path.join(home(p), 'Claude', 'claude_desktop_config.json')
+            : p === 'darwin'
+                ? path.join(home(p), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json')
+                : path.join(home(p), '.config', 'Claude', 'claude_desktop_config.json'),
+        template: ({ url, apiKey, serverId = 'brainrouter' }) => ({
+            mcpServers: {
+                [serverId]: {
+                    url,
+                    headers: { Authorization: `Bearer ${apiKey}` },
+                },
+            },
+        }),
+    },
+    cursor: {
+        id: 'cursor',
+        label: 'Cursor',
+        schema: 'http',
+        restart: 'Cursor reloads MCP servers automatically; reopen the MCP panel if the server does not appear.',
+        // Verified against Cursor docs as of 2026-05 (~/.cursor/mcp.json).
+        configPath: (p) => path.join(home(p), '.cursor', 'mcp.json'),
+        template: ({ url, apiKey, serverId = 'brainrouter' }) => ({
+            mcpServers: {
+                [serverId]: {
+                    url,
+                    headers: { Authorization: `Bearer ${apiKey}` },
+                },
+            },
+        }),
+    },
+    windsurf: {
+        id: 'windsurf',
+        label: 'Windsurf (Codeium)',
+        schema: 'http',
+        restart: 'Open the Windsurf MCP panel and click "Refresh" — no full restart needed.',
+        // Verified against Codeium docs as of 2026-05 (~/.codeium/windsurf/mcp_config.json).
+        configPath: (p) => path.join(home(p), '.codeium', 'windsurf', 'mcp_config.json'),
+        template: ({ url, apiKey, serverId = 'brainrouter' }) => ({
+            mcpServers: {
+                [serverId]: {
+                    serverUrl: url,
+                    headers: { Authorization: `Bearer ${apiKey}` },
+                },
+            },
+        }),
+    },
+    'vscode-continue': {
+        id: 'vscode-continue',
+        label: 'VS Code (Continue extension)',
+        schema: 'http',
+        restart: 'Continue picks up config.json changes live — no reload required.',
+        // Verified against Continue docs as of 2026-05. MCP servers live under
+        // experimental.modelContextProtocolServers in ~/.continue/config.json.
+        configPath: (p) => path.join(home(p), '.continue', 'config.json'),
+        note: 'Merge this block into the top-level object — Continue keys MCP servers under `experimental.modelContextProtocolServers`.',
+        template: ({ url, apiKey, serverId = 'brainrouter' }) => ({
+            experimental: {
+                modelContextProtocolServers: [
+                    {
+                        name: serverId,
+                        transport: { type: 'http', url, headers: { Authorization: `Bearer ${apiKey}` } },
+                    },
+                ],
+            },
+        }),
+    },
+    zed: {
+        id: 'zed',
+        label: 'Zed',
+        schema: 'http',
+        restart: 'Zed reloads settings.json on save; reopen the assistant panel to see the new server.',
+        // Verified against Zed docs as of 2026-05. MCP servers live under
+        // `context_servers` in settings.json.
+        configPath: (p) => path.join(home(p), '.config', 'zed', 'settings.json'),
+        note: 'Merge the `context_servers` key into your existing settings.json.',
+        template: ({ url, apiKey, serverId = 'brainrouter' }) => ({
+            context_servers: {
+                [serverId]: {
+                    source: 'custom',
+                    url,
+                    headers: { Authorization: `Bearer ${apiKey}` },
+                },
+            },
+        }),
+    },
+    cline: {
+        id: 'cline',
+        label: 'Cline (VS Code)',
+        schema: 'http',
+        restart: 'Cline reloads MCP servers when this file is saved — toggle the server off/on in the MCP panel if not.',
+        // Verified against Cline docs as of 2026-05.
+        configPath: (p) => p === 'darwin'
+            ? path.join(home(p), 'Library', 'Application Support', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json')
+            : p === 'win32'
+                ? path.join(home(p), 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json')
+                : path.join(home(p), '.config', 'Code', 'User', 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json'),
+        template: ({ url, apiKey, serverId = 'brainrouter' }) => ({
+            mcpServers: {
+                [serverId]: {
+                    url,
+                    headers: { Authorization: `Bearer ${apiKey}` },
+                },
+            },
+        }),
+    },
+};
+export function listVendors() {
+    return Object.values(VENDORS);
+}
+export function getVendor(id) {
+    return VENDORS[id.toLowerCase()];
+}
+export function renderSnippet(entry, vars) {
+    return JSON.stringify(entry.template(vars), null, 2);
+}

package/dist/state/scheduleStore.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Persistent store for `/schedule` jobs.
+ *
+ * One JSON file per workspace under the user-global brainrouter home
+ * (same contract /feedback uses) — writes go through `writeJsonFile`
+ * which does the atomic temp-then-rename dance, so a Ctrl-C mid-write
+ * can't corrupt the file.
+ */
+export type ScheduleKind = 'cron' | 'once';
+export interface ScheduleRecord {
+    id: string;
+    kind: ScheduleKind;
+    /** Cron expression for `cron`, or ISO timestamp for `once`. */
+    expr: string;
+    /** Slash command to dispatch. Always starts with `/`. */
+    command: string;
+    /** sessionKey of the REPL that registered the schedule. */
+    owner: string;
+    createdAt: string;
+    enabled: boolean;
+    nextRun: string;
+    lastRun?: string;
+}
+export declare function loadSchedules(workspaceRoot: string): ScheduleRecord[];
+export declare function saveSchedules(workspaceRoot: string, list: ScheduleRecord[]): void;
+export interface AddScheduleInput {
+    kind: ScheduleKind;
+    expr: string;
+    command: string;
+    owner: string;
+    nextRun: string;
+    enabled?: boolean;
+}
+export declare function addSchedule(workspaceRoot: string, input: AddScheduleInput): ScheduleRecord;
+export declare function removeSchedule(workspaceRoot: string, id: string): boolean;
+export declare function setScheduleEnabled(workspaceRoot: string, id: string, enabled: boolean): boolean;
+export declare function recordFire(workspaceRoot: string, id: string, firedAt: Date, nextRun: string | undefined): void;

package/dist/state/scheduleStore.js

@@ -0,0 +1,64 @@
+/**
+ * Persistent store for `/schedule` jobs.
+ *
+ * One JSON file per workspace under the user-global brainrouter home
+ * (same contract /feedback uses) — writes go through `writeJsonFile`
+ * which does the atomic temp-then-rename dance, so a Ctrl-C mid-write
+ * can't corrupt the file.
+ */
+import crypto from 'node:crypto';
+import { getCliStateFile, readJsonFile, writeJsonFile } from './cliState.js';
+const FILE_NAME = 'schedules.json';
+const EMPTY = { version: 1, schedules: [] };
+function filePath(workspaceRoot) {
+    return getCliStateFile(workspaceRoot, FILE_NAME);
+}
+export function loadSchedules(workspaceRoot) {
+    return readJsonFile(filePath(workspaceRoot), EMPTY).schedules ?? [];
+}
+export function saveSchedules(workspaceRoot, list) {
+    writeJsonFile(filePath(workspaceRoot), { version: 1, schedules: list });
+}
+export function addSchedule(workspaceRoot, input) {
+    const list = loadSchedules(workspaceRoot);
+    const rec = {
+        id: 'sch_' + crypto.randomBytes(4).toString('hex'),
+        kind: input.kind,
+        expr: input.expr,
+        command: input.command,
+        owner: input.owner,
+        createdAt: new Date().toISOString(),
+        enabled: input.enabled ?? true,
+        nextRun: input.nextRun,
+    };
+    list.push(rec);
+    saveSchedules(workspaceRoot, list);
+    return rec;
+}
+export function removeSchedule(workspaceRoot, id) {
+    const list = loadSchedules(workspaceRoot);
+    const next = list.filter((s) => s.id !== id);
+    if (next.length === list.length)
+        return false;
+    saveSchedules(workspaceRoot, next);
+    return true;
+}
+export function setScheduleEnabled(workspaceRoot, id, enabled) {
+    const list = loadSchedules(workspaceRoot);
+    const rec = list.find((s) => s.id === id);
+    if (!rec)
+        return false;
+    rec.enabled = enabled;
+    saveSchedules(workspaceRoot, list);
+    return true;
+}
+export function recordFire(workspaceRoot, id, firedAt, nextRun) {
+    const list = loadSchedules(workspaceRoot);
+    const rec = list.find((s) => s.id === id);
+    if (!rec)
+        return;
+    rec.lastRun = firedAt.toISOString();
+    if (nextRun)
+        rec.nextRun = nextRun;
+    saveSchedules(workspaceRoot, list);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kinqs/brainrouter-cli",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "Memory-native terminal coding agent. Talks to the BrainRouter MCP cognitive engine for recall, skills, capture, persona, focus scenes, and contradiction tracking.",
   "type": "module",
   "main": "dist/index.js",
@@ -8,7 +8,9 @@
     "brainrouter": "bin/cli.cjs"
   },
   "files": [
+    "agents",
     "bin",
+    "changelog",
     "dist",
     "README.md",
     ".env.example"
@@ -19,24 +21,31 @@
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
     "test": "npm run build && node --test \"dist/**/*.test.js\"",
-    "prepack": "npm run build && find dist -name '*.test.*' -delete"
+    "prepack": "npm run build && find dist -name '*.test.*' -delete",
+    "sync-changelog": "rm -rf changelog && mkdir -p changelog && cp ../brainrouter-changelog/*.md changelog/",
+    "prepublishOnly": "npm run sync-changelog"
   },
   "dependencies": {
-    "@kinqs/brainrouter-sdk": "^0.3.6",
-    "@kinqs/brainrouter-types": "^0.3.6",
+    "@kinqs/brainrouter-sdk": "^0.3.8",
+    "@kinqs/brainrouter-types": "^0.3.8",
     "@modelcontextprotocol/sdk": "^1.11.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "dotenv": "^16.4.5",
+    "ink": "^7.0.3",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
     "inquirer": "^9.3.2",
     "marked": "^12.0.1",
     "marked-terminal": "^7.0.0",
-    "ora": "^8.0.1"
+    "ora": "^8.0.1",
+    "react": "^19.2.6"
   },
   "devDependencies": {
     "@types/inquirer": "^9.0.7",
     "@types/marked": "^4.0.8",
     "@types/node": "^22.0.0",
+    "@types/react": "^19.2.15",
     "tsx": "^4.7.0",
     "typescript": "^5.5.4"
   },

package/.env.example

@@ -1,116 +0,0 @@
-# BrainRouter CLI agent — environment template
-#
-# Copy to `brainrouter-cli/.env`. Loaded by the CLI at startup.
-#
-# This file is for CLI-AGENT concerns only:
-#   1. Chat LLM                  (the model the terminal agent talks to)
-#   2. Tool runtime              (loop limit, result clamp, MCP timeout, auto-compact)
-#   3. Sandbox                   (run_command wrapping)
-#   4. Workspace                 (root override + shared state root)
-#   5. Web search                (custom backend for the web_search tool)
-#   6. Observability             (trace log path)
-#
-# MCP-server concerns (cognitive extraction, embeddings, reranker, judge,
-# memory engine knobs, server auth) live in `brainrouter/.env.example`.
-#
-# Why split: the MCP and the CLI are separate processes with different
-# concerns. The CLI's chat LLM can be a smart cloud model while the MCP's
-# cognitive extractor is a cheap local one. Their concurrency caps differ
-# too (CLI default 4, MCP default 2). Keep them independent.
-#
-# All values in this template are blank placeholders. Fill in only what
-# you actually need — most settings have sensible defaults.
-
-
-# =============================================================================
-# 1. Chat LLM (for the agent's own conversation)
-# =============================================================================
-# Same var names as the MCP, but a separate process — set them here for the
-# CLI's chat model. Falls back to OPENAI_API_KEY.
-#
-# If you don't set BRAINROUTER_LLM_API_KEY here, the CLI also reads it from
-# `brainrouter/.env` as a transitional fallback. Setting it here makes the
-# CLI's choice explicit and lets you use a different chat model than the
-# MCP's extractor (e.g. gpt-4o for chat, gpt-4o-mini for extraction).
-BRAINROUTER_LLM_API_KEY=
-
-# OpenAI-compatible chat-completions endpoint.
-# Examples:
-#   OpenAI:                   https://api.openai.com/v1/chat/completions
-#   OpenRouter:               https://openrouter.ai/api/v1/chat/completions
-#   Anthropic via OpenRouter: model id "anthropic/claude-sonnet-4"
-#   LM Studio:                http://localhost:1234/v1/chat/completions
-BRAINROUTER_LLM_ENDPOINT=https://api.openai.com/v1/chat/completions
-BRAINROUTER_LLM_MODEL=gpt-4o-mini
-
-# Per-call timeout for the CLI's chat LLM. Default 120000 (2 min).
-# BRAINROUTER_LLM_TIMEOUT_MS=120000
-
-# Cap on concurrent in-flight chat LLM calls FROM THE CLI PROCESS.
-# Default 4 (separate from the MCP's own cap). Set to 1 for consumer-grade
-# local backends; raise to 16+ for cloud APIs.
-# BRAINROUTER_LLM_MAX_CONCURRENT=4
-
-
-# =============================================================================
-# 2. Tool runtime
-# =============================================================================
-# Per-tool timeout for CLI → MCP requests. Default 60000.
-# BRAINROUTER_MCP_TIMEOUT_MS=60000
-
-# LLM-visible clamp on a single tool-result body (full text still recorded
-# in the transcript on disk). Default 8000.
-# BRAINROUTER_MAX_TOOL_RESULT_CHARS=8000
-
-# Hard ceiling on tool-call iterations per turn. Default 60.
-# BRAINROUTER_MAX_TOOL_LOOPS=60
-
-# Estimated history-size trigger for auto-`/compact`. Default 80000 tokens.
-# BRAINROUTER_AUTO_COMPACT_TOKENS=80000
-
-
-# =============================================================================
-# 3. Sandbox (run_command)
-# =============================================================================
-# Wrap shell commands in the platform sandbox:
-#   macOS: sandbox-exec
-#   Linux: bwrap (preferred) or firejail
-# Set `on` to enable. Off by default.
-# BRAINROUTER_SANDBOX=on
-
-# Allow outbound network from sandboxed commands. Off by default.
-# BRAINROUTER_SANDBOX_NETWORK=off
-
-# Colon-separated read/write path allowlists.
-# BRAINROUTER_SANDBOX_READ_PATHS=/usr/local:/opt
-# BRAINROUTER_SANDBOX_WRITE_PATHS=/tmp
-
-
-# =============================================================================
-# 4. Workspace
-# =============================================================================
-# Override the workspace root the CLI uses for file tools + session key.
-# Most users let the CLI auto-detect via git / closest package.json.
-# BRAINROUTER_WORKSPACE=/path/to/project
-
-# Override per-user state root. Default: ~/.brainrouter.
-# Both the CLI and MCP honor this — set it once and both processes use it.
-# BRAINROUTER_HOME=/path/to/state
-
-
-# =============================================================================
-# 5. Web search
-# =============================================================================
-# Custom search backend for the web_search tool. Must accept
-#   POST { query, maxResults } → { results: [{ title, url, snippet }] }
-# Falls back to DuckDuckGo's Instant Answer API when unset.
-# Compatible with Brave Search API wrappers, Tavily, SerpAPI proxies, etc.
-# BRAINROUTER_WEB_SEARCH_ENDPOINT=https://your-search-proxy.example.com/search
-
-
-# =============================================================================
-# 6. Observability
-# =============================================================================
-# Path for OTEL-style JSONL turn traces. One line per turn/tool span.
-# Toggle at runtime with /trace on|off.
-# BRAINROUTER_TRACE_LOG=/path/to/trace.jsonl