code: function followFlow( flowRef ) {
        const name = basename( flowRef );
  
        return resolveRef( flowRef + '.json', paths.flows )
           .then( path => readJson( path ).then( flow => {
              const pages = values( flow.places )
                 .filter( hasField( 'page' ) )
                 .map( getField( 'page' ) )
                 .filter( unique() );
  
              return [ {
                 refs: [ flowRef ],
                 name,
                 path,
                 definition: flow,
                 descriptor: { name },
                 category: 'flows',
                 schemas: [ 'flow' ],
  
                 pages
              } ];
           } ) );
     }
docs: //////////////////////////////////////////////////////////////////////////////////////////////////////// 
  Collect meta information about a single flow.
  
  @private
  @memberOf ArtifactCollector
  @param {String} flowRef the flow reference (relative to `paths.flows`) to follow
  @return {Promise<Array>} a promise for an array with a single flow-meta object