blun-king-cli 9.0.1 → 9.1.0

package/LIESMICH.txt

@@ -1,5 +1,5 @@
-BLUN King für macOS
-===================
+BLUN King für macOS und Windows
+===============================
 
 Voraussetzung
 -------------
@@ -7,15 +7,40 @@ Node.js 24.15 oder neuer muss installiert sein.
 
 Installation
 ------------
-Das bereitgestellte Paket global installieren:
+Die geprüfte Version exakt global installieren:
 
-  npm install -g blun-king-cli
+  npm install -g blun-king-cli@9.1.0
 
 Start
 -----
 
-  blun    Lokale Konsole ohne Telegram
-  king    Dieselbe Konsole mit Telegram
+  blun    Dieselbe CLI, ohne Telegram automatisch anzubinden
+  king    Dieselbe CLI, mit automatisch angebundenem Telegram-Kanal
+
+Beide Startbefehle verwenden dieselbe Version, dasselbe Konto, dasselbe Modell
+und dieselben Befehle.
+
+Nachweisbare Arbeitsabläufe
+---------------------------
+
+  blun proof       Prüfergebnisse und Artefakte mit SHA-256 belegen
+  blun brief       Einen versionierten Projektauftrag anlegen
+  blun handoff     Eine Sitzung zwischen CLI, Desktop und Web übergeben
+  blun replay      Einen bereinigten Arbeitsverlauf erzeugen
+  blun guard       Belegintegrität und aktuelle Artefakte prüfen
+  blun demo        Eine bereinigte statische Projektdemo erzeugen
+  blun workspace   Isolierte Git-Arbeitsbereiche verwalten
+
+Alle Befehle funktionieren identisch mit `king`.
+
+Aktualisieren
+-------------
+
+  blun update
+
+`king update` und `upgrade` sind gleichwertig. Der Updater bleibt im installierten
+Stable- oder Next-Kanal, verhindert Rückstufungen und installiert nur eine zuvor
+aufgelöste exakte Paketversion.
 
 Beim ersten Start in der Konsole /login eingeben. Der Browser öffnet den
 BLUN-OAuth-Login.

package/README.md

@@ -3,10 +3,19 @@
 Dieses Verzeichnis ist das Gerüst des öffentlichen npm-Pakets `blun-king-cli`
 (Erstveröffentlichung 8.0.0, 06.07.2026, Account `blunking`).
 
+## Installation
+
+Voraussetzung ist Node.js 24.15 oder neuer. Die geprüfte Version wird exakt
+installiert:
+
+```powershell
+npm install -g blun-king-cli@9.1.0
+```
+
 ## Reproduzierbares Staging und Packen
 
 Der Schritt baut nichts, installiert nichts und veröffentlicht nichts. Vorher müssen
-`apps/blun-king/dist/main.mjs`, `dist-web`, die Darwin-Natives sowie
+`apps/blun-king/dist/main.mjs`, `dist-web`, die Darwin- und Windows-Natives sowie
 `plugins/telegram/dist` bereits frisch gebaut sein.
 
 Das Staging landet standardmäßig
@@ -20,12 +29,34 @@ kopiert nur die Paket-Hülle, `blun.mjs`, `dist-web`, `native`, Telegrams
 
 ## Startmodi
 
-`blun` startet die lokale Konsole ohne Telegram. `king` startet dieselbe
-Konsole mit Telegram-Kanal, Pairing-Befehl und Telegram-Werkzeugen. Der
-Unterschied gilt nur für den laufenden Prozess; die gespeicherte
+`blun` startet die lokale Konsole, ohne Telegram automatisch anzubinden. `king`
+startet dieselbe Konsole und bindet den eingerichteten Telegram-Kanal automatisch
+an. Version, Konto, Modell und Befehle sind ansonsten identisch. Der Unterschied
+gilt nur für den laufenden Prozess; die gespeicherte
 Plugin-Konfiguration wird nicht umgeschrieben.
 
 Beim ersten Start werden das Telegram-Plugin und die mitgelieferten Skills
 eingerichtet. Die Anmeldung erfolgt anschließend in der
 Konsole mit `/login` über den BLUN-OAuth-Server. Das Paket erzeugt keine
 statische Anbieter- oder API-Key-Konfiguration.
