@hongmaple0820/scale-engine 0.38.0 → 0.39.0

package/dist/env/EnvironmentDoctor.js

@@ -0,0 +1,365 @@
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { arch, platform, release } from 'node:os';
+import { delimiter, extname } from 'node:path';
+import { resolveExternalCommandPath } from '../core/ExternalCommand.js';
+const CHECK_DEFINITIONS = [
+    {
+        id: 'git',
+        label: 'Git',
+        category: 'core',
+        required: true,
+        candidates: [{ command: 'git', args: ['--version'], display: 'git' }],
+        requiredFor: ['repository workflow', 'release verification'],
+        installHint: 'Install Git and re-open the shell so git is on PATH.',
+    },
+    {
+        id: 'npm',
+        label: 'npm',
+        category: 'core',
+        required: true,
+        candidates: [{ command: 'npm', args: ['--version'], display: 'npm' }],
+        requiredFor: ['scale install', 'codegraph install', 'node-library workflow'],
+        installHint: 'Install Node.js 20+; npm is bundled with Node.js.',
+    },
+    {
+        id: 'npx',
+        label: 'npx',
+        category: 'core',
+        required: true,
+        candidates: [{ command: 'npx', args: ['--version'], display: 'npx' }],
+        requiredFor: ['awesome-design-md', 'ui-ux-pro-max', 'frontend-design'],
+        installHint: 'Install Node.js 20+; npx is bundled with npm.',
+    },
+    {
+        id: 'powershell',
+        label: 'PowerShell',
+        category: 'shell',
+        required: false,
+        candidates: [
+            { command: 'pwsh', args: ['-NoProfile', '-Command', '$PSVersionTable.PSVersion.ToString()'], display: 'pwsh' },
+            { command: 'powershell', args: ['-NoProfile', '-Command', '$PSVersionTable.PSVersion.ToString()'], display: 'powershell' },
+        ],
+        requiredFor: ['Windows workflow wrappers', 'RTK Windows proxy'],
+        installHint: 'Install PowerShell 7+ or use Windows PowerShell where available.',
+    },
+    {
+        id: 'bash',
+        label: 'Bash',
+        category: 'shell',
+        required: false,
+        candidates: [{ command: 'bash', args: ['--version'], display: 'bash' }],
+        requiredFor: ['Unix workflow wrappers', 'make targets'],
+        installHint: 'Install Bash through Git for Windows, WSL, or the OS package manager.',
+    },
+    {
+        id: 'cargo',
+        label: 'Rust/Cargo',
+        category: 'runtime',
+        required: false,
+        candidates: [{ command: 'cargo', args: ['--version'], display: 'cargo' }],
+        requiredFor: ['rtk install'],
+        installHint: 'Install Rust with rustup, then re-open the shell so cargo is on PATH.',
+    },
+    {
+        id: 'bun',
+        label: 'Bun',
+        category: 'runtime',
+        required: false,
+        candidates: [{ command: 'bun', args: ['--version'], display: 'bun' }],
+        requiredFor: ['gbrain install'],
+        installHint: 'Install Bun from https://bun.sh and re-open the shell.',
+    },
+    {
+        id: 'python',
+        label: 'Python',
+        category: 'runtime',
+        required: false,
+        candidates: [
+            { command: 'python', args: ['--version'], display: 'python' },
+            { command: 'python3', args: ['--version'], display: 'python3' },
+            { command: 'py', args: ['--version'], display: 'py' },
+        ],
+        requiredFor: ['graphify install'],
+        installHint: 'Install Python 3.10+ and ensure it is on PATH.',
+    },
+    {
+        id: 'python-installer',
+        label: 'Python installer',
+        category: 'runtime',
+        required: false,
+        candidates: [
+            { command: 'uv', args: ['--version'], display: 'uv' },
+            { command: 'pipx', args: ['--version'], display: 'pipx' },
+            { command: 'pip', args: ['--version'], display: 'pip' },
+            { command: 'pip3', args: ['--version'], display: 'pip3' },
+            { command: 'python', args: ['-m', 'pip', '--version'], display: 'python -m pip' },
+            { command: 'python3', args: ['-m', 'pip', '--version'], display: 'python3 -m pip' },
+        ],
+        requiredFor: ['graphify install'],
+        installHint: 'Install uv or pipx first; pip is supported only as a fallback.',
+    },
+    {
+        id: 'rtk',
+        label: 'RTK',
+        category: 'third-party',
+        required: false,
+        candidates: [{ command: 'rtk', args: ['--version'], display: 'rtk' }],
+        requiredFor: ['governed CLI proxy', 'token savings evidence'],
+        installHint: 'Install with cargo, then run `rtk init -g --codex` and `rtk gain`.',
+    },
+    {
+        id: 'gbrain',
+        label: 'GBrain',
+        category: 'third-party',
+        required: false,
+        candidates: [{ command: 'gbrain', args: ['doctor', '--json'], display: 'gbrain doctor --json' }],
+        requiredFor: ['memory provider routing', 'cross-session recall'],
+        installHint: 'Install with Bun and run `gbrain init --pglite` before autonomous recall.',
+    },
+    {
+        id: 'graphify',
+        label: 'Graphify',
+        category: 'third-party',
+        required: false,
+        candidates: [{ command: 'graphify', args: ['--version'], display: 'graphify' }],
+        requiredFor: ['knowledge graph provider'],
+        installHint: 'Install with `uv tool install graphify && graphify install --platform codex`.',
+    },
+    {
+        id: 'codegraph',
+        label: 'CodeGraph',
+        category: 'third-party',
+        required: false,
+        candidates: [{ command: 'codegraph', args: ['--version'], display: 'codegraph' }],
+        requiredFor: ['code intelligence provider'],
+        installHint: 'Install with `npm install -g @colbymchenry/codegraph` and run `codegraph init -i` per project.',
+    },
+];
+export function inspectEnvironment(options = {}) {
+    const env = options.env ?? process.env;
+    const currentPlatform = options.platform ?? platform();
+    const currentArch = options.arch ?? arch();
+    const currentRelease = options.release ?? release();
+    const currentNodeVersion = options.nodeVersion ?? process.version;
+    const currentExecPath = options.execPath ?? process.execPath;
+    const resolver = options.commandResolver ?? resolveExternalCommandPath;
+    const runner = options.commandRunner ?? runCommand;
+    const pathEntries = String(env.PATH ?? env.Path ?? '')
+        .split(currentPlatform === 'win32' ? ';' : delimiter)
+        .map(entry => entry.trim())
+        .filter(Boolean);
+    const checks = CHECK_DEFINITIONS.map(definition => inspectCommand(definition, resolver, runner));
+    const nodeStatus = nodeVersionStatus(currentNodeVersion);
+    const warnings = buildWarnings(checks, nodeStatus);
+    const recommendations = buildRecommendations(checks, nodeStatus);
+    const requiredFailures = checks.filter(check => check.required && (check.status === 'missing' || check.status === 'fail')).length;
+    const warnCount = checks.filter(check => check.status === 'warn').length + (nodeStatus.status === 'warn' ? 1 : 0);
+    const status = nodeStatus.status === 'fail' || requiredFailures > 0
+        ? 'broken'
+        : warnCount > 0 ? 'degraded' : 'healthy';
+    return {
+        ok: status !== 'broken',
+        status,
+        generatedAt: new Date().toISOString(),
+        platform: currentPlatform,
+        arch: currentArch,
+        release: currentRelease,
+        node: {
+            version: currentNodeVersion,
+            execPath: currentExecPath,
+            status: nodeStatus.status,
+            reason: nodeStatus.reason,
+        },
+        shell: {
+            defaultShell: env.SHELL,
+            comspec: env.ComSpec,
+            detected: shellCandidates(currentPlatform).map(command => ({
+                id: command,
+                available: Boolean(resolver(command)),
+                path: resolver(command) ?? undefined,
+            })),
+        },
+        path: {
+            delimiter: currentPlatform === 'win32' ? ';' : delimiter,
+            entryCount: pathEntries.length,
+            entriesPreview: pathEntries.slice(0, 12),
+        },
+        checks,
+        warnings,
+        recommendations,
+    };
+}
+export function renderEnvironmentDoctor(report) {
+    const lines = [
+        '',
+        'SCALE Environment Doctor',
+        `  Status: ${report.status.toUpperCase()}`,
+        `  OS: ${report.platform} ${report.arch} ${report.release}`,
+        `  Node: ${report.node.version} (${report.node.status})`,
+        `  PATH entries: ${report.path.entryCount}`,
+    ];
+    for (const check of report.checks) {
+        lines.push(`  [${check.status.toUpperCase()}] ${check.id}: ${check.reason}`);
+        if (check.detectedCommand && check.version)
+            lines.push(`    detected: ${check.detectedCommand} (${check.version})`);
+        if ((check.status === 'missing' || check.status === 'fail' || check.status === 'warn') && check.installHint) {
+            lines.push(`    fix: ${check.installHint}`);
+        }
+    }
+    for (const warning of report.warnings)
+        lines.push(`  [WARN] ${warning}`);
+    for (const recommendation of report.recommendations)
+        lines.push(`  [NEXT] ${recommendation}`);
+    return lines.join('\n');
+}
+function inspectCommand(definition, resolver, runner) {
+    let firstFailed;
+    for (const candidate of definition.candidates) {
+        const resolved = resolver(candidate.command);
+        if (!resolved)
+            continue;
+        const result = runner(candidate.command, candidate.args, resolved);
+        const output = `${result.stdout}\n${result.stderr}`.trim();
+        if (result.exitCode === 0) {
+            const version = firstLine(output);
+            const status = commandVersionStatus(definition.id, version);
+            return {
+                id: definition.id,
+                label: definition.label,
+                category: definition.category,
+                status: status.status,
+                required: definition.required,
+                candidates: definition.candidates.map(item => item.display),
+                detectedCommand: candidate.display,
+                resolvedPath: resolved,
+                version,
+                reason: status.reason ?? `${definition.label} is available via ${candidate.display}.`,
+                installHint: definition.installHint,
+                requiredFor: definition.requiredFor,
+            };
+        }
+        firstFailed ??= {
+            id: definition.id,
+            label: definition.label,
+            category: definition.category,
+            status: 'warn',
+            required: definition.required,
+            candidates: definition.candidates.map(item => item.display),
+            detectedCommand: candidate.display,
+            resolvedPath: resolved,
+            reason: `${definition.label} was found but health/version command failed: ${firstLine(output)}`,
+            installHint: definition.installHint,
+            requiredFor: definition.requiredFor,
+        };
+    }
+    if (firstFailed)
+        return firstFailed;
+    return {
+        id: definition.id,
+        label: definition.label,
+        category: definition.category,
+        status: definition.required ? 'fail' : 'missing',
+        required: definition.required,
+        candidates: definition.candidates.map(item => item.display),
+        reason: `${definition.label} was not detected on PATH.`,
+        installHint: definition.installHint,
+        requiredFor: definition.requiredFor,
+    };
+}
+function runCommand(command, args, resolvedPath) {
+    const executable = resolveWindowsCommandShim(resolvedPath ?? command);
+    const wrapperArgs = isWindowsCommandWrapper(executable)
+        ? ['/d', '/c', 'call', executable, ...args]
+        : args;
+    const result = spawnSync(isWindowsCommandWrapper(executable) ? process.env.ComSpec ?? 'cmd.exe' : executable, wrapperArgs, {
+        encoding: 'utf8',
+        shell: false,
+        windowsHide: true,
+        timeout: 10_000,
+        maxBuffer: 1024 * 1024,
+    });
+    return {
+        exitCode: typeof result.status === 'number' ? result.status : 1,
+        stdout: String(result.stdout ?? ''),
+        stderr: String(result.stderr ?? result.error?.message ?? ''),
+    };
+}
+function resolveWindowsCommandShim(executable) {
+    if (process.platform !== 'win32')
+        return executable;
+    if (!/[\\/]/.test(executable) || extname(executable))
+        return executable;
+    for (const extension of ['.cmd', '.exe', '.bat', '.com']) {
+        const candidate = `${executable}${extension}`;
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return executable;
+}
+function isWindowsCommandWrapper(executable) {
+    return process.platform === 'win32' && /\.(cmd|bat)$/i.test(executable);
+}
+function nodeVersionStatus(value) {
+    const version = parseSemver(value);
+    if (!version)
+        return { status: 'warn', reason: `Could not parse Node.js version: ${value}` };
+    if (version.major < 20)
+        return { status: 'fail', reason: `Node.js ${value} is below the required 20.x baseline.` };
+    return { status: 'ok', reason: `Node.js ${value} satisfies the 20+ baseline.` };
+}
+function commandVersionStatus(id, version) {
+    if (id === 'python') {
+        const parsed = parseSemver(version);
+        if (!parsed || parsed.major < 3 || (parsed.major === 3 && parsed.minor < 10)) {
+            return { status: 'warn', reason: `${version || 'Python'} is detected, but Graphify requires Python 3.10+.` };
+        }
+    }
+    if (id === 'python-installer' && version && !/^(uv|pipx)\b/i.test(version)) {
+        return { status: 'warn', reason: `${version} is available, but uv or pipx is preferred for isolated graphify installs.` };
+    }
+    return { status: 'ok' };
+}
+function buildWarnings(checks, nodeStatus) {
+    const warnings = [];
+    if (nodeStatus.status !== 'ok')
+        warnings.push(nodeStatus.reason);
+    for (const check of checks) {
+        if (check.required && (check.status === 'missing' || check.status === 'fail'))
+            warnings.push(`${check.id} is required: ${check.reason}`);
+        if (!check.required && check.status === 'warn')
+            warnings.push(`${check.id}: ${check.reason}`);
+    }
+    return warnings;
+}
+function buildRecommendations(checks, nodeStatus) {
+    const recommendations = new Set();
+    if (nodeStatus.status !== 'ok')
+        recommendations.add('Install Node.js 20+ before running SCALE workflow commands.');
+    for (const check of checks) {
+        if ((check.status === 'missing' || check.status === 'fail' || check.status === 'warn') && check.installHint) {
+            recommendations.add(check.installHint);
+        }
+    }
+    recommendations.add('Use `npm run smoke:setup` as the cross-platform setup smoke; use `make setup-smoke` only where make is installed.');
+    return [...recommendations];
+}
+function shellCandidates(currentPlatform) {
+    return currentPlatform === 'win32'
+        ? ['powershell', 'pwsh', 'cmd', 'bash']
+        : ['bash', 'sh', 'pwsh'];
+}
+function firstLine(value) {
+    return value.split(/\r?\n/).map(line => line.trim()).find(Boolean) ?? '';
+}
+function parseSemver(value) {
+    const match = value.match(/(\d+)\.(\d+)(?:\.(\d+))?/);
+    if (!match)
+        return null;
+    return {
+        major: Number.parseInt(match[1], 10),
+        minor: Number.parseInt(match[2], 10),
+        patch: Number.parseInt(match[3] ?? '0', 10),
+    };
+}
+//# sourceMappingURL=EnvironmentDoctor.js.map

package/dist/env/EnvironmentDoctor.js.map

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

package/dist/i18n/Language.d.ts

@@ -0,0 +1,9 @@
+export type ScaleLanguage = 'zh' | 'en';
+export interface ResolveLanguageOptions {
+    lang?: unknown;
+    projectDir?: string;
+    scaleDir?: string;
+    env?: Record<string, string | undefined>;
+}
+export declare function normalizeLanguage(value: unknown, fallback?: ScaleLanguage): ScaleLanguage;
+export declare function resolveCliLanguage(options?: ResolveLanguageOptions): ScaleLanguage;

package/dist/i18n/Language.js

@@ -0,0 +1,38 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+export function normalizeLanguage(value, fallback = 'zh') {
+    const raw = String(value ?? '').trim().toLowerCase();
+    if (!raw)
+        return fallback;
+    if (raw === 'en' || raw.startsWith('en-') || raw === 'english')
+        return 'en';
+    if (raw === 'zh' || raw.startsWith('zh-') || raw === 'cn' || raw === 'chinese' || raw === '中文')
+        return 'zh';
+    return fallback;
+}
+export function resolveCliLanguage(options = {}) {
+    const env = options.env ?? process.env;
+    if (options.lang !== undefined && String(options.lang).trim())
+        return normalizeLanguage(options.lang);
+    if (env.SCALE_LANG)
+        return normalizeLanguage(env.SCALE_LANG);
+    const configured = readConfiguredLanguage(options.projectDir, options.scaleDir);
+    return normalizeLanguage(configured, 'zh');
+}
+function readConfiguredLanguage(projectDir = process.cwd(), scaleDir = '.scale') {
+    const configPath = join(resolveScaleRoot(projectDir, scaleDir), 'config.yaml');
+    if (!existsSync(configPath))
+        return undefined;
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        const match = content.match(/^\s*(?:locale|language|lang)\s*:\s*["']?([^"'\s#]+)["']?/m);
+        return match?.[1];
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveScaleRoot(projectDir, scaleDir) {
+    return isAbsolute(scaleDir) ? scaleDir : resolve(projectDir, scaleDir);
+}
+//# sourceMappingURL=Language.js.map

package/dist/i18n/Language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Language.js","sourceRoot":"","sources":["../../src/i18n/Language.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAWrD,MAAM,UAAU,iBAAiB,CAAC,KAAc,EAAE,WAA0B,IAAI;IAC9E,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACpD,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAA;IACzB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IAC3E,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC3G,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAkC,EAAE;IACrE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAA;IACtC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QAAE,OAAO,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IACrG,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC5D,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC/E,OAAO,iBAAiB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;AAC5C,CAAC;AAED,SAAS,sBAAsB,CAAC,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,GAAG,QAAQ;IAC7E,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAA;IAC9E,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAA;IAC7C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAA;QACxF,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAkB,EAAE,QAAgB;IAC5D,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;AACxE,CAAC"}

package/dist/index.d.ts

@@ -34,6 +34,7 @@ export { SkillExecutor } from './skills/SkillExecutor.js';
 export type { ISkillExecutor } from './skills/SkillExecutor.js';
 export { SkillDiscovery } from './skills/SkillDiscovery.js';
 export * from './skills/SkillRepository.js';
+export * from './prompts/PromptOptimizer.js';
 export * from './prompts/VibeTemplateGallery.js';
 export * from './agents/LeadershipPresets.js';
 export { HookGeneratorEnhanced, HookDeployer } from './hooks/index.js';

package/dist/index.js

@@ -34,6 +34,7 @@ export { TriggerEngine } from './skills/TriggerEngine.js';
 export { SkillExecutor } from './skills/SkillExecutor.js';
 export { SkillDiscovery } from './skills/SkillDiscovery.js';
 export * from './skills/SkillRepository.js';
+export * from './prompts/PromptOptimizer.js';
 export * from './prompts/VibeTemplateGallery.js';
 export * from './agents/LeadershipPresets.js';
 // Hooks System (v0.7.0)

package/dist/index.js.map

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

package/dist/memory/MemoryProviders.js

@@ -346,11 +346,21 @@ function providerStatus(provider, routing) {
         };
     }
     if (provider.kind === 'gbrain' && commandExists('gbrain')) {
-        return {
-            ...providerStatusBase(provider, routing),
-            available: true,
-            reason: 'gbrain CLI is available for default graph-backed recall',
-        };
+        const health = gbrainCliHealth();
+        if (health.available) {
+            return {
+                ...providerStatusBase(provider, routing),
+                available: true,
+                reason: health.reason,
+            };
+        }
+        if (!provider.endpoint) {
+            return {
+                ...providerStatusBase(provider, routing),
+                available: false,
+                reason: health.reason,
+            };
+        }
     }
     if (!provider.endpoint) {
         return {
@@ -367,6 +377,26 @@ function providerStatus(provider, routing) {
         reason: `${provider.id} endpoint configured; recall is read-only unless policy enables writes`,
     };
 }
+function gbrainCliHealth() {
+    try {
+        runExternalCommandSync('gbrain', ['doctor', '--json'], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+            timeout: 10_000,
+        });
+        return { available: true, reason: 'gbrain doctor passed; graph-backed recall is available' };
+    }
+    catch (error) {
+        const err = error;
+        const output = `${String(err.stdout ?? '')}\n${String(err.stderr ?? err.message ?? '')}`;
+        return {
+            available: false,
+            reason: /no brain configured/i.test(output)
+                ? 'gbrain CLI is installed but no brain is configured; run `gbrain init --pglite` before autonomous recall'
+                : `gbrain CLI is installed but doctor failed: ${firstLine(output)}`,
+        };
+    }
+}
 function providerStatusBase(provider, routing) {
     return {
         id: provider.id,
@@ -447,6 +477,9 @@ function parseGbrainTextResults(stdout) {
         records.push(current);
     return records;
 }
+function firstLine(value) {
+    return value.split(/\r?\n/).map(line => line.trim()).find(Boolean) ?? 'unknown error';
+}
 function commandExists(command) {
     return externalCommandExists(command);
 }