@schlessera/brain-ui-server 0.13.1 → 0.15.0

package/dist/brain/client.js

@@ -1,154 +1,160 @@
 import { existsSync } from "fs";
 import { join } from "path";
-const BRAIN_PATH = process.env.BRAIN_PATH || join(process.env.HOME || "/root", "brain");
+import { subprocessEnv } from "../config/env.js";
 /**
- * argv prefix for invoking the brain CLI inside BRAIN_PATH.
+ * argv prefix for invoking the brain CLI inside `brainPath`.
  *
  * Two brain-repo layouts exist and both must work: a repo that depends on
  * `@schlessera/brain` gets a real bin at `node_modules/.bin/brain`, while the
  * legacy layout vendors `scripts/brain-cli.ts`. Prefer the packaged bin.
  *
- * Resolved per call (a bare `existsSync` stat) rather than at import time: in
+ * Resolved per call (a bare `existsSync` stat) rather than at construction: in
  * the container the brain repo is cloned and `bun install`ed by entrypoint.sh,
  * and a repo can gain the dependency without restarting this server. The same
  * preference order is mirrored in `scripts/entrypoint.sh`, which links whichever
  * it finds onto PATH for cron.
  */
-export function brainCliCommand() {
-    const packaged = join(BRAIN_PATH, "node_modules", ".bin", "brain");
+export function brainCliCommand(brainPath) {
+    const packaged = join(brainPath, "node_modules", ".bin", "brain");
     if (existsSync(packaged))
         return [packaged];
     return ["bun", "scripts/brain-cli.ts"];
 }
-async function execBrain(args) {
-    const proc = Bun.spawn([...brainCliCommand(), ...args], {
-        cwd: BRAIN_PATH,
-        stdout: "pipe",
-        stderr: "pipe",
-        env: {
-            ...process.env,
+export function createBrainClient(opts) {
+    const { brainPath } = opts;
+    async function execBrain(args) {
+        const proc = Bun.spawn([...brainCliCommand(brainPath), ...args], {
+            cwd: brainPath,
+            stdout: "pipe",
+            stderr: "pipe",
             // Force JSON output when not a TTY
-            NO_COLOR: "1",
-        },
-    });
-    const [stdout, stderr] = await Promise.all([
-        new Response(proc.stdout).text(),
-        new Response(proc.stderr).text(),
-    ]);
-    const exitCode = await proc.exited;
-    return { stdout, stderr, exitCode };
-}
-function parseJsonOutput(result) {
-    if (result.exitCode !== 0) {
-        throw new Error(`brain CLI failed (exit ${result.exitCode}): ${result.stderr || result.stdout}`);
-    }
-    try {
-        return JSON.parse(result.stdout);
-    }
-    catch {
-        // Some commands output plain text, not JSON
-        return result.stdout;
-    }
-}
-export async function brainSearch(query, opts) {
-    const args = ["search", query];
-    if (opts?.type)
-        args.push("--type", opts.type);
-    if (opts?.tag)
-        args.push("--tag", opts.tag);
-    if (opts?.limit)
-        args.push("--limit", String(opts.limit));
-    if (opts?.mode)
-        args.push("--mode", opts.mode);
-    const result = await execBrain(args);
-    const parsed = parseJsonOutput(result);
-    // brain returns {results, warnings} since 22e82e1; tolerate the old bare array
-    return Array.isArray(parsed) ? { results: parsed, warnings: [] } : parsed;
-}
-export async function brainBriefing() {
-    const result = await execBrain(["briefing"]);
-    if (result.exitCode !== 0) {
-        throw new Error(`brain briefing failed: ${result.stderr}`);
-    }
-    return result.stdout;
-}
-export async function brainStats() {
-    const result = await execBrain(["stats"]);
-    return parseJsonOutput(result);
-}
-export async function brainList(opts) {
-    const args = ["list"];
-    if (opts?.type)
-        args.push("--type", opts.type);
-    if (opts?.tag)
-        args.push("--tag", opts.tag);
-    if (opts?.status)
-        args.push("--status", opts.status);
-    if (opts?.relevance)
-        args.push("--relevance", opts.relevance);
-    if (opts?.limit)
-        args.push("--limit", String(opts.limit));
-    const result = await execBrain(args);
-    return parseJsonOutput(result);
-}
-export async function brainRead(path) {
-    const result = await execBrain(["read", path]);
-    if (result.exitCode !== 0) {
-        throw new Error(`brain read failed: ${result.stderr}`);
-    }
-    return result.stdout;
-}
-export async function brainSync() {
-    // Note: brain sync spawns Claude Code internally via the /sync skill.
-    // For cron jobs, we use a simpler git-based sync instead.
-    const result = await execBrain(["sync"]);
-    if (result.exitCode !== 0) {
-        return {
-            success: false,
-            commits: 0,
-            conflicts: 0,
-            message: result.stderr || result.stdout,
-        };
-    }
-    try {
-        return parseJsonOutput(result);
-    }
-    catch {
-        return {
-            success: true,
-            commits: 0,
-            conflicts: 0,
-            message: result.stdout,
-        };
+            env: subprocessEnv({ NO_COLOR: "1" }),
+        });
+        const [stdout, stderr] = await Promise.all([
+            new Response(proc.stdout).text(),
+            new Response(proc.stderr).text(),
+        ]);
+        const exitCode = await proc.exited;
+        return { stdout, stderr, exitCode };
     }
-}
-export async function brainAdd(content, opts) {
-    const args = ["add", content];
-    if (opts?.type)
-        args.push("--type", opts.type);
-    if (opts?.title)
-        args.push("--title", opts.title);
-    if (opts?.tags)
-        args.push("--tags", opts.tags.join(","));
-    const result = await execBrain(args);
-    if (result.exitCode !== 0) {
-        throw new Error(`brain add failed: ${result.stderr}`);
-    }
-}
-export async function brainIndex(opts) {
-    const args = ["index"];
-    if (opts?.force)
-        args.push("--force");
-    const result = await execBrain(args);
-    if (result.exitCode !== 0) {
-        throw new Error(`brain index failed: ${result.stderr}`);
-    }
-}
-export async function brainValidate() {
-    const result = await execBrain(["validate"]);
-    if (result.exitCode !== 0) {
-        throw new Error(`brain validate failed: ${result.stderr}`);
+    function parseJsonOutput(result) {
+        if (result.exitCode !== 0) {
+            throw new Error(`brain CLI failed (exit ${result.exitCode}): ${result.stderr || result.stdout}`);
+        }
+        try {
+            return JSON.parse(result.stdout);
+        }
+        catch {
+            // Some commands output plain text, not JSON
+            return result.stdout;
+        }
     }
-    return result.stdout;
+    return {
+        cliCommand() {
+            return brainCliCommand(brainPath);
+        },
+        async search(query, opts) {
+            const args = ["search", query];
+            if (opts?.type)
+                args.push("--type", opts.type);
+            if (opts?.tag)
+                args.push("--tag", opts.tag);
+            if (opts?.limit)
+                args.push("--limit", String(opts.limit));
+            if (opts?.mode)
+                args.push("--mode", opts.mode);
+            const result = await execBrain(args);
+            const parsed = parseJsonOutput(result);
+            // brain returns {results, warnings} since 22e82e1; tolerate the old bare array
+            return Array.isArray(parsed) ? { results: parsed, warnings: [] } : parsed;
+        },
+        async briefing() {
+            const result = await execBrain(["briefing"]);
+            if (result.exitCode !== 0) {
+                throw new Error(`brain briefing failed: ${result.stderr}`);
+            }
+            return result.stdout;
+        },
+        async stats() {
+            const result = await execBrain(["stats"]);
+            return parseJsonOutput(result);
+        },
+        async list(opts) {
+            const args = ["list"];
+            if (opts?.type)
+                args.push("--type", opts.type);
+            if (opts?.tag)
+                args.push("--tag", opts.tag);
+            if (opts?.status)
+                args.push("--status", opts.status);
+            if (opts?.relevance)
+                args.push("--relevance", opts.relevance);
+            if (opts?.limit)
+                args.push("--limit", String(opts.limit));
+            const result = await execBrain(args);
+            return parseJsonOutput(result);
+        },
+        async read(path) {
+            const result = await execBrain(["read", path]);
+            if (result.exitCode !== 0) {
+                throw new Error(`brain read failed: ${result.stderr}`);
+            }
+            return result.stdout;
+        },
+        async sync() {
+            // Note: brain sync spawns Claude Code internally via the /sync skill.
+            // For cron jobs, we use a simpler git-based sync instead.
+            const result = await execBrain(["sync"]);
+            if (result.exitCode !== 0) {
+                return {
+                    success: false,
+                    commits: 0,
+                    conflicts: 0,
+                    message: result.stderr || result.stdout,
+                };
+            }
+            try {
+                return parseJsonOutput(result);
+            }
+            catch {
+                return {
+                    success: true,
+                    commits: 0,
+                    conflicts: 0,
+                    message: result.stdout,
+                };
+            }
+        },
+        async add(content, opts) {
+            const args = ["add", content];
+            if (opts?.type)
+                args.push("--type", opts.type);
+            if (opts?.title)
+                args.push("--title", opts.title);
+            if (opts?.tags)
+                args.push("--tags", opts.tags.join(","));
+            const result = await execBrain(args);
+            if (result.exitCode !== 0) {
+                throw new Error(`brain add failed: ${result.stderr}`);
+            }
+        },
+        async index(opts) {
+            const args = ["index"];
+            // Full rebuild; indexing is incremental by default since brain 22e82e1.
+            if (opts?.force)
+                args.push("--force");
+            const result = await execBrain(args);
+            if (result.exitCode !== 0) {
+                throw new Error(`brain index failed: ${result.stderr}`);
+            }
+        },
+        async validate() {
+            const result = await execBrain(["validate"]);
+            if (result.exitCode !== 0) {
+                throw new Error(`brain validate failed: ${result.stderr}`);
+            }
+            return result.stdout;
+        },
+    };
 }
 //# sourceMappingURL=client.js.map

package/dist/brain/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/brain/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/brain/client.ts"],"names":[],"mappings":"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"}

package/dist/config/env.d.ts

@@ -0,0 +1,104 @@
+/**
+ * The package's ONLY `process.env` reader.
+ *
+ * Everything `@schlessera/brain-ui-server` can be configured with is declared
+ * here twice: once as a runtime descriptor ({@link ENV_VARS}, the artifact the
+ * env-parity gate diffs against the documentation) and once as the resolver
+ * ({@link resolveServerConfig}) that turns an environment into a plain,
+ * fully-resolved {@link ServerConfig}.
+ *
+ * `createApp()` resolves the environment ONCE, at the edge; every consumer
+ * inside the package receives the resolved object (or a slice of it) and never
+ * touches `process.env` itself. Tests vary configuration by passing their own
+ * env record to the resolver — no global mutation required.
+ */
+export interface EnvVarDescriptor {
+    /** The environment variable, exactly as read. */
+    name: string;
+    /** What it controls. */
+    description: string;
+    /** Human-readable default applied when unset, or null when there is none. */
+    default: string | null;
+    /**
+     * `false` when optional; otherwise a human-readable statement of the
+     * condition under which boot fails without it.
+     */
+    required: false | string;
+}
+/**
+ * Every environment variable this package reads. Order groups by concern.
+ * The env-parity gate (G4) asserts this list equals the package's env
+ * documentation in both directions — add here and to the docs together.
+ */
+export declare const ENV_VARS: readonly EnvVarDescriptor[];
+export type AuthModeName = "password" | "tailscale" | "proxy" | "none";
+export interface AuthConfig {
+    /** Validated AUTH_MODE, or null to auto-detect. */
+    mode: AuthModeName | null;
+    /** The raw AUTH_MODE value when it did not validate (for the boot warning). */
+    invalidMode: string | null;
+    passwordHash: string | null;
+    cookieSecret: string | null;
+    trustProxy: boolean;
+    trustProxyHops: number;
+    /** Lowercased proxy auth header name. */
+    proxyAuthHeader: string;
+    dangerouslyDisableAuth: boolean;
+    allowPassword: boolean;
+}
+export interface WebAuthnConfig {
+    rpName: string;
+    userName: string;
+    userId: string;
+    rpId: string | null;
+    origins: string[];
+    allowLoopbackOrigin: boolean;
+}
+export interface AgentConfig {
+    /** Trimmed, lowercased AGENT_BACKEND; null when unset (defaults to claude). */
+    backend: string | null;
+    claudeCodePath: string;
+    defaultModel: string;
+    /** Raw BRAIN_UI_CLAUDE_PROFILES JSON, parsed lazily by the registry. */
+    profilesJson: string | null;
+    modelDiscovery: boolean;
+    modelTtlMs: number;
+}
+export interface VoiceConfig {
+    /** Trimmed, lowercased VOICE_PROVIDER; null when unset (auto-detect). */
+    provider: string | null;
+    deepgramApiKey: string | null;
+    keytermLimit: number;
+    /** Resolved keyterm cache directory. */
+    cacheDir: string;
+}
+/** Fully-resolved server configuration. Plain data — safe to construct in tests. */
+export interface ServerConfig {
+    brainPath: string;
+    dbPath: string;
+    /** Bind host, for the loopback check in auth validation. Empty when unset. */
+    host: string;
+    sourceCommit: string;
+    allowedOrigins: string[];
+    maxConcurrentSessions: number;
+    auth: AuthConfig;
+    webauthn: WebAuthnConfig;
+    agent: AgentConfig;
+    voice: VoiceConfig;
+}
+type EnvRecord = Record<string, string | undefined>;
+/**
+ * Resolve an environment into a {@link ServerConfig}. Defaults to the real
+ * process environment; tests pass their own record instead of mutating it.
+ */
+export declare function resolveServerConfig(env?: EnvRecord): ServerConfig;
+/**
+ * The parent environment for spawned subprocesses (brain CLI, whatsup), plus
+ * overrides. Child processes legitimately inherit the whole environment
+ * (PATH, credentials for the tools they run) — that is process plumbing, not
+ * configuration, but it still reads `process.env`, so it lives behind this
+ * chokepoint.
+ */
+export declare function subprocessEnv(extra?: Record<string, string>): EnvRecord;
+export {};
+//# sourceMappingURL=env.d.ts.map

package/dist/config/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,KAAK,GAAG,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,gBAAgB,EAkNtC,CAAC;AAIX,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;AAEvE,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1B,+EAA+E;IAC/E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,OAAO,CAAC;IAChC,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,yEAAyE;IACzE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;CACpB;AAID,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAepD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,SAAuB,GAAG,YAAY,CAuD9E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,SAAS,CAE3E"}