fix: deprecate --file and add release

.changeset/rude-pets-begin.md

@@ -0,0 +1,5 @@
+---
+'@asyncapi/cli': minor
+---
+
+Deprecate the --file flag in `start studio` command

action-template.yml

@@ -1,5 +1,5 @@
-name: 'Generator, Validator, Converter and others - all in one for your AsyncAPI docs'
-description: 'Use this action to generate docs or code from your AsyncAPI document. Use default templates or provide your custom ones.'
+name: 'AsyncAPI CLI Action'
+description: 'One stop solution for all your AsyncAPI Specification needs in github actions.'
 inputs:
   cli_version:
     description: 'Version of AsyncAPI CLI to be used. This is only needed if you want to test with a specific version of AsyncAPI CLI. Default is latest which is also the recommended option.'

src/commands/start/studio.ts

@@ -15,15 +15,21 @@ export default class StartStudio extends Command {
 
   async run() {
     const { args, flags } = await this.parse(StartStudio);
-    let filePath = args['spec-file'];
+
+    if (flags.file) {
+      this.warn('The file flag has been removed and is being replaced by the argument spec-file. Please pass the filename directly like `asyncapi start studio asyncapi.yml`');
+    }
+
+    let filePath = args['spec-file'] ?? flags.file;
+
     const port = flags.port;
     if (!filePath) {
       try {
         filePath = ((await load()).getFilePath());
         this.log(`Loaded specification from: ${filePath}`);
       } catch (error) {
         filePath = '';
-        this.log('No file specified.');
+        this.error('No file specified.');
       }
     }
     try {

src/core/flags/start/studio.flags.ts

@@ -3,6 +3,7 @@ import { Flags } from '@oclif/core';
 export const studioFlags = () => {
   return {
     help: Flags.help({ char: 'h' }),
+    file: Flags.string({ char: 'f', description: 'path to the AsyncAPI file to link with Studio', deprecated: true }),
     port: Flags.integer({ char: 'p', description: 'port in which to start Studio' }),
   };
 };

src/core/models/Studio.ts

@@ -20,7 +20,7 @@
   return existsSync(filePath);
 }
 
 export function start(filePath: string, port: number = DEFAULT_PORT): void {
   if (filePath && !isValidFilePath(filePath)) {
     throw new SpecificationFileNotFound(filePath);
   }
@@ -115,8 +115,8 @@
     if (filePath) {
       console.log(`Watching changes on file ${filePath}`);
     } else {
-      console.log(
-        'Hint : No file was provided, and we couldn\'t find a default file (like "asyncapi.yaml" or "asyncapi.json") in the current folder. Starting Studio with a blank workspace.'
+      console.warn(
+        'Warning: No file was provided, and we couldn\'t find a default file (like "asyncapi.yaml" or "asyncapi.json") in the current folder. Starting Studio with a blank workspace.'
       );
     }
     open(url);