@quantum-hub/qhubctl 2.2.2-next.1 → 2.2.2

package/dist/commands/openapi.js

@@ -1,27 +1,29 @@
-import { confirm } from '@inquirer/prompts';
-import { Command } from 'commander';
-import fs from 'fs-extra';
-import path from 'node:path';
-import { spawnSync } from 'node:child_process';
-import { executeAsyncCommand } from '../lib/command.js';
-import { EntrypointResolver } from '../lib/entrypoint-resolver.js';
-import { randomString } from '../lib/random-string.js';
-import { error, spinner, stdout, warn } from '../lib/output.js';
-import { Runtime } from '../model/managed-service-config.js';
-import { readServiceConfig } from '../service/service-config-service.js';
-const SUPPORTED_FORMATS = ['yaml'];
-const DEFAULT_OUTPUT_FILE = 'openapi.yaml';
-const DEPRECATED_FILE_NAME = 'openapi-spec.yml';
+import { confirm } from "@inquirer/prompts";
+import { Command } from "commander";
+import fs from "fs-extra";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+import { executeAsyncCommand } from "../lib/command.js";
+import { EntrypointResolver } from "../lib/entrypoint-resolver.js";
+import { randomString } from "../lib/random-string.js";
+import { error, spinner, stdout, warn } from "../lib/output.js";
+import { Runtime } from "../model/managed-service-config.js";
+import { readServiceConfig } from "../service/service-config-service.js";
+const SUPPORTED_FORMATS = ["yaml"];
+const DEFAULT_OUTPUT_FILE = "openapi.yaml";
+const DEPRECATED_FILE_NAME = "openapi-spec.yml";
 function getErrorMessage(err) {
-    if (typeof err === 'object' && err !== null && 'message' in err &&
-        typeof err.message === 'string') {
+    if (typeof err === "object" &&
+        err !== null &&
+        "message" in err &&
+        typeof err.message === "string") {
         return err.message;
     }
-    if (typeof err === 'string')
+    if (typeof err === "string")
         return err;
     if (err instanceof Error)
         return err.message;
-    return 'An unknown error occurred';
+    return "An unknown error occurred";
 }
 function checkDeprecatedFiles() {
     const deprecatedFile = path.join(process.cwd(), DEPRECATED_FILE_NAME);
@@ -40,7 +42,9 @@ async function determineOutputPath(opts) {
                 fs.mkdirpSync(outputDir);
             }
             catch (err) {
-                throw new Error(`Cannot create output directory: ${outputDir}. ${getErrorMessage(err)}`, { cause: err });
+                throw new Error(`Cannot create output directory: ${outputDir}. ${getErrorMessage(err)}`, {
+                    cause: err,
+                });
             }
         }
     }
@@ -50,7 +54,7 @@ async function determineOutputPath(opts) {
             default: false,
         });
         if (!shouldOverwrite) {
-            const newPath = path.join(path.dirname(outputPath), `${path.basename(outputPath, '.yaml')}-${randomString(5)}.yaml`);
+            const newPath = path.join(path.dirname(outputPath), `${path.basename(outputPath, ".yaml")}-${randomString(5)}.yaml`);
             stdout(`Creating new file: ${path.basename(newPath)}`);
             return newPath;
         }
@@ -64,7 +68,7 @@ function isProjectSupported(opts) {
     }
     catch (err) {
         warn(`Failed to read project configuration: ${getErrorMessage(err)}`);
-        warn('Ensure you have a valid qhub.json file in your project root.');
+        warn("Ensure you have a valid qhub.json file in your project root.");
         return false;
     }
     const hasExplicitEntrypoint = !!(opts.entrypoint || opts.package || opts.method);
