@pixelbyte-software/pixcode 1.41.3 → 1.41.5

package/dist-server/server/services/runtime-manager.js

@@ -0,0 +1,312 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { buildCliSpawnEnv, findExecutableOnPath, resolveNpmCommand } from './install-jobs.js';
+import { getManagedRuntimeStatus } from './managed-runtimes.js';
+const RUNTIME_CHECK_TIMEOUT_MS = 1800;
+export const RUNTIME_DEFINITIONS = {
+    node: {
+        id: 'node',
+        name: 'Node.js',
+        commands: ['node'],
+        versionArgs: ['--version'],
+        installAction: 'Install Node.js 22 or newer and ensure node is available on PATH.',
+    },
+    npm: {
+        id: 'npm',
+        name: 'Node package runner',
+        commands: ['npm'],
+        versionArgs: ['--version'],
+        managedRuntimeId: 'npm',
+        installAction: 'Install Node.js/npm or let Pixcode prepare its managed Node package runner.',
+    },
+    php: {
+        id: 'php',
+        name: 'PHP',
+        commands: ['php'],
+        versionArgs: ['--version'],
+        managedRuntimeId: 'frankenphp',
+        installAction: 'Install PHP or let Pixcode prepare its managed PHP runtime.',
+    },
+    python: {
+        id: 'python',
+        name: 'Python',
+        commands: process.platform === 'win32' ? ['python', 'py'] : ['python3', 'python'],
+        versionArgs: ['--version'],
+        installAction: 'Install Python 3 and ensure python3 or python is available on PATH.',
+    },
+    go: {
+        id: 'go',
+        name: 'Go',
+        commands: ['go'],
+        versionArgs: ['version'],
+        installAction: 'Install Go and ensure go is available on PATH.',
+    },
+    java: {
+        id: 'java',
+        name: 'Java',
+        commands: ['java'],
+        versionArgs: ['-version'],
+        installAction: 'Install a JDK and ensure java is available on PATH.',
+    },
+    rust: {
+        id: 'rust',
+        name: 'Rust',
+        commands: ['cargo', 'rustc'],
+        versionArgs: ['--version'],
+        installAction: 'Install Rust with rustup and ensure cargo is available on PATH.',
+    },
+};
+function runtimeDiagnostic(definition, status, detail) {
+    if (status === 'available') {
+        return {
+            message: `${definition.name} is available.`,
+            action: 'No action needed.',
+        };
+    }
+    if (status === 'too_old') {
+        return {
+            message: `${definition.name} is installed but does not meet the required version.`,
+            action: definition.installAction,
+            detail,
+        };
+    }
+    if (status === 'error') {
+        return {
+            message: `${definition.name} was found but could not be started.`,
+            action: definition.installAction,
+            detail,
+        };
+    }
+    return {
+        message: `${definition.name} is not available on this machine.`,
+        action: definition.installAction,
+        detail,
+    };
+}
+function normalizeVersion(output) {
+    const match = String(output || '').match(/(?:v|version\s*)?(\d+\.\d+\.\d+)/i);
+    return match?.[1];
+}
+function runVersion(command, args, env) {
+    return new Promise((resolve) => {
+        let output = '';
+        let settled = false;
+        const child = spawn(command, args, {
+            env,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(result);
+        };
+        const timer = setTimeout(() => {
+            try {
+                child.kill();
+            }
+            catch {
+                // Ignore a raced process exit.
+            }
+            finish({ ok: false, error: `${command} version check timed out.` });
+        }, RUNTIME_CHECK_TIMEOUT_MS);
+        child.stdout.on('data', (chunk) => {
+            output += chunk.toString();
+        });
+        child.stderr.on('data', (chunk) => {
+            output += chunk.toString();
+        });
+        child.on('error', (error) => {
+            finish({ ok: false, error: error.message });
+        });
+        child.on('exit', (code) => {
+            finish({
+                ok: code === 0,
+                output,
+                error: code === 0 ? undefined : `${command} exited with code ${code}.`,
+            });
+        });
+    });
+}
+function findExecutableOnDeclaredPath(name, env = process.env) {
+    const separator = process.platform === 'win32' ? ';' : ':';
+    const extensions = process.platform === 'win32'
+        ? ['.cmd', '.exe', '.bat', '.ps1', '']
+        : [''];
+    const pathDirs = (env.PATH || env.Path || '').split(separator).filter(Boolean);
+    for (const dir of pathDirs) {
+        for (const extension of extensions) {
+            const candidate = path.join(dir, `${name}${extension}`);
+            try {
+                if (candidate && fs.existsSync(candidate))
+                    return candidate;
+            }
+            catch {
+                // Ignore invalid PATH entries.
+            }
+        }
+    }
+    return null;
+}
+function commandPathForRuntime(id, definition, env, strictPath = false) {
+    const spawnEnv = buildCliSpawnEnv(env);
+    if (id === 'node')
+        return process.execPath;
+    if (id === 'npm')
+        return resolveNpmCommand(spawnEnv);
+    for (const command of definition.commands) {
+        const executable = strictPath
+            ? findExecutableOnDeclaredPath(command, env)
+            : findExecutableOnPath(command, spawnEnv);
+        if (executable)
+            return executable;
+    }
+    return null;
+}
+async function discoverSystemRuntime(id, definition, env, options = {}) {
+    const executable = commandPathForRuntime(id, definition, env, Boolean(options.strictPath));
+    if (!executable) {
+        return {
+            id,
+            name: definition.name,
+            status: 'missing',
+            source: 'none',
+            installStatus: 'missing',
+            diagnostic: runtimeDiagnostic(definition, 'missing'),
+        };
+    }
+    const versionResult = await runVersion(executable, definition.versionArgs, env);
+    if (!versionResult.ok) {
+        return {
+            id,
+            name: definition.name,
+            status: 'error',
+            source: 'system',
+            path: executable,
+            installStatus: 'installed',
+            diagnostic: runtimeDiagnostic(definition, 'error', versionResult.error),
+        };
+    }
+    return {
+        id,
+        name: definition.name,
+        status: 'available',
+        source: 'system',
+        path: executable,
+        version: normalizeVersion(versionResult.output),
+        installStatus: 'installed',
+        diagnostic: runtimeDiagnostic(definition, 'available'),
+    };
+}
+async function discoverManagedRuntime(id, definition, env, preferManaged) {
+    if (!definition.managedRuntimeId || !preferManaged)
+        return null;
+    const managedRuntime = await getManagedRuntimeStatus(definition.managedRuntimeId, {
+        env,
+        preferManaged: true,
+    });
+    const available = managedRuntime.status === 'installed' || managedRuntime.status === 'system';
+    return {
+        id,
+        name: definition.name,
+        status: available ? 'available' : 'missing',
+        source: 'managed',
+        path: managedRuntime.executablePath,
+        version: managedRuntime.version,
+        installStatus: managedRuntime.status,
+        installable: managedRuntime.installable,
+        managedRuntime,
+        diagnostic: runtimeDiagnostic(definition, available ? 'available' : 'missing', managedRuntime.reason),
+    };
+}
+export async function discoverRuntime(id, options = {}) {
+    const definition = RUNTIME_DEFINITIONS[id];
+    if (!definition) {
+        return {
+            id,
+            name: id,
+            status: 'unsupported',
+            source: 'none',
+            installStatus: 'unsupported',
+            diagnostic: {
+                message: `${id} is not registered in the Pixcode runtime manager.`,
+                action: 'Add a runtime definition before using this stack.',
+            },
+        };
+    }
+    const env = options.env || process.env;
+    const managed = await discoverManagedRuntime(id, definition, env, Boolean(options.preferManaged));
+    if (managed)
+        return managed;
+    return discoverSystemRuntime(id, definition, env, options);
+}
+function isPackageManagerCommand(command) {
+    return command === 'npm' || command === 'pnpm' || command === 'yarn' || command === 'bun';
+}
+function runtimeIdForLiveViewCommand(command) {
+    if (!command)
+        return null;
+    if (isPackageManagerCommand(command.command) || command.packageManager)
+        return 'node';
+    if (command.framework === 'PHP' || command.command === 'php')
+        return 'php';
+    if (command.framework === 'Django' || command.framework === 'FastAPI' || command.framework === 'Flask')
+        return 'python';
+    if (command.framework === 'Go' || command.command === 'go')
+        return 'go';
+    if (command.framework === 'Rust' || command.command === 'cargo')
+        return 'rust';
+    if (command.framework === 'Java' || command.command === 'java')
+        return 'java';
+    return null;
+}
+export async function resolveLiveViewRuntime(command, options = {}) {
+    const env = options.env || process.env;
+    const runtimeId = runtimeIdForLiveViewCommand(command);
+    if (!runtimeId) {
+        return {
+            available: true,
+            reason: 'No dedicated runtime check is required for this Live View command.',
+        };
+    }
+    if (runtimeId === 'node') {
+        const runtime = await discoverRuntime('node', { env });
+        const managedRuntime = await getManagedRuntimeStatus('npm', {
+            env,
+            preferManaged: Boolean(options.preferManaged),
+        });
+        return {
+            available: true,
+            runtime,
+            managedRuntime,
+            reason: managedRuntime.reason || 'Pixcode will run this project with its managed Node package runner.',
+        };
+    }
+    if (runtimeId === 'php') {
+        const runtime = await discoverRuntime('php', {
+            env,
+            preferManaged: Boolean(options.preferManaged),
+        });
+        return {
+            available: Boolean(runtime.managedRuntime?.installable) || runtime.status === 'available',
+            runtime,
+            managedRuntime: runtime.managedRuntime,
+            reason: runtime.managedRuntime?.reason || runtime.diagnostic.message,
+        };
+    }
+    const runtime = await discoverRuntime(runtimeId, { env });
+    return {
+        available: runtime.status === 'available',
+        runtime,
+        reason: runtime.status === 'available' ? runtime.diagnostic.message : runtime.diagnostic.action,
+    };
+}
+export const runtimeManager = {
+    definitions: RUNTIME_DEFINITIONS,
+    discover: discoverRuntime,
+    resolveLiveViewRuntime,
+};
+//# sourceMappingURL=runtime-manager.js.map

package/dist-server/server/services/runtime-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-manager.js","sourceRoot":"","sources":["../../../server/services/runtime-manager.js"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixelbyte-software/pixcode",
-  "version": "1.41.3",
+  "version": "1.41.5",
   "description": "Self-hosted AI coding agent control room for Claude Code, Cursor CLI, OpenAI Codex, Gemini CLI, Qwen Code, and OpenCode with chat, files, shell, Git, orchestration, API keys, Telegram, MCP, plugins, themes, and desktop/server deployment.",
   "type": "module",
   "main": "dist-server/server/index.js",
@@ -9,6 +9,7 @@
   },
   "files": [
     "server/",
+    "!server/database/auth.json",
     "shared/",
     "dist/",
     "dist-server/",

package/scripts/smoke/live-view-diagnostics.mjs

@@ -39,8 +39,8 @@ assert.match(payload.errorDetail, /spawn php ENOENT/);
 assert.ok(payload.diagnostics.command.includes('php -S'), 'Payload should include the attempted PHP command.');
 assert.ok(payload.diagnostics.logs.some((line) => line.includes('spawn php ENOENT')), 'Payload should include process logs.');
 assert.ok(
-  payload.suggestions.some((suggestion) => /php/i.test(suggestion) && /PATH/i.test(suggestion)),
-  'PHP failures should suggest checking the php executable in PATH.',
+  payload.suggestions.some((suggestion) => /php/i.test(suggestion) && /local PHP runtime/i.test(suggestion)),
+  'PHP failures should explain that Pixcode can prepare a local PHP runtime.',
 );
 assert.notEqual(payload.error, 'Live View session not found.', 'Existing failed sessions must not be hidden as missing sessions.');
 

package/scripts/smoke/live-view-environment.mjs

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+
+import assert from 'node:assert/strict';
+import { mkdir, mkdtemp, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
+const read = async (relativePath) => {
+  const { readFile } = await import('node:fs/promises');
+  return readFile(path.join(repoRoot, relativePath), 'utf8');
+};
+
+const {
+  buildLiveViewEnvironment,
+  detectLiveViewTarget,
+  getLiveViewState,
+} = await import('../../server/services/live-view.js');
+
+assert.equal(typeof buildLiveViewEnvironment, 'function', 'Live View should expose a preview environment contract builder.');
+
+const workspace = await mkdtemp(path.join(tmpdir(), 'pixcode-live-view-env-'));
+const viteProject = path.join(workspace, 'vite');
+const staticProject = path.join(workspace, 'static');
+
+await mkdir(viteProject, { recursive: true });
+await writeFile(path.join(viteProject, 'package.json'), JSON.stringify({
+  scripts: { dev: 'vite --host 0.0.0.0' },
+  dependencies: { vite: '^7.0.0' },
+}, null, 2));
+
+await mkdir(staticProject, { recursive: true });
+await writeFile(path.join(staticProject, 'index.html'), '<main>static preview</main>');
+
+const viteTarget = await detectLiveViewTarget(viteProject);
+const readyEnvironment = buildLiveViewEnvironment({ target: viteTarget, session: null });
+assert.equal(readyEnvironment.mode, 'local-process', 'Process targets should use a local-process preview environment.');
+assert.equal(readyEnvironment.status, 'ready', 'Detected process targets should be ready before launch.');
+assert.equal(readyEnvironment.framework, 'Vite', 'The environment should expose detected framework information.');
+assert.equal(readyEnvironment.command.id, 'npm-dev-vite', 'The environment should expose the selected runner command.');
+assert.equal(readyEnvironment.command.custom, false, 'Detected commands should not be marked as custom.');
+assert.equal(readyEnvironment.diagnostics.runnerKind, 'process', 'Diagnostics should identify process runners.');
+assert.equal(readyEnvironment.diagnostics.targetAvailable, true, 'Diagnostics should expose target availability.');
+assert.ok(Array.isArray(readyEnvironment.logs), 'The environment should always expose logs.');
+
+const customEnvironment = buildLiveViewEnvironment({
+  target: viteTarget,
+  session: {
+    status: 'starting',
+    kind: 'process',
+    framework: 'Custom',
+    label: 'Custom command',
+    command: {
+      id: 'custom',
+      label: 'Custom command',
+      displayCommand: 'npm run preview -- --host 127.0.0.1',
+      custom: true,
+    },
+    runtime: null,
+    managedRuntime: null,
+    port: 4173,
+    upstreamUrl: 'http://127.0.0.1:4173',
+    sharePath: '/live/custom-smoke/',
+    error: null,
+    log: ['$ npm run preview -- --host 127.0.0.1', 'Local: http://127.0.0.1:4173/'],
+  },
+});
+assert.equal(customEnvironment.status, 'starting', 'The environment should track the active session status.');
+assert.equal(customEnvironment.command.custom, true, 'Custom commands should be visible in the environment model.');
+assert.equal(customEnvironment.port, 4173, 'The environment should expose the active preview port.');
+assert.equal(customEnvironment.upstreamUrl, 'http://127.0.0.1:4173', 'The environment should expose the active upstream URL.');
+assert.deepEqual(customEnvironment.logs, customEnvironment.logs.slice(-40), 'The environment should expose bounded logs.');
+
+const staticTarget = await detectLiveViewTarget(staticProject);
+const staticEnvironment = buildLiveViewEnvironment({ target: staticTarget, session: null });
+assert.equal(staticEnvironment.mode, 'static', 'Static projects should use a static preview environment.');
+assert.equal(staticEnvironment.framework, 'Static HTML', 'Static framework detection should be visible.');
+assert.equal(staticEnvironment.diagnostics.runnerKind, 'static', 'Static diagnostics should identify direct serving.');
+
+const state = await getLiveViewState('vite-env-smoke', viteProject);
+assert.equal(state.environment.mode, 'local-process', 'Live View state should return the unified environment.');
+assert.equal(state.environment.command.id, 'npm-dev-vite', 'The state environment should use the detected command.');
+
+const liveViewPanel = await read('src/components/live-view/LiveViewPanel.tsx');
+assert.ok(liveViewPanel.includes('environment'), 'Live View panel should render the unified environment model.');
+assert.ok(liveViewPanel.includes('liveView.environment'), 'Live View panel should label the environment surface.');
+assert.ok(liveViewPanel.includes('command.custom'), 'Live View panel should make custom command state visible.');
+assert.ok(liveViewPanel.includes('environment.logs'), 'Live View panel should render logs from the environment model.');
+assert.ok(liveViewPanel.includes('environment.diagnostics'), 'Live View panel should render diagnostics from the environment model.');
+
+console.log('live view environment smoke passed');

package/scripts/smoke/live-view-integration.mjs

@@ -1,4 +1,5 @@
 import { access, chmod, mkdtemp, readFile, writeFile } from 'node:fs/promises';
+import net from 'node:net';
 import { tmpdir } from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -10,6 +11,13 @@ const read = async (relativePath) => {
   return readFile(path.join(repoRoot, relativePath), 'utf8');
 };
 const fileExists = async (filePath) => access(filePath).then(() => true, () => false);
+const canBindLoopback = () => new Promise((resolve) => {
+  const server = net.createServer();
+  server.once('error', () => resolve(false));
+  server.listen(0, '127.0.0.1', () => {
+    server.close(() => resolve(true));
+  });
+});
 
 const appTypes = await read('src/types/app.ts');
 assert.ok(
@@ -386,53 +394,57 @@ const brokenStatus = await getManagedRuntimeStatus('frankenphp', {
 });
 assert.equal(brokenStatus.status, 'missing', 'Broken managed FrankenPHP manifests should be treated as missing so Pixcode can reinstall them.');
 
-const phpRuntimeEnvHome = path.join(workspace, 'php-runtime-env');
-const phpRuntimeCurrent = path.join(phpRuntimeEnvHome, 'frankenphp', 'current');
-await mkdir(phpRuntimeCurrent, { recursive: true });
-const phpRuntimeExecutable = path.join(phpRuntimeCurrent, process.platform === 'win32' ? 'frankenphp.cmd' : 'frankenphp');
-await writeFile(phpRuntimeExecutable, [
-  '#!/usr/bin/env node',
-  'const http = require("node:http");',
-  'const path = require("node:path");',
-  'const runtimeDir = __dirname;',
-  'if (process.argv.includes("version")) process.exit(0);',
-  'const pathValue = process.env.Path || process.env.PATH || "";',
-  'if (!pathValue.split(path.delimiter).includes(runtimeDir)) {',
-  '  console.error("runtime path missing from PATH");',
-  '  process.exit(1);',
-  '}',
-  'const port = Number(process.env.PORT || 0);',
-  'http.createServer((req, res) => res.end("php runtime ok")).listen(port, "127.0.0.1");',
-  '',
-].join('\n'));
-if (process.platform !== 'win32') {
-  await chmod(phpRuntimeExecutable, 0o755);
-}
-await writeFile(path.join(phpRuntimeEnvHome, 'frankenphp', 'pixcode-runtime.json'), JSON.stringify({
-  id: 'frankenphp',
-  label: 'Pixcode PHP runtime',
-  executablePath: phpRuntimeExecutable,
-  version: 'path-env-smoke',
-}, null, 2));
-const previousRuntimeHome = process.env.PIXCODE_MANAGED_RUNTIMES_HOME;
-process.env.PIXCODE_MANAGED_RUNTIMES_HOME = phpRuntimeEnvHome;
-try {
-  const phpRuntimeSession = await startLiveView('php-runtime-env-smoke', phpProject);
-  assert.equal(phpRuntimeSession.status, 'running', 'Managed PHP Live View should start with the runtime directory on PATH.');
-  await stopLiveView('php-runtime-env-smoke');
-} finally {
-  if (previousRuntimeHome === undefined) {
-    delete process.env.PIXCODE_MANAGED_RUNTIMES_HOME;
-  } else {
-    process.env.PIXCODE_MANAGED_RUNTIMES_HOME = previousRuntimeHome;
+if (await canBindLoopback()) {
+  const phpRuntimeEnvHome = path.join(workspace, 'php-runtime-env');
+  const phpRuntimeCurrent = path.join(phpRuntimeEnvHome, 'frankenphp', 'current');
+  await mkdir(phpRuntimeCurrent, { recursive: true });
+  const phpRuntimeExecutable = path.join(phpRuntimeCurrent, process.platform === 'win32' ? 'frankenphp.cmd' : 'frankenphp');
+  await writeFile(phpRuntimeExecutable, [
+    '#!/usr/bin/env node',
+    'const http = require("node:http");',
+    'const path = require("node:path");',
+    'const runtimeDir = __dirname;',
+    'if (process.argv.includes("version")) process.exit(0);',
+    'const pathValue = process.env.Path || process.env.PATH || "";',
+    'if (!pathValue.split(path.delimiter).includes(runtimeDir)) {',
+    '  console.error("runtime path missing from PATH");',
+    '  process.exit(1);',
+    '}',
+    'const port = Number(process.env.PORT || 0);',
+    'http.createServer((req, res) => res.end("php runtime ok")).listen(port, "127.0.0.1");',
+    '',
+  ].join('\n'));
+  if (process.platform !== 'win32') {
+    await chmod(phpRuntimeExecutable, 0o755);
+  }
+  await writeFile(path.join(phpRuntimeEnvHome, 'frankenphp', 'pixcode-runtime.json'), JSON.stringify({
+    id: 'frankenphp',
+    label: 'Pixcode PHP runtime',
+    executablePath: phpRuntimeExecutable,
+    version: 'path-env-smoke',
+  }, null, 2));
+  const previousRuntimeHome = process.env.PIXCODE_MANAGED_RUNTIMES_HOME;
+  process.env.PIXCODE_MANAGED_RUNTIMES_HOME = phpRuntimeEnvHome;
+  try {
+    const phpRuntimeSession = await startLiveView('php-runtime-env-smoke', phpProject);
+    assert.equal(phpRuntimeSession.status, 'running', 'Managed PHP Live View should start with the runtime directory on PATH.');
+    await stopLiveView('php-runtime-env-smoke');
+  } finally {
+    if (previousRuntimeHome === undefined) {
+      delete process.env.PIXCODE_MANAGED_RUNTIMES_HOME;
+    } else {
+      process.env.PIXCODE_MANAGED_RUNTIMES_HOME = previousRuntimeHome;
+    }
   }
-}
 
-const staticSession = await startLiveView('static-smoke', staticProject);
-assert.equal(staticSession.status, 'running', 'Static Live View should start without a child process.');
-assert.match(staticSession.sharePath, /^\/live\/[a-f0-9]{24}\/$/, 'Live View should expose a random public share path.');
-const staticState = await getLiveViewState('static-smoke', staticProject);
-assert.equal(staticState.session?.shareId, staticSession.shareId, 'Live View state should retain the active share session.');
-await stopLiveView('static-smoke');
+  const staticSession = await startLiveView('static-smoke', staticProject);
+  assert.equal(staticSession.status, 'running', 'Static Live View should start without a child process.');
+  assert.match(staticSession.sharePath, /^\/live\/[a-f0-9]{24}\/$/, 'Live View should expose a random public share path.');
+  const staticState = await getLiveViewState('static-smoke', staticProject);
+  assert.equal(staticState.session?.shareId, staticSession.shareId, 'Live View state should retain the active share session.');
+  await stopLiveView('static-smoke');
+} else {
+  console.warn('Skipping Live View launch smoke because this sandbox cannot bind 127.0.0.1.');
+}
 
 console.log('live view integration smoke passed');