+
+## Nachweisbare Arbeitsabläufe
+
+Version 9.1.0 enthält sieben zusätzliche, getrennt nutzbare Befehlsgruppen:
+
+- `proof` belegt Prüfungen und Artefakte mit SHA-256.
+- `brief` erstellt einen versionierten Projektauftrag.
+- `handoff` übergibt eine Sitzung zwischen CLI, Desktop und Web.
+- `replay` erzeugt einen bereinigten Arbeitsverlauf.
+- `guard` prüft Belegintegrität und aktuelle Artefakte.
+- `demo` erzeugt eine bereinigte statische Projektdemo.
+- `workspace` verwaltet isolierte Git-Arbeitsbereiche.
+
+Sie stehen unter `blun` und `king` identisch zur Verfügung.
+
+## Aktualisieren
+
+`blun update`, `king update` und die jeweilige Variante `upgrade` verwenden
+denselben abgesicherten Updater. Er bleibt im installierten Stable- oder
+Next-Kanal, verhindert Rückstufungen und übergibt npm ausschließlich eine zuvor
+aufgelöste exakte Paketversion.

package/bin/launcher-mode.js

@@ -5,7 +5,14 @@ const LAUNCHER_MODES = Object.freeze({
   KING: 'king',
 });
 
-const NPM_PACKAGE_UPDATE_COMMAND = 'npm install -g blun-king-cli@latest';
+const LAUNCHER_HELP_TEXT = [
+  '',
+  'Launchers:',
+  '  blun  Starts the CLI without automatically attaching Telegram.',
+  '  king  Starts the same CLI and automatically attaches the configured Telegram channel.',
+  '  Both use the same version, account, model, and commands.',
+  '',
+].join('\n');
 
 function launcherModeFromArgv(argv) {
   const entry = argv[1] || '';
@@ -30,10 +37,14 @@ function isNpmPackageUpdateRequest(args) {
   return command === 'update' || command === 'upgrade';
 }
 
+function launcherHelpText() {
+  return LAUNCHER_HELP_TEXT;
+}
+
 module.exports = {
   LAUNCHER_MODES,
-  NPM_PACKAGE_UPDATE_COMMAND,
   createLauncherEnvironment,
   isNpmPackageUpdateRequest,
+  launcherHelpText,
   launcherModeFromArgv,
 };

package/bin/launcher-runtime.js

@@ -10,28 +10,69 @@ const os = require('node:os');
 const { spawn } = require('node:child_process');
 const {
   LAUNCHER_MODES,
-  NPM_PACKAGE_UPDATE_COMMAND,
   createLauncherEnvironment,
   isNpmPackageUpdateRequest,
+  launcherHelpText,
   launcherModeFromArgv,
 } = require('./launcher-mode');
 const { installManagedTelegramPlugin } = require('./plugin-bootstrap');
 const { CORE_LOADED_MESSAGE } = require('./core-bootstrap');
 const { tryAcquireUpdateLease } = require('./update-lease');
-const { runUpdateNotice } = require('./update-notice');
+const { runExplicitUpdate, runUpdateNotice } = require('./update-notice');
 const {
   ensurePrivateDirectory,
   securePrivateFile,
+  securePrivateTree,
   writePrivateFile,
 } = require('./private-paths');
 
 const PKG = path.resolve(__dirname, '..');
-const HOME = os.homedir();
-const configuredBlunHome = String(process.env.BLUN_HOME || '').trim();
-const BLUN = configuredBlunHome ? path.resolve(configuredBlunHome) : path.join(HOME, '.blun');
 const ARGS = process.argv.slice(2);
 const CORE_LOAD_TIMEOUT_MS = 30_000;
 
+function normalizeWindowsPath(value) {
+  return path.win32.normalize(value).replace(/\\+$/u, '').toLowerCase();
+}
+
+function resolveLauncherPrivatePaths(options = {}) {
+  const env = options.env || process.env;
+  const platform = options.platform || process.platform;
+  const configuredHome = String(env.BLUN_HOME || '').trim();
+  if (platform !== 'win32') {
+    const userHome = (options.homedir || os.homedir)();
+    return {
+      blunHome: configuredHome ? path.resolve(configuredHome) : path.join(userHome, '.blun'),
+      userHome,
+    };
+  }
+
+  const fsImpl = options.fsImpl || fs;
+  const userInfo = (options.userInfo || os.userInfo)();
+  const reportedHome = String(userInfo?.homedir || '').trim();
+  if (!path.win32.isAbsolute(reportedHome) || reportedHome.startsWith('\\\\')) {
+    throw new Error('Das lokale Windows-Benutzerprofil konnte nicht sicher bestimmt werden.');
+  }
+  const resolvedHome = path.win32.resolve(reportedHome);
+  const stat = fsImpl.lstatSync(resolvedHome);
+  if (!stat.isDirectory() || stat.isSymbolicLink()) {
+    throw new Error('Das lokale Windows-Benutzerprofil ist kein vertrauenswuerdiges Verzeichnis.');
+  }
+  const realpath = fsImpl.realpathSync.native || fsImpl.realpathSync;
+  const userHome = path.win32.normalize(realpath(resolvedHome));
+  const volumeRoot = path.win32.parse(userHome).root;
+  if (!/^[A-Za-z]:\\$/u.test(volumeRoot)
+    || normalizeWindowsPath(userHome) !== normalizeWindowsPath(resolvedHome)) {
+    throw new Error('Das lokale Windows-Benutzerprofil ist kein kanonischer lokaler Pfad.');
+  }
+
+  const blunHome = path.win32.join(userHome, '.blun');
+  if (configuredHome
+    && normalizeWindowsPath(path.win32.resolve(configuredHome)) !== normalizeWindowsPath(blunHome)) {
+    throw new Error(`BLUN_HOME muss unter Windows exakt im Windows-Benutzerprofil liegen: ${blunHome}`);
+  }
+  return { blunHome, userHome };
+}
+
 function readPackageVersion() {
   const { version } = JSON.parse(fs.readFileSync(path.join(PKG, 'package.json'), 'utf8'));
   if (typeof version !== 'string' || version.length === 0) {
@@ -116,11 +157,19 @@ function exitCodeForChild(result, loaded) {
 }
 
 async function runLauncher(options = {}) {
+  const callerCwd = process.cwd();
   const mode = options.mode || launcherModeFromArgv(process.argv);
+  const explicitUpdateRequest = isNpmPackageUpdateRequest(ARGS);
   const noticeResult = options.noticeLease
     ? { acquired: true, lease: options.noticeLease }
     : await tryAcquireUpdateLease({ packageRoot: PKG, role: 'notice' });
-  if (!noticeResult.acquired) return;
+  if (!noticeResult.acquired) {
+    if (explicitUpdateRequest) {
+      process.stderr.write('Das Update konnte nicht verifiziert werden.\n');
+      process.exitCode = 1;
+    }
+    return;
+  }
   const noticeLease = noticeResult.lease;
   let noticeReleased = false;
   const releaseNotice = async () => {
@@ -131,7 +180,13 @@ async function runLauncher(options = {}) {
 
   try {
     const installProbe = await tryAcquireUpdateLease({ packageRoot: PKG, role: 'install' });
-    if (!installProbe.acquired) return;
+    if (!installProbe.acquired) {
+      if (explicitUpdateRequest) {
+        process.stderr.write('Das Update konnte nicht verifiziert werden.\n');
+        process.exitCode = 1;
+      }
+      return;
+    }
     await installProbe.lease.release();
 
     if (ARGS.some((arg) => arg === '--version' || arg === '-V')) {
@@ -139,11 +194,37 @@ async function runLauncher(options = {}) {
       return;
     }
 
-    if (isNpmPackageUpdateRequest(ARGS)) {
-      process.stdout.write(`${NPM_PACKAGE_UPDATE_COMMAND}\n`);
+    if (explicitUpdateRequest) {
+      const privatePaths = resolveLauncherPrivatePaths();
+      const result = await runExplicitUpdate({
+        currentVersion: readPackageVersion(),
+        env: process.env,
+        stdin: process.stdin,
+        stdout: process.stdout,
+        stderr: process.stderr,
+        blunDir: privatePaths.blunHome,
+        packageRoot: PKG,
+        noticeLease,
+        request: ARGS[0],
+      });
+      if (result.kind === 'failed') process.exitCode = result.exitCode || 1;
+      return;
+    }
+
+    if (ARGS.some((arg) => arg === '--help' || arg === '-h')) {
+      process.stdout.write(launcherHelpText());
+      const env = createLauncherEnvironment(process.env, mode, readPackageVersion());
+      const informationalEnv = { ...process.env };
+      delete informationalEnv.BLUN_HOME;
+      env.BLUN_HOME = resolveLauncherPrivatePaths({ env: informationalEnv }).blunHome;
+      process.exitCode = await superviseProtectedCore(ARGS, env, callerCwd, releaseNotice);
       return;
     }
 
+    const privatePaths = resolveLauncherPrivatePaths();
+    const blunDir = privatePaths.blunHome;
+    ensurePrivateDirectory(blunDir);
+
     // --- 1. Oeffentlicher npm-Update-Dialog. -------------------------------
     const updateResult = await runUpdateNotice({
       currentVersion: readPackageVersion(),
@@ -152,32 +233,25 @@ async function runLauncher(options = {}) {
       stdin: process.stdin,
       stdout: process.stdout,
       stderr: process.stderr,
-      blunDir: BLUN,
+      blunDir,
       packageRoot: PKG,
       noticeLease,
     });
     if (updateResult.kind === 'installed' || updateResult.kind === 'update_in_progress') return;
 
-    if (ARGS.some((arg) => arg === '--help' || arg === '-h')) {
-      const env = createLauncherEnvironment(process.env, mode, readPackageVersion());
-      env.BLUN_HOME = BLUN;
-      process.exitCode = await superviseProtectedCore(ARGS, env, process.cwd(), releaseNotice);
-      return;
-    }
-
-    ensurePrivateDirectory(BLUN);
-
   // --- 2. Bestehende Konfiguration absichern -------------------------------
   // Ein frischer Start bleibt absichtlich ohne statischen Anbieter. /login
   // provisioniert King ueber den BLUN-OAuth-Server.
-    const cfgFile = path.join(BLUN, 'config.toml');
+    const cfgFile = path.join(blunDir, 'config.toml');
     if (fs.existsSync(cfgFile)) securePrivateFile(cfgFile);
 
   // --- 3. Telegram-Plugin + Token-Vorlage (nur King) -----------------------
     if (mode === LAUNCHER_MODES.KING) {
-      installManagedTelegramPlugin({ packageRoot: PKG, blunDir: BLUN });
-      const channelDir = path.join(BLUN, 'channels', 'telegram');
-      fs.mkdirSync(channelDir, { recursive: true });
+      installManagedTelegramPlugin({ packageRoot: PKG, blunDir });
+      const channelsDir = path.join(blunDir, 'channels');
+      const channelDir = path.join(channelsDir, 'telegram');
+      ensurePrivateDirectory(channelsDir);
+      ensurePrivateDirectory(channelDir);
       const envFile = path.join(channelDir, '.env');
       if (!fs.existsSync(envFile)) {
         writePrivateFile(envFile, 'BLUN_TELEGRAM_BOT_TOKEN=HIER_DEIN_BOT_TOKEN_EINFUEGEN\n');
@@ -189,9 +263,10 @@ async function runLauncher(options = {}) {
   // --- 3b. Built-in-Skills installieren (fehlende ergaenzen, nie
   //         vorhandene ueberschreiben — User-Anpassungen bleiben) -----------
     const skillsSrc = path.join(PKG, 'skills');
-    const skillsDst = path.join(BLUN, 'skills');
+    const skillsDst = path.join(blunDir, 'skills');
     if (fs.existsSync(skillsSrc)) {
-      fs.mkdirSync(skillsDst, { recursive: true });
+      if (fs.existsSync(skillsDst)) securePrivateTree(skillsDst);
+      else ensurePrivateDirectory(skillsDst);
       for (const entry of fs.readdirSync(skillsSrc)) {
         const dst = path.join(skillsDst, entry);
         if (!fs.existsSync(dst)) {
@@ -202,15 +277,12 @@ async function runLauncher(options = {}) {
 
     // --- 4. Start -----------------------------------------------------------
     const env = createLauncherEnvironment(process.env, mode, readPackageVersion());
-    env.BLUN_HOME = BLUN;
+    env.BLUN_HOME = blunDir;
     env.BLUN_MODEL_MAX_COMPLETION_TOKENS = env.BLUN_MODEL_MAX_COMPLETION_TOKENS || '32768';
-    const workspace = path.join(HOME, 'BLUN-Workspace');
-    fs.mkdirSync(workspace, { recursive: true });
-
     process.exitCode = await superviseProtectedCore(
       ['--yolo', ...ARGS],
       env,
-      workspace,
+      callerCwd,
       releaseNotice,
     );
   } finally {
@@ -218,4 +290,4 @@ async function runLauncher(options = {}) {
   }
 }
 
-module.exports = { runLauncher };
+module.exports = { resolveLauncherPrivatePaths, runLauncher };

package/bin/plugin-bootstrap.js

@@ -4,7 +4,11 @@ const { randomUUID } = require('node:crypto');
 const fs = require('node:fs');
 const path = require('node:path');
 
-const { ensurePrivateDirectory, writePrivateFile } = require('./private-paths');
+const {
+  ensurePrivateDirectory,
+  securePrivateFile,
+  writePrivateFile,
+} = require('./private-paths');
 
 function isObject(value) {
   return typeof value === 'object' && value !== null && !Array.isArray(value);
@@ -81,10 +85,10 @@ function installManagedTelegramPlugin({ packageRoot, blunDir, now = new Date().t
   const pluginRoot = path.join(managedDir, 'telegram');
   const installedFile = path.join(pluginsDir, 'installed.json');
 
+  ensurePrivateDirectory(pluginsDir);
+  if (fs.existsSync(installedFile)) securePrivateFile(installedFile);
   const installed = readInstalledPlugins(installedFile);
   const updatedInstalled = updatedInstalledPlugins(installed, pluginRoot, now);
-
-  ensurePrivateDirectory(pluginsDir);
   ensurePrivateDirectory(managedDir);
   const nonce = `${process.pid}-${randomUUID()}`;
   const stagingRoot = path.join(managedDir, `.telegram-${nonce}.tmp`);
@@ -92,8 +96,11 @@ function installManagedTelegramPlugin({ packageRoot, blunDir, now = new Date().t
   let hadPreviousPlugin = false;
   let installedNewPlugin = false;
   try {
+    if (fs.existsSync(pluginRoot)) {
+      ensurePrivateDirectory(pluginRoot);
+      hadPreviousPlugin = true;
+    }
     fs.cpSync(sourceRoot, stagingRoot, { recursive: true, force: true });
-    hadPreviousPlugin = fs.existsSync(pluginRoot);
     if (hadPreviousPlugin) fs.renameSync(pluginRoot, backupRoot);
     try {
       fs.renameSync(stagingRoot, pluginRoot);