genesis-compiler 1.2.12 → 1.2.13

package/src/index/workspace-setup.js

@@ -1,156 +0,0 @@
-import { access } from 'node:fs/promises';
-import path from 'node:path';
-
-import { asDiagnostic } from './errors.js';
-import { gitContext } from './git.js';
-import { runProcess } from './process.js';
-import { readStack } from './stack.js';
-import { withStackEnvironmentDefaults } from './stack-environment-defaults.js';
-import { sha256, stableJson, uniqueSorted } from './utils.js';
-import { GENESIS_CONTRACTS } from './contracts.js';
-
-const DEFAULT_FINITE_COMMAND_TIMEOUT_MS = 30 * 60 * 1_000;
-
-async function emit(onEvent, event) {
-  try { await onEvent?.(event); } catch { /* Progress observers do not control preparation. */ }
-}
-
-export async function inspectWorkspaceSetupForStack({ projectRoot: root, stack }) {
-  const diagnostics = [...stack.workspaceSetup.diagnostics];
-  const applicableSteps = [];
-  if (diagnostics.length === 0) {
-    const waitingFor = [];
-    for (const step of stack.workspaceSetup.steps) {
-      if (step.runWhen) {
-        try {
-          await access(path.join(root, step.runWhen));
-          applicableSteps.push(step);
-        } catch (error) {
-          if (!['ENOENT', 'ENOTDIR'].includes(error?.code)) throw error;
-        }
-        continue;
-      }
-      applicableSteps.push(step);
-      if (!step.readyWhen) continue;
-      try {
-        await access(path.join(root, step.readyWhen));
-      } catch (error) {
-        if (!['ENOENT', 'ENOTDIR'].includes(error?.code)) throw error;
-        waitingFor.push(step.readyWhen);
-      }
-    }
-    if (waitingFor.length > 0) {
-      const paths = uniqueSorted(waitingFor);
-      diagnostics.push({
-        code: 'STACK_WORKSPACE_SETUP_WAITING',
-        message: `Workspace setup is waiting for project ${paths.length === 1 ? 'path' : 'paths'}: ${paths.join(', ')}.`,
-        details: { paths },
-      });
-    }
-  }
-  const waiting = diagnostics.some(({ code }) => code === 'STACK_WORKSPACE_SETUP_WAITING');
-  const blocked = diagnostics.some(({ code }) => code !== 'STACK_WORKSPACE_SETUP_WAITING');
-  let status = 'unconfigured';
-  if (blocked) status = 'blocked';
-  else if (!waiting && applicableSteps.length > 0) status = 'ready';
-  const recipeHash = status === 'ready'
-    ? sha256(stableJson({ version: 1, steps: applicableSteps }))
-    : '';
-  return {
-    contract: GENESIS_CONTRACTS.workspaceSetup,
-    status,
-    stackHash: stack.identityHash,
-    recipeHash,
-    components: stack.components.map(({ id }) => id),
-    source: stack.workspaceSetup.source,
-    runtimeRequirements: uniqueSorted(
-      applicableSteps.flatMap((step) => step.runtimeRequirements),
-    ),
-    steps: applicableSteps,
-    diagnostics,
-  };
-}
-
-/** Read the Stack's workspace preparation recipe without executing it. */
-export async function inspectProjectWorkspaceSetup({
-  projectRoot,
-  stackPackages = [],
-} = {}) {
-  const root = (await gitContext(projectRoot)).repositoryRoot;
-  const stack = await readStack(root, { stackPackages });
-  return inspectWorkspaceSetupForStack({ projectRoot: root, stack });
-}
-
-/** Execute the selected Stack's exact workspace recipe with the caller's environment. */
-export async function prepareProjectWorkspace({
-  environment = process.env,
-  onEvent,
-  processRunner = runProcess,
-  projectRoot,
-  signal,
-  stackPackages = [],
-  timeoutMs = DEFAULT_FINITE_COMMAND_TIMEOUT_MS,
-} = {}) {
-  const root = (await gitContext(projectRoot)).repositoryRoot;
-  const stack = await readStack(root, { stackPackages });
-  const setup = await inspectWorkspaceSetupForStack({ projectRoot: root, stack });
-  if (setup.status !== 'ready') {
-    const summary = setup.diagnostics.map(({ message }) => message).join(' ')
-      || 'The selected Stack declares no applicable workspace preparation commands.';
-    return {
-      ...setup,
-      summary,
-      commands: [],
-    };
-  }
-
-  const resolvedEnvironment = withStackEnvironmentDefaults(
-    environment,
-    stack.environmentDefaults,
-  );
-  const commands = [];
-  try {
-    for (const step of setup.steps) {
-      await emit(onEvent, {
-        type: 'genesis.workspace-preparation',
-        code: 'WORKSPACE_PREPARATION_STARTED',
-        message: `Preparing: ${step.label}.`,
-        details: { label: step.label, argv: step.argv, workdir: step.workdir },
-      });
-      await processRunner(step.argv[0], step.argv.slice(1), {
-        cwd: path.resolve(root, step.workdir),
-        env: resolvedEnvironment,
-        maxBytes: 32 * 1024 * 1024,
-        code: 'WORKSPACE_PREPARATION_FAILED',
-        signal,
-        timeoutMs,
-      });
-      commands.push({
-        label: step.label,
-        argv: step.argv,
-        workdir: step.workdir,
-      });
-      await emit(onEvent, {
-        type: 'genesis.workspace-preparation',
-        code: 'WORKSPACE_PREPARATION_COMPLETED',
-        message: `Prepared: ${step.label}.`,
-        details: { label: step.label, argv: step.argv, workdir: step.workdir },
-      });
-    }
-    return {
-      ...setup,
-      status: 'passed',
-      summary: `Prepared the workspace with ${commands.length} command${commands.length === 1 ? '' : 's'}.`,
-      commands,
-      diagnostics: [],
-    };
-  } catch (error) {
-    return {
-      ...setup,
-      status: 'failed',
-      summary: error.message,
-      commands,
-      diagnostics: [asDiagnostic(error)],
-    };
-  }
-}