@@ -73,52 +77,52 @@ function isProjectSupported(opts) {
         const isSupported = supportedRuntimes.includes(serviceConfig.runtime);
         if (!isSupported) {
             warn(`Runtime "${serviceConfig.runtime}" is not supported for OpenAPI generation.`);
-            warn('');
-            warn('Supported configurations:');
-            warn('  \u2022 PYTHON_TEMPLATE: Automatic (requires src/program.py)');
-            warn('  \u2022 DOCKER: With explicit entrypoint flags');
-            warn('');
-            warn('Examples:');
-            warn('  qhubctl openapi --entrypoint=myapp.main:handler');
-            warn('  qhubctl openapi --package=myapp.core --method=process');
+            warn("");
+            warn("Supported configurations:");
+            warn("  \u2022 PYTHON_TEMPLATE: Automatic (requires src/program.py)");
+            warn("  \u2022 DOCKER: With explicit entrypoint flags");
+            warn("");
+            warn("Examples:");
+            warn("  qhubctl openapi --entrypoint=myapp.main:handler");
+            warn("  qhubctl openapi --package=myapp.core --method=process");
         }
         return isSupported;
     }
-    const programFile = path.join(process.cwd(), 'src', 'program.py');
+    const programFile = path.join(process.cwd(), "src", "program.py");
     const hasProgramFile = fs.existsSync(programFile);
     const isPythonTemplate = serviceConfig.runtime === Runtime.PYTHON_TEMPLATE;
     const isSupported = isPythonTemplate && hasProgramFile;
     if (!isSupported) {
-        warn('Cannot generate OpenAPI description from your code.');
-        warn('');
+        warn("Cannot generate OpenAPI description from your code.");
+        warn("");
         if (isPythonTemplate && !hasProgramFile) {
-            warn('Missing required file: src/program.py');
-            warn('');
-            warn('Solutions:');
-            warn('  \u2022 Create src/program.py with your main function, or');
-            warn('  \u2022 Use explicit entrypoint: --entrypoint=yourmodule.main:function');
+            warn("Missing required file: src/program.py");
+            warn("");
+            warn("Solutions:");
+            warn("  \u2022 Create src/program.py with your main function, or");
+            warn("  \u2022 Use explicit entrypoint: --entrypoint=yourmodule.main:function");
         }
         else if (!isPythonTemplate) {
             warn(`Runtime "${serviceConfig.runtime}" requires explicit entrypoint specification.`);
-            warn('');
-            warn('Use one of these flags:');
-            warn('  --entrypoint=package.module:function');
-            warn('  --package=package.module --method=function');
-            warn('');
-            warn('Examples:');
-            warn('  qhubctl openapi --entrypoint=myapp.main:handler');
-            warn('  qhubctl openapi --package=myapp.core --method=process');
+            warn("");
+            warn("Use one of these flags:");
+            warn("  --entrypoint=package.module:function");
+            warn("  --package=package.module --method=function");
+            warn("");
+            warn("Examples:");
+            warn("  qhubctl openapi --entrypoint=myapp.main:handler");
+            warn("  qhubctl openapi --package=myapp.core --method=process");
         }
     }
     return isSupported;
 }
 function formatPythonError(stderr) {
     const commonErrors = {
-        'ModuleNotFoundError': 'Missing dependency. Install qhub-commons: pip install qhub-commons',
-        'ImportError': 'Cannot import module. Check your entrypoint path and ensure the module exists',
-        'AttributeError': 'Function not found. Check your method name and ensure it exists in the specified module',
-        'SyntaxError': 'Python syntax error in your code. Fix the syntax errors and try again',
-        'TypeError': 'Type error in your function. Ensure proper type annotations for parameters and return values',
+        ModuleNotFoundError: "Missing dependency. Install qhub-commons: pip install qhub-commons",
+        ImportError: "Cannot import module. Check your entrypoint path and ensure the module exists",
+        AttributeError: "Function not found. Check your method name and ensure it exists in the specified module",
+        SyntaxError: "Python syntax error in your code. Fix the syntax errors and try again",
+        TypeError: "Type error in your function. Ensure proper type annotations for parameters and return values",
     };
     for (const [errorType, helpText] of Object.entries(commonErrors)) {
         if (stderr.includes(errorType))
@@ -127,36 +131,48 @@ function formatPythonError(stderr) {
     return `Failed to generate OpenAPI description: ${stderr}`;
 }
 function validateCommandResult(result) {
-    if (typeof result === 'object' && result !== null &&
-        'stdout' in result && 'stderr' in result &&
-        typeof result.stdout === 'string' &&
-        typeof result.stderr === 'string') {
+    if (typeof result === "object" &&
+        result !== null &&
+        "stdout" in result &&
+        "stderr" in result &&
+        typeof result.stdout === "string" &&
+        typeof result.stderr === "string") {
         const { stdout: out, stderr } = result;
         if (!out.trim()) {
-            const detail = stderr.trim() ? formatPythonError(stderr) : 'OpenAPI generation returned empty output. Check your entrypoint and ensure it has proper type annotations.';
+            const detail = stderr.trim()
+                ? formatPythonError(stderr)
+                : "OpenAPI generation returned empty output. Check your entrypoint and ensure it has proper type annotations.";
             throw new Error(detail);
         }
         return { stdout: out, stderr };
     }
-    throw new Error('Invalid command result format');
+    throw new Error("Invalid command result format");
 }
 async function generateFromCode(entrypoint) {
-    let title = 'Service API';
+    let title = "Service API";
     let description;
     try {
         const serviceConfig = readServiceConfig(process.cwd());
-        title = serviceConfig.name || 'Service API';
-        description = serviceConfig.summary || '';
+        title = serviceConfig.name || "Service API";
+        description = serviceConfig.summary || "";
     }
     catch {
         warn(`Could not load qhub.json configuration. Using default title: ${title}`);
     }
-    const pySnippet = 'import sys; from qhub.commons.openapi.generator import generate_openapi; ' +
-        'generate_openapi(entrypoint=sys.argv[1], title=sys.argv[2], description=sys.argv[3] or None)';
+    const pySnippet = "import sys; from qhub.commons.openapi.generator import generate_openapi; " +
+        "generate_openapi(entrypoint=sys.argv[1], title=sys.argv[2], description=sys.argv[3] or None)";
     try {
-        const result = await executeAsyncCommand('uv', [
-            'run', '--no-sync', '--project', process.cwd(),
-            'python', '-c', pySnippet, entrypoint, title, description ?? '',
+        const result = await executeAsyncCommand("uv", [
+            "run",
+            "--no-sync",
+            "--project",
+            process.cwd(),
+            "python",
+            "-c",
+            pySnippet,
+            entrypoint,
+            title,
+            description ?? "",
         ]);
         const { stdout: out } = validateCommandResult(result);
         return out;
@@ -173,22 +189,22 @@ Examples:
   $ qhubctl openapi --entrypoint=src.program:run
   $ qhubctl openapi --package=src.program --method=run
   $ qhubctl openapi --package=src.program`;
-export const openapiCommand = new Command('openapi')
-    .description('Generates the OpenAPI description for your project based on the parameter and return types of your run() method. ' +
-    'The output of this command will be used when creating or updating your service. ' +
-    'Supports PYTHON_TEMPLATE (with src/program.py) and DOCKER runtime (with explicit entrypoint). ' +
+export const openapiCommand = new Command("openapi")
+    .description("Generates the OpenAPI description for your project based on the parameter and return types of your run() method. " +
+    "The output of this command will be used when creating or updating your service. " +
+    "Supports PYTHON_TEMPLATE (with src/program.py) and DOCKER runtime (with explicit entrypoint). " +
     'Requires uv and a valid uv project in the workspace. The "qhub-commons" dependency is installed/upgraded automatically as a dependency.')
-    .option('-f, --force', 'Overwrite the output file if it already exists', false)
-    .option('--file <value>', 'The file to write the OpenAPI description to')
-    .option('--format <value>', `The format to generate the OpenAPI description [possible values: ${SUPPORTED_FORMATS.join(', ')}]`)
-    .option('--entrypoint <value>', 'The entrypoint to your program in the format "package.module:function" (default: "src.program:run"). Overrides package and method flags.')
-    .option('--package <value>', 'The package/module path to your program (e.g., "src.program" or "my_package.main"). Only used if entrypoint is not provided.')
-    .option('--method <value>', 'The method/function name in your program (default: "run"). Only used if entrypoint is not provided.')
-    .addHelpText('after', EXAMPLES)
+    .option("-f, --force", "Overwrite the output file if it already exists", false)
+    .option("--file <value>", "The file to write the OpenAPI description to")
+    .option("--format <value>", `The format to generate the OpenAPI description [possible values: ${SUPPORTED_FORMATS.join(", ")}]`)
+    .option("--entrypoint <value>", 'The entrypoint to your program in the format "package.module:function" (default: "src.program:run"). Overrides package and method flags.')
+    .option("--package <value>", 'The package/module path to your program (e.g., "src.program" or "my_package.main"). Only used if entrypoint is not provided.')
+    .option("--method <value>", 'The method/function name in your program (default: "run"). Only used if entrypoint is not provided.')
+    .addHelpText("after", EXAMPLES)
     .action(async (opts) => {
     checkDeprecatedFiles();
     if (opts.format && !SUPPORTED_FORMATS.includes(opts.format)) {
-        throw new Error(`Unsupported format: ${opts.format}. Supported formats: ${SUPPORTED_FORMATS.join(', ')}`);
+        throw new Error(`Unsupported format: ${opts.format}. Supported formats: ${SUPPORTED_FORMATS.join(", ")}`);
     }
     let entrypoint;
     try {
@@ -197,48 +213,50 @@ export const openapiCommand = new Command('openapi')
     catch (err) {
         throw new Error(`Invalid entrypoint format: ${getErrorMessage(err)}\n\n` +
             'Expected format: "package.module:function"\nExample: "src.program:run"\n\n' +
-            'Use --help for more examples.', { cause: err });
+            "Use --help for more examples.", { cause: err });
     }
     const outputPath = await determineOutputPath(opts);
     const shouldGenerateFile = isProjectSupported(opts);
     if (!shouldGenerateFile) {
         warn(`Cannot generate OpenAPI description from your code. Supported configurations:\n` +
             '  \u2022 PYTHON_TEMPLATE runtime with "./src/program.py" file\n' +
-            '  \u2022 DOCKER or PYTHON_TEMPLATE runtimes with explicit entrypoint (--entrypoint, or (--package, --method))');
+            "  \u2022 DOCKER or PYTHON_TEMPLATE runtimes with explicit entrypoint (--entrypoint, or (--package, --method))");
         return;
     }
     // Ensure qhub-commons is installed (or upgraded) in the project venv
-    stdout('Ensuring qhub-commons is up to date...');
-    const addResult = spawnSync('uv', ['add', '--upgrade', 'qhub-commons', '--project', process.cwd()], { stdio: 'inherit' });
+    stdout("Ensuring qhub-commons is up to date...");
+    const addResult = spawnSync("uv", ["add", "--upgrade", "qhub-commons", "--project", process.cwd()], { stdio: "inherit" });
     if (addResult.status !== 0) {
-        error('Failed to install qhub-commons via uv. ' +
-            'Make sure uv is installed and the workspace is a valid uv project.');
+        error("Failed to install qhub-commons via uv. " +
+            "Make sure uv is installed and the workspace is a valid uv project.");
     }
-    const spin = spinner('Generating OpenAPI description');
+    const spin = spinner("Generating OpenAPI description");
     let fileContent;
     try {
         fileContent = await generateFromCode(entrypoint);
     }
     catch (err) {
-        spin.fail('Failed');
+        spin.fail("Failed");
         throw err;
     }
     try {
-        fs.writeFileSync(outputPath, fileContent, 'utf8');
-        spin.succeed('Done');
+        fs.writeFileSync(outputPath, fileContent, "utf8");
+        spin.succeed("Done");
     }
     catch (err) {
-        spin.fail('Failed');
-        throw new Error(`Failed to write file ${outputPath}: ${getErrorMessage(err)}`, { cause: err });
+        spin.fail("Failed");
+        throw new Error(`Failed to write file ${outputPath}: ${getErrorMessage(err)}`, {
+            cause: err,
+        });
     }
     const relativePath = path.relative(process.cwd(), outputPath);
-    const displayPath = relativePath.startsWith('..') ? outputPath : relativePath;
-    stdout('');
+    const displayPath = relativePath.startsWith("..") ? outputPath : relativePath;
+    stdout("");
     stdout(`OpenAPI description created: ${displayPath}`);
     if (fs.statSync(outputPath).size > 0) {
-        stdout('');
-        stdout('Next steps:');
-        stdout(' \u2022 Review the generated OpenAPI description');
-        stdout(' \u2022 Use it to create or update your service');
+        stdout("");
+        stdout("Next steps:");
+        stdout(" \u2022 Review the generated OpenAPI description");
+        stdout(" \u2022 Use it to create or update your service");
     }
 });

package/dist/commands/run.d.ts

@@ -1,5 +1,5 @@
-import { Command } from 'commander';
-import { HubPlatform } from '@quantum-hub/qhub-api/platform';
+import { Command } from "commander";
+import { HubPlatform } from "@quantum-hub/qhub-api/platform";
 export interface RunCommandOptions {
     tag: string[];
     storeInput: boolean;

package/dist/commands/run.js

@@ -1,18 +1,18 @@
-import { confirm } from '@inquirer/prompts';
-import { Command } from 'commander';
-import { waitUntil } from 'async-wait-until';
-import fsExtra from 'fs-extra';
+import { confirm } from "@inquirer/prompts";
+import { Command } from "commander";
+import { waitUntil } from "async-wait-until";
+import fsExtra from "fs-extra";
 const { readJsonSync } = fsExtra;
-import fs from 'node:fs';
-import path from 'node:path';
-import { error, spinner, stdout, warn } from '../lib/output.js';
-import { requireAuth } from '../model/command.js';
-import { defaultBasePath } from '../model/user-config.js';
-import QuantumHubService from '../service/quantum-hub-service.js';
-import { readServiceConfig } from '../service/service-config-service.js';
-import { HubPlatform } from '@quantum-hub/qhub-api/platform';
+import fs from "node:fs";
+import path from "node:path";
+import { error, spinner, stdout, warn } from "../lib/output.js";
+import { requireAuth } from "../model/command.js";
+import { defaultBasePath } from "../model/user-config.js";
+import QuantumHubService from "../service/quantum-hub-service.js";
+import { readServiceConfig } from "../service/service-config-service.js";
+import { HubPlatform } from "@quantum-hub/qhub-api/platform";
 async function getInputFromFiles(filePaths) {
-    const paths = filePaths.split(',').map(p => p.trim());
+    const paths = filePaths.split(",").map((p) => p.trim());
     const mergedInput = {};
     let hasValidFile = false;
     for (const filePath of paths) {
@@ -22,7 +22,7 @@ async function getInputFromFiles(filePaths) {
         }
         if (fs.existsSync(file)) {
             try {
-                const content = readJsonSync(file, { encoding: 'utf8' });
+                const content = readJsonSync(file, { encoding: "utf8" });
                 Object.assign(mergedInput, content);
                 hasValidFile = true;
             }
@@ -32,7 +32,7 @@ async function getInputFromFiles(filePaths) {
         }
     }
     if (!hasValidFile) {
-        const confirmed = await confirm({ message: 'No valid input files found. Run without input?' });
+        const confirmed = await confirm({ message: "No valid input files found. Run without input?" });
         if (confirmed)
             return {};
         process.exit(0);
@@ -42,7 +42,7 @@ async function getInputFromFiles(filePaths) {
 export function buildCreateJobRequest(serviceId, input, opts) {
     const payload = {
         serviceId,
-        tags: ['cli', ...opts.tag],
+        tags: ["cli", ...opts.tag],
         input,
     };
     if (opts.storeInput) {
@@ -59,15 +59,15 @@ Examples:
   $ qhubctl run --input-files=./config.json,./overrides.json
   $ qhubctl run --store-input
   $ qhubctl run --tag experiment --tag run-42`;
-export const runCommand = new Command('run')
-    .description('Creates a job execution')
-    .argument('[serviceId]', 'The ID of the service to run (optional — reads from qhub.json if omitted)')
-    .option('-i, --input <value>', 'Input as JSON string.')
-    .option('--input-files <value>', 'Comma-separated paths to files containing input to be merged (default: ./input/data.json,./input/params.json).')
-    .option('--store-input', 'Persist the input data alongside the job on the server.', false)
-    .option('--tag <value>', 'Tag to attach to the job. Repeat the flag to attach multiple tags.', (value, previous) => [...previous, value], [])
-    .option('--detached', 'Executes the job in detached mode, i.e., without waiting for it to finish.', false)
-    .addHelpText('after', EXAMPLES)
+export const runCommand = new Command("run")
+    .description("Creates a job execution")
+    .argument("[serviceId]", "The ID of the service to run (optional — reads from qhub.json if omitted)")
+    .option("-i, --input <value>", "Input as JSON string.")
+    .option("--input-files <value>", "Comma-separated paths to files containing input to be merged (default: ./input/data.json,./input/params.json).")
+    .option("--store-input", "Persist the input data alongside the job on the server.", false)
+    .option("--tag <value>", "Tag to attach to the job. Repeat the flag to attach multiple tags.", (value, previous) => [...previous, value], [])
+    .option("--detached", "Executes the job in detached mode, i.e., without waiting for it to finish.", false)
+    .addHelpText("after", EXAMPLES)
     .action(async (serviceId, opts) => {
     const userConfig = await requireAuth();
     const hubService = new QuantumHubService(userConfig);
@@ -81,7 +81,7 @@ export const runCommand = new Command('run')
         }
     }
     if (!serviceId) {
-        error('Missing service ID. Please provide a service ID as argument or set it in the qhub.json of your project.');
+        error("Missing service ID. Please provide a service ID as argument or set it in the qhub.json of your project.");
     }
     const service = await hubService.getService(serviceId);
     let input;
@@ -90,14 +90,17 @@ export const runCommand = new Command('run')
             input = JSON.parse(opts.input);
         }
         catch {
-            error('Invalid JSON provided.');
+            error("Invalid JSON provided.");
         }
     }
     else {
-        input = await getInputFromFiles(opts.inputFiles || './input/data.json,./input/params.json');
+        input = await getInputFromFiles(opts.inputFiles || "./input/data.json,./input/params.json");
     }
     let job;
-    const payload = buildCreateJobRequest(service.id, input, { tag: opts.tag, storeInput: opts.storeInput });
+    const payload = buildCreateJobRequest(service.id, input, {
+        tag: opts.tag,
+        storeInput: opts.storeInput,
+    });
     job = await hubService.runJob(payload);
     if (opts.detached) {
         stdout(`Job (${job.id}) created.`);
@@ -119,24 +122,24 @@ export const runCommand = new Command('run')
         // ignore — status printed below
     }
     const basePath = userConfig.endpoint?.basePath || defaultBasePath;
-    const dashboardBase = basePath.replace('//api.hub.', '//dashboard.hub.');
+    const dashboardBase = basePath.replace("//api.hub.", "//dashboard.hub.");
     const jobDetailsLink = `${dashboardBase}/service-jobs/${job.id}`;
     switch (job.status) {
         case HubPlatform.ServiceJobDto.Status.Cancelled:
-            spin.warn('Job canceled.');
+            spin.warn("Job canceled.");
             stdout(`See details at \u001B]8;;${jobDetailsLink}\u0007${jobDetailsLink}\u001B]8;;\u0007`);
             break;
         case HubPlatform.ServiceJobDto.Status.Failed:
-            spin.fail('Job failed.');
+            spin.fail("Job failed.");
             stdout(`See details at \u001B]8;;${jobDetailsLink}\u0007${jobDetailsLink}\u001B]8;;\u0007`);
             break;
         case HubPlatform.ServiceJobDto.Status.Succeeded:
-            spin.succeed('Job succeeded.');
+            spin.succeed("Job succeeded.");
             stdout(`See result at \u001B]8;;${jobDetailsLink}\u0007${jobDetailsLink}\u001B]8;;\u0007`);
             break;
         default:
             spin.stop();
-            stdout('Timeout polling status.');
+            stdout("Timeout polling status.");
             stdout(`See status details at \u001B]8;;${jobDetailsLink}\u0007${jobDetailsLink}\u001B]8;;\u0007`);
     }
 });

package/dist/commands/serve.d.ts

@@ -1,2 +1,2 @@
-import { Command } from 'commander';
+import { Command } from "commander";
 export declare const serveCommand: Command;

package/dist/commands/serve.js

@@ -1,35 +1,46 @@
-import { Command } from 'commander';
-import { spawnSync } from 'node:child_process';
-import { error, stdout } from '../lib/output.js';
-const LOG_LEVELS = ['TRACE', 'DEBUG', 'INFO', 'SUCCESS', 'WARNING', 'ERROR', 'CRITICAL'];
+import { Command } from "commander";
+import { spawnSync } from "node:child_process";
+import { error, stdout } from "../lib/output.js";
+const LOG_LEVELS = ["TRACE", "DEBUG", "INFO", "SUCCESS", "WARNING", "ERROR", "CRITICAL"];
 const EXAMPLES = `
 Examples:
   $ qhubctl serve
   $ qhubctl serve -p 8081
   $ qhubctl serve --workspace /path/to/workspace`;
-export const serveCommand = new Command('serve')
-    .description('Runs your project locally via qhub-serve inside the workspace virtual environment, ' +
-    'exposing the same HTTP endpoints as Kipu Quantum Hub (start execution, check status, ' +
-    'cancel, retrieve results).')
-    .option('-p, --port <number>', 'The port on which the local web server accepts requests', '8081')
-    .option('--log-level <level>', `Log level for qhub-serve. Possible values: ${LOG_LEVELS.join(', ')}`, 'INFO')
-    .option('-w, --workspace <path>', 'Path to the workspace directory (must be a valid uv project). Defaults to the current directory.')
-    .addHelpText('after', EXAMPLES)
+export const serveCommand = new Command("serve")
+    .description("Runs your project locally via qhub-serve inside the workspace virtual environment, " +
+    "exposing the same HTTP endpoints as Kipu Quantum Hub (start execution, check status, " +
+    "cancel, retrieve results).")
+    .option("-p, --port <number>", "The port on which the local web server accepts requests", "8081")
+    .option("--log-level <level>", `Log level for qhub-serve. Possible values: ${LOG_LEVELS.join(", ")}`, "INFO")
+    .option("-w, --workspace <path>", "Path to the workspace directory (must be a valid uv project). Defaults to the current directory.")
+    .addHelpText("after", EXAMPLES)
     .action(async (opts) => {
     const workspaceDir = opts.workspace ?? process.cwd();
     const port = opts.port;
     const logLevel = opts.logLevel;
     // Step 1: Add (or upgrade) qhub-serve as a dev dependency
-    stdout('Ensuring qhub-serve is up to date...');
-    const addResult = spawnSync('uv', ['add', '--dev', '--upgrade', 'qhub-serve', '--project', workspaceDir], { stdio: 'inherit' });
+    stdout("Ensuring qhub-serve is up to date...");
+    const addResult = spawnSync("uv", ["add", "--dev", "--upgrade", "qhub-serve", "--project", workspaceDir], { stdio: "inherit" });
     if (addResult.status !== 0) {
-        error('Failed to install qhub-serve via uv. ' +
-            'Make sure uv is installed and the workspace is a valid uv project.');
+        error("Failed to install qhub-serve via uv. " +
+            "Make sure uv is installed and the workspace is a valid uv project.");
     }
     // Step 2: Run qhub-serve inside the workspace venv
-    stdout('\nStarting qhub-serve...');
-    const runResult = spawnSync('uv', ['run', '--project', workspaceDir, 'qhub-serve', '--workspace', workspaceDir, '--port', String(port), '--log-level', logLevel], { stdio: 'inherit' });
+    stdout("\nStarting qhub-serve...");
+    const runResult = spawnSync("uv", [
+        "run",
+        "--project",
+        workspaceDir,
+        "qhub-serve",
+        "--workspace",
+        workspaceDir,
+        "--port",
+        String(port),
+        "--log-level",
+        logLevel,
+    ], { stdio: "inherit" });
     if (runResult.status !== 0) {
-        error('qhub-serve exited with a non-zero status code.');
+        error("qhub-serve exited with a non-zero status code.");
     }
 });

package/dist/commands/services-build-logs.d.ts

@@ -1,5 +1,5 @@
-import { HubPlatform } from '@quantum-hub/qhub-api/platform';
-import { Command } from 'commander';
+import { HubPlatform } from "@quantum-hub/qhub-api/platform";
+import { Command } from "commander";
 export declare function formatLogEntry(entry: HubPlatform.LogEntry, opts: {
     isTTY: boolean;
 }): string;