Function buildMissingVariablesError

packages/cli/src/utils/variable-check.ts:81–125

(
  commandType: 'workflow' | 'skill',
  targetId: string,
  targetName: string | undefined,
  result: CheckResult,
)

 * @returns Error payload suitable for fail()
 */
export function buildMissingVariablesError(
  commandType: 'workflow' | 'skill',
  targetId: string,
  targetName: string | undefined,
  result: CheckResult,
): {
  code: string;
  message: string;
  details: Record<string, unknown>;
  hint: string;
  suggestedFix: SuggestedFix;
  recoverable: true;
} {
  const displayName = targetName ? `"${targetName}"` : targetId;

  // Build suggested command based on command type
  const inputJson = JSON.stringify(result.suggestedInput);
  const suggestedCommand =
    commandType === 'workflow'
      ? `refly workflow run ${targetId} --input '${inputJson}'`
      : `refly skill run --name <name> --input '${inputJson}'`;

  return {
    code: 'MISSING_VARIABLES',
    message: `Missing required variables for ${commandType} ${displayName}`,
    details: {
      missingVariables: result.missing.map((v) => ({
        name: v.name,
        type: v.variableType || 'string',
        required: true,
        default: v.default,
        description: v.description,
      })),
      suggestedInput: result.suggestedInput,
      suggestedCommand,
    },
    hint: 'Provide the missing variables via --input. See suggestedInput for the expected format.',
    suggestedFix: {
      field: '--input',
      format: 'json-object',
      example: inputJson,
    },
    recoverable: true,
  };
}

/**
 * Convert workflow variables array to a simple key-value object.