@kinqs/brainrouter-cli 0.3.7 → 0.3.8

package/dist/runtime/vendorSnippets.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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).
+ */
+export type VendorSchema = 'stdio' | 'http' | 'sse';
+export interface VendorVars {
+    /** Active BrainRouter profile URL (http transport). */
+    url: string;
+    /** Active BrainRouter profile API key — rendered verbatim into the snippet. */
+    apiKey: string;
+    /** Server id the user picks in their vendor config (defaults to "brainrouter"). */
+    serverId?: string;
+}
+export interface VendorEntry {
+    id: string;
+    label: string;
+    schema: VendorSchema;
+    /** Restart note shown after the snippet. */
+    restart: string;
+    /** Per-OS config file path. POSIX path with `~` for the user's home. */
+    configPath: (platform: NodeJS.Platform) => string;
+    /** Pure template — returns the JSON object the user should merge into their vendor config. */
+    template: (vars: VendorVars) => unknown;
+    /** Free-form note (e.g. nested-key location, alternative shape). */
+    note?: string;
+}
+/** Render a config path for human display — backslashes on Windows. */
+export declare function displayPath(p: string, platform?: NodeJS.Platform): string;
+export declare const VENDORS: Record<string, VendorEntry>;
+export declare function listVendors(): VendorEntry[];
+export declare function getVendor(id: string): VendorEntry | undefined;
+export declare function renderSnippet(entry: VendorEntry, vars: VendorVars): string;

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.7",
+  "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",
@@ -10,6 +10,7 @@
   "files": [
     "agents",
     "bin",
+    "changelog",
     "dist",
     "README.md",
     ".env.example"
@@ -20,11 +21,13 @@
     "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",