@lumenflow/cli 3.1.2 → 3.1.3

package/packs/software-delivery/tool-impl/worker-loader.ts

@@ -0,0 +1,52 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+
+import path from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+export interface LoadToolImplementationInput {
+  entry: string;
+  caller: 'worker' | 'host';
+}
+
+export type ToolImplementationFn = (...args: unknown[]) => unknown;
+
+function parseEntry(entry: string): { modulePath: string; exportName: string } {
+  const separator = entry.indexOf('#');
+  if (separator < 1 || separator === entry.length - 1) {
+    throw new Error(`Invalid tool entry "${entry}". Expected "<module>#<export>".`);
+  }
+
+  return {
+    modulePath: entry.slice(0, separator),
+    exportName: entry.slice(separator + 1),
+  };
+}
+
+function resolveEntryPath(modulePath: string): string {
+  if (!modulePath.startsWith('tool-impl/')) {
+    throw new Error(`Invalid tool-impl module path "${modulePath}".`);
+  }
+  const toolImplRoot = path.dirname(fileURLToPath(import.meta.url));
+  const packRoot = path.resolve(toolImplRoot, '..');
+  return path.join(packRoot, modulePath);
+}
+
+export async function loadToolImplementation(
+  input: LoadToolImplementationInput,
+): Promise<ToolImplementationFn> {
+  if (input.caller !== 'worker') {
+    throw new Error('tool-impl modules can only be loaded by the tool-runner worker.');
+  }
+
+  const { modulePath, exportName } = parseEntry(input.entry);
+  const absolutePath = resolveEntryPath(modulePath);
+  const loadedModule = (await import(pathToFileURL(absolutePath).href)) as Record<string, unknown>;
+  // eslint-disable-next-line security/detect-object-injection -- exportName comes from validated tool entry syntax
+  const exported = loadedModule[exportName];
+
+  if (typeof exported !== 'function') {
+    throw new Error(`Entry "${input.entry}" did not resolve to a function export.`);
+  }
+  return exported as ToolImplementationFn;
+}

package/packs/software-delivery/tool-impl/worktree-tools.ts

@@ -0,0 +1,46 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+
+import { runGit } from './git-runner.js';
+
+interface WorktreeCommandResult {
+  success: boolean;
+  stdout: string;
+  stderr: string;
+}
+
+function runWorktreeGit(args: string[], cwd?: string): WorktreeCommandResult {
+  const result = runGit(args, { cwd });
+  return {
+    success: result.ok,
+    stdout: result.stdout,
+    stderr: result.stderr,
+  };
+}
+
+export async function listWorktreesTool(
+  input: { cwd?: string } = {},
+): Promise<WorktreeCommandResult> {
+  return runWorktreeGit(['worktree', 'list', '--porcelain'], input.cwd);
+}
+
+export async function createWorktreeTool(input: {
+  cwd?: string;
+  path: string;
+  branch: string;
+}): Promise<WorktreeCommandResult> {
+  return runWorktreeGit(['worktree', 'add', input.path, input.branch], input.cwd);
+}
+
+export async function removeWorktreeTool(input: {
+  cwd?: string;
+  path: string;
+  force?: boolean;
+}): Promise<WorktreeCommandResult> {
+  const args = ['worktree', 'remove'];
+  if (input.force) {
+    args.push('--force');
+  }
+  args.push(input.path);
+  return runWorktreeGit(args, input.cwd);
+}