blun-king-cli 9.1.624 → 9.1.625

package/bin/standard-tools-bootstrap.js

@@ -1,272 +1,277 @@
-'use strict';
-
-const { randomUUID } = require('node:crypto');
-const fs = require('node:fs');
-const path = require('node:path');
-
-const {
-  ensurePrivateDirectory,
-  securePrivateFile,
-  securePrivateTree,
-  writePrivateFile,
-} = require('./private-paths');
-
-function isObject(value) {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-function readCatalogue(packageRoot) {
-  const manifestPath = path.join(packageRoot, 'standard-tools', 'manifest.json');
-  const parsed = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
-  if (!isObject(parsed) || parsed.version !== 1 || !isObject(parsed.tools)) {
-    throw new Error(`Ungueltiger Standard-Tools-Katalog: ${manifestPath}`);
-  }
-  for (const [name, tool] of Object.entries(parsed.tools)) {
-    if (!isObject(tool) || !Array.isArray(tool.detectTokens)
-      || !tool.detectTokens.every((token) => typeof token === 'string' && token.length > 0)) {
-      throw new Error(`Ungueltiger Standard-Tool-Eintrag: ${name}`);
-    }
-    if (tool.platforms !== undefined
-      && (!Array.isArray(tool.platforms)
-        || !tool.platforms.every((platform) => platform === 'darwin' || platform === 'win32'))) {
-      throw new Error(`Ungueltige Standard-Tool-Plattform: ${name}`);
-    }
-    if (tool.owner === 'user-mcp'
-      && (!isObject(tool.config) || typeof tool.config.enabled !== 'boolean')) {
-      throw new Error(`Standard-Tool braucht einen Aktivierungszustand: ${name}`);
-    }
-  }
-  return parsed;
-}
-
-function readMcpDocument(configPath) {
-  if (!fs.existsSync(configPath)) return { mcpServers: {} };
-  let parsed;
-  try {
-    parsed = JSON.parse(fs.readFileSync(configPath, 'utf8'));
-  } catch (error) {
-    throw new Error(`Ungueltige MCP-Konfiguration (JSON): ${configPath}`, { cause: error });
-  }
-  if (!isObject(parsed) || (parsed.mcpServers !== undefined && !isObject(parsed.mcpServers))) {
-    throw new Error(`Ungueltige MCP-Konfiguration: ${configPath}`);
-  }
-  return parsed.mcpServers === undefined ? { ...parsed, mcpServers: {} } : parsed;
-}
-
-function serverSearchText(name, config) {
-  const values = [name];
-  if (isObject(config)) {
-    if (typeof config.command === 'string') values.push(config.command);
-    if (Array.isArray(config.args)) {
-      values.push(...config.args.filter((value) => typeof value === 'string'));
-    }
-    if (typeof config.url === 'string') values.push(config.url);
-  }
-  return values.join('\n').toLowerCase();
-}
-
-function hasEquivalentServer(servers, name, tool) {
-  if (Object.hasOwn(servers, name)) return true;
-  const tokens = tool.detectTokens.map((token) => token.toLowerCase());
-  return Object.entries(servers).some(([serverName, config]) => {
-    const searchText = serverSearchText(serverName, config);
-    return tokens.some((token) => searchText.includes(token));
-  });
-}
-
-function sameStringArray(left, right) {
-  return Array.isArray(left)
-    && Array.isArray(right)
-    && left.length === right.length
-    && left.every((value, index) => value === right[index]);
-}
-
-function recognizedBundledServer(name, current, expected) {
-  if (!isObject(current)) return false;
-  const exact = current.transport === expected.transport
-    && current.command === expected.command
-    && sameStringArray(current.args, expected.args);
-  if (exact) return true;
-  return name === 'context7'
-    && current.transport === 'stdio'
-    && current.command === 'npx'
-    && Array.isArray(current.args)
-    && current.args[0] === '-y'
-    && /^@upstash\/context7-mcp(?:@[^\s]+)?$/u.test(current.args[1] ?? '');
-}
-
-function migrateBundledTool(name, current, expected) {
-  if (!recognizedBundledServer(name, current, expected)) return false;
-  let changed = false;
-  if (current.enabled === false && name !== 'blun-language-guard') {
-    current.enabled = true;
-    changed = true;
-  }
-  if (name === 'agent-browser') {
-    if (current.startupTimeoutMs === 30_000) {
-      current.startupTimeoutMs = expected.startupTimeoutMs;
-      changed = true;
-    }
-    if (current.toolTimeoutMs === 60_000) {
-      current.toolTimeoutMs = expected.toolTimeoutMs;
-      changed = true;
-    }
-  }
-  if (name === 'blun-language-guard'
-    && (current.toolTimeoutMs === 30_000 || current.toolTimeoutMs === 60_000)) {
-    current.toolTimeoutMs = expected.toolTimeoutMs;
-    changed = true;
-  }
-  return changed;
-}
-
-function writeMcpDocument(configPath, document) {
-  const temporaryPath = path.join(
-    path.dirname(configPath),
-    `.${path.basename(configPath)}.${process.pid}.${randomUUID()}.tmp`,
-  );
-  try {
-    writePrivateFile(temporaryPath, `${JSON.stringify(document, null, 2)}\n`);
-    fs.renameSync(temporaryPath, configPath);
-  } catch (error) {
-    fs.rmSync(temporaryPath, { force: true });
-    throw error;
-  }
-}
-
-function bundledToolConfig(name, tool, { packageRoot, blunDir, platform, env }) {
-  const config = structuredClone(tool.config);
-  config.enabled = true;
-  if (name === 'blun-language-guard') {
-    config.command = platform === 'win32' ? 'python' : 'python3';
-    config.args = [
-      path.join(
-        packageRoot,
-        'standard-tools',
-        'language-guard',
-        'blun_language_guard.py',
-      ),
-      'serve',
-    ];
-    config.env = {
-      ...(isObject(config.env) ? config.env : {}),
-      PYTHONDONTWRITEBYTECODE: '1',
-      PYTHONUTF8: '1',
-      BLUN_LANGUAGE_GUARD_KEY_FILE: path.join(
-        blunDir,
-        'secrets',
-        'blun-language-guard-signing.key',
-      ),
-    };
-  }
-  if (name === 'windows-mcp' && platform === 'win32') {
-    const localUvx = typeof env.USERPROFILE === 'string'
-      ? path.join(env.USERPROFILE, '.local', 'bin', 'uvx.exe')
-      : undefined;
-    config.command = localUvx !== undefined && fs.existsSync(localUvx) ? localUvx : 'uvx';
-  }
-  return config;
-}
-
-function availableStandardToolNames({
-  packageRoot,
-  platform = process.platform,
-}) {
-  const catalogue = readCatalogue(packageRoot);
-  return Object.entries(catalogue.tools)
-    .filter(([, tool]) => tool.owner === 'user-mcp' || tool.owner === 'managed-plugin')
-    .filter(([, tool]) => !Array.isArray(tool.platforms) || tool.platforms.includes(platform))
-    .map(([name]) => name);
-}
-
-function seedStandardTools({
-  packageRoot,
-  blunDir,
-  names,
-  platform = process.platform,
-  env = process.env,
-}) {
-  const catalogue = readCatalogue(packageRoot);
-  if (!Array.isArray(names) || names.length === 0) {
-    throw new Error('Mindestens ein Standard-Tool muss ausdruecklich ausgewaehlt werden.');
-  }
-  const selectedNames = [...new Set(names)];
-  for (const name of selectedNames) {
-    const tool = catalogue.tools[name];
-    if (!isObject(tool) || tool.owner !== 'user-mcp') {
-      throw new Error(`Unbekanntes Standard-Tool: ${name}`);
-    }
-    if (Array.isArray(tool.platforms) && !tool.platforms.includes(platform)) {
-      throw new Error(`Standard-Tool ist auf dieser Plattform nicht verfuegbar: ${name}`);
-    }
-  }
-  const configPath = path.join(blunDir, 'mcp.json');
-  ensurePrivateDirectory(blunDir);
-  if (fs.existsSync(configPath)) securePrivateFile(configPath);
-  const document = readMcpDocument(configPath);
-  const servers = { ...document.mcpServers };
-  const added = [];
-  const updated = [];
-
-  for (const name of selectedNames) {
-    const tool = catalogue.tools[name];
-    const expected = bundledToolConfig(name, tool, {
-      packageRoot,
-      blunDir,
-      platform,
-      env,
-    });
-    if (Object.hasOwn(servers, name)) {
-      if (migrateBundledTool(name, servers[name], expected)) updated.push(name);
-      continue;
-    }
-    if (hasEquivalentServer(servers, name, tool)) continue;
-    servers[name] = expected;
-    added.push(name);
-  }
-
-  if (added.length > 0 || updated.length > 0) {
-    writeMcpDocument(configPath, { ...document, mcpServers: servers });
-  }
-  return { added, updated, configPath };
-}
-
-function seedStandardDesignSkill({ packageRoot, blunDir }) {
-  const sourcePath = path.join(
-    packageRoot,
-    'standard-skills',
-    'blun-app-design-system',
-  );
-  const sourceStat = fs.lstatSync(sourcePath);
-  if (!sourceStat.isDirectory() || sourceStat.isSymbolicLink()) {
-    throw new Error(`Ungueltiger BLUN-Standard-Skill: ${sourcePath}`);
-  }
-
-  const skillsDir = path.join(blunDir, 'skills');
-  ensurePrivateDirectory(skillsDir);
-  const destinationPath = path.join(skillsDir, 'blun-app-design-system');
-  const installed = !fs.existsSync(destinationPath);
-  if (!installed) {
-    const destinationStat = fs.lstatSync(destinationPath);
-    if (!destinationStat.isDirectory() || destinationStat.isSymbolicLink()) {
-      throw new Error(`Ungueltiges Ziel fuer BLUN-Standard-Skill: ${destinationPath}`);
-    }
-  } else {
-    ensurePrivateDirectory(destinationPath);
-  }
-
-  fs.cpSync(sourcePath, destinationPath, {
-    recursive: true,
-    force: true,
-    errorOnExist: false,
-  });
-  securePrivateTree(destinationPath);
-  return { installed, updated: !installed, destinationPath };
-}
-
-module.exports = {
-  availableStandardToolNames,
-  readCatalogue,
-  seedStandardDesignSkill,
-  seedStandardTools,
-};
+'use strict';
+
+const { randomUUID } = require('node:crypto');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const {
+  ensurePrivateDirectory,
+  securePrivateFile,
+  securePrivateTree,
+  writePrivateFile,
+} = require('./private-paths');
+
+function isObject(value) {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function readCatalogue(packageRoot) {
+  const manifestPath = path.join(packageRoot, 'standard-tools', 'manifest.json');
+  const parsed = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+  if (!isObject(parsed) || parsed.version !== 1 || !isObject(parsed.tools)) {
+    throw new Error(`Ungueltiger Standard-Tools-Katalog: ${manifestPath}`);
+  }
+  for (const [name, tool] of Object.entries(parsed.tools)) {
+    if (!isObject(tool) || !Array.isArray(tool.detectTokens)
+      || !tool.detectTokens.every((token) => typeof token === 'string' && token.length > 0)) {
+      throw new Error(`Ungueltiger Standard-Tool-Eintrag: ${name}`);
+    }
+    if (tool.platforms !== undefined
+      && (!Array.isArray(tool.platforms)
+        || !tool.platforms.every((platform) => platform === 'darwin' || platform === 'win32'))) {
+      throw new Error(`Ungueltige Standard-Tool-Plattform: ${name}`);
+    }
+    if (tool.owner === 'user-mcp'
+      && (!isObject(tool.config) || typeof tool.config.enabled !== 'boolean')) {
+      throw new Error(`Standard-Tool braucht einen Aktivierungszustand: ${name}`);
+    }
+  }
+  return parsed;
+}
+
+function readMcpDocument(configPath) {
+  if (!fs.existsSync(configPath)) return { mcpServers: {} };
+  let parsed;
+  try {
+    parsed = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+  } catch (error) {
+    throw new Error(`Ungueltige MCP-Konfiguration (JSON): ${configPath}`, { cause: error });
+  }
+  if (!isObject(parsed) || (parsed.mcpServers !== undefined && !isObject(parsed.mcpServers))) {
+    throw new Error(`Ungueltige MCP-Konfiguration: ${configPath}`);
+  }
+  return parsed.mcpServers === undefined ? { ...parsed, mcpServers: {} } : parsed;
+}
+
+function serverSearchText(name, config) {
+  const values = [name];
+  if (isObject(config)) {
+    if (typeof config.command === 'string') values.push(config.command);
+    if (Array.isArray(config.args)) {
+      values.push(...config.args.filter((value) => typeof value === 'string'));
+    }
+    if (typeof config.url === 'string') values.push(config.url);
+  }
+  return values.join('\n').toLowerCase();
+}
+
+function hasEquivalentServer(servers, name, tool) {
+  if (Object.hasOwn(servers, name)) return true;
+  const tokens = tool.detectTokens.map((token) => token.toLowerCase());
+  return Object.entries(servers).some(([serverName, config]) => {
+    const searchText = serverSearchText(serverName, config);
+    return tokens.some((token) => searchText.includes(token));
+  });
+}
+
+function sameStringArray(left, right) {
+  return Array.isArray(left)
+    && Array.isArray(right)
+    && left.length === right.length
+    && left.every((value, index) => value === right[index]);
+}
+
+function recognizedBundledServer(name, current, expected) {
+  if (!isObject(current)) return false;
+  const exact = current.transport === expected.transport
+    && current.command === expected.command
+    && sameStringArray(current.args, expected.args);
+  if (exact) return true;
+  return name === 'context7'
+    && current.transport === 'stdio'
+    && current.command === 'npx'
+    && Array.isArray(current.args)
+    && current.args[0] === '-y'
+    && /^@upstash\/context7-mcp(?:@[^\s]+)?$/u.test(current.args[1] ?? '');
+}
+
+function migrateBundledTool(name, current, expected) {
+  if (!recognizedBundledServer(name, current, expected)) return false;
+  let changed = false;
+  if (current.enabled === false && name !== 'blun-language-guard') {
+    current.enabled = true;
+    changed = true;
+  }
+  if (name === 'agent-browser') {
+    if (current.startupTimeoutMs === 30_000) {
+      current.startupTimeoutMs = expected.startupTimeoutMs;
+      changed = true;
+    }
+    if (current.toolTimeoutMs === 60_000) {
+      current.toolTimeoutMs = expected.toolTimeoutMs;
+      changed = true;
+    }
+  }
+  if (name === 'blun-language-guard'
+    && (current.toolTimeoutMs === 30_000 || current.toolTimeoutMs === 60_000)) {
+    current.toolTimeoutMs = expected.toolTimeoutMs;
+    changed = true;
+  }
+  if (name === 'blun-language-guard'
+    && (!isObject(current.env) || current.env.PYTHONDONTWRITEBYTECODE !== '1')) {
+    current.env = { ...(isObject(current.env) ? current.env : {}), PYTHONDONTWRITEBYTECODE: '1' };
+    changed = true;
+  }
+  return changed;
+}
+
+function writeMcpDocument(configPath, document) {
+  const temporaryPath = path.join(
+    path.dirname(configPath),
+    `.${path.basename(configPath)}.${process.pid}.${randomUUID()}.tmp`,
+  );
+  try {
+    writePrivateFile(temporaryPath, `${JSON.stringify(document, null, 2)}\n`);
+    fs.renameSync(temporaryPath, configPath);
+  } catch (error) {
+    fs.rmSync(temporaryPath, { force: true });
+    throw error;
+  }
+}
+
+function bundledToolConfig(name, tool, { packageRoot, blunDir, platform, env }) {
+  const config = structuredClone(tool.config);
+  config.enabled = true;
+  if (name === 'blun-language-guard') {
+    config.command = platform === 'win32' ? 'python' : 'python3';
+    config.args = [
+      path.join(
+        packageRoot,
+        'standard-tools',
+        'language-guard',
+        'blun_language_guard.py',
+      ),
+      'serve',
+    ];
+    config.env = {
+      ...(isObject(config.env) ? config.env : {}),
+      PYTHONDONTWRITEBYTECODE: '1',
+      PYTHONUTF8: '1',
+      BLUN_LANGUAGE_GUARD_KEY_FILE: path.join(
+        blunDir,
+        'secrets',
+        'blun-language-guard-signing.key',
+      ),
+    };
+  }
+  if (name === 'windows-mcp' && platform === 'win32') {
+    const localUvx = typeof env.USERPROFILE === 'string'
+      ? path.join(env.USERPROFILE, '.local', 'bin', 'uvx.exe')
+      : undefined;
+    config.command = localUvx !== undefined && fs.existsSync(localUvx) ? localUvx : 'uvx';
+  }
+  return config;
+}
+
+function availableStandardToolNames({
+  packageRoot,
+  platform = process.platform,
+}) {
+  const catalogue = readCatalogue(packageRoot);
+  return Object.entries(catalogue.tools)
+    .filter(([, tool]) => tool.owner === 'user-mcp' || tool.owner === 'managed-plugin')
+    .filter(([, tool]) => !Array.isArray(tool.platforms) || tool.platforms.includes(platform))
+    .map(([name]) => name);
+}
+
+function seedStandardTools({
+  packageRoot,
+  blunDir,
+  names,
+  platform = process.platform,
+  env = process.env,
+}) {
+  const catalogue = readCatalogue(packageRoot);
+  if (!Array.isArray(names) || names.length === 0) {
+    throw new Error('Mindestens ein Standard-Tool muss ausdruecklich ausgewaehlt werden.');
+  }
+  const selectedNames = [...new Set(names)];
+  for (const name of selectedNames) {
+    const tool = catalogue.tools[name];
+    if (!isObject(tool) || tool.owner !== 'user-mcp') {
+      throw new Error(`Unbekanntes Standard-Tool: ${name}`);
+    }
+    if (Array.isArray(tool.platforms) && !tool.platforms.includes(platform)) {
+      throw new Error(`Standard-Tool ist auf dieser Plattform nicht verfuegbar: ${name}`);
+    }
+  }
+  const configPath = path.join(blunDir, 'mcp.json');
+  ensurePrivateDirectory(blunDir);
+  if (fs.existsSync(configPath)) securePrivateFile(configPath);
+  const document = readMcpDocument(configPath);
+  const servers = { ...document.mcpServers };
+  const added = [];
+  const updated = [];
+
+  for (const name of selectedNames) {
+    const tool = catalogue.tools[name];
+    const expected = bundledToolConfig(name, tool, {
+      packageRoot,
+      blunDir,
+      platform,
+      env,
+    });
+    if (Object.hasOwn(servers, name)) {
+      if (migrateBundledTool(name, servers[name], expected)) updated.push(name);
+      continue;
+    }
+    if (hasEquivalentServer(servers, name, tool)) continue;
+    servers[name] = expected;
+    added.push(name);
+  }
+
+  if (added.length > 0 || updated.length > 0) {
+    writeMcpDocument(configPath, { ...document, mcpServers: servers });
+  }
+  return { added, updated, configPath };
+}
+
+function seedStandardDesignSkill({ packageRoot, blunDir }) {
+  const sourcePath = path.join(
+    packageRoot,
+    'standard-skills',
+    'blun-app-design-system',
+  );
+  const sourceStat = fs.lstatSync(sourcePath);
+  if (!sourceStat.isDirectory() || sourceStat.isSymbolicLink()) {
+    throw new Error(`Ungueltiger BLUN-Standard-Skill: ${sourcePath}`);
+  }
+
+  const skillsDir = path.join(blunDir, 'skills');
+  ensurePrivateDirectory(skillsDir);
+  const destinationPath = path.join(skillsDir, 'blun-app-design-system');
+  const installed = !fs.existsSync(destinationPath);
+  if (!installed) {
+    const destinationStat = fs.lstatSync(destinationPath);
+    if (!destinationStat.isDirectory() || destinationStat.isSymbolicLink()) {
+      throw new Error(`Ungueltiges Ziel fuer BLUN-Standard-Skill: ${destinationPath}`);
+    }
+  } else {
+    ensurePrivateDirectory(destinationPath);
+  }
+
+  fs.cpSync(sourcePath, destinationPath, {
+    recursive: true,
+    force: true,
+    errorOnExist: false,
+  });
+  securePrivateTree(destinationPath);
+  return { installed, updated: !installed, destinationPath };
+}
+
+module.exports = {
+  availableStandardToolNames,
+  readCatalogue,
+  seedStandardDesignSkill,
+  seedStandardTools,
+};