From c9f8c1189f57014c13a331bfa7687c0fbd12f83d Mon Sep 17 00:00:00 2001
From: Patrik Oldsberg <poldsberg@gmail.com>
Date: Sun, 23 Jan 2022 16:20:27 +0100
Subject: [PATCH] cli: mark commands for planned deprecation

Signed-off-by: Patrik Oldsberg <poldsberg@gmail.com>
---
 packages/cli/src/commands/index.ts | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/cli/src/commands/index.ts b/packages/cli/src/commands/index.ts
index 54fe48e2cf..c9c06141c3 100644
--- a/packages/cli/src/commands/index.ts
+++ b/packages/cli/src/commands/index.ts
@@ -118,6 +118,7 @@ export function registerMigrateCommand(program: CommanderStatic) {
 }
 
 export function registerCommands(program: CommanderStatic) {
+  // TODO(Rugvip): Deprecate in favor of script variant
   program
     .command('app:build')
     .description('Build an app for a production release')
@@ -125,6 +126,7 @@ export function registerCommands(program: CommanderStatic) {
     .option(...configOption)
     .action(lazy(() => import('./app/build').then(m => m.default)));
 
+  // TODO(Rugvip): Deprecate in favor of script variant
   program
     .command('app:serve')
     .description('Serve an app for local development')
@@ -132,6 +134,7 @@ export function registerCommands(program: CommanderStatic) {
     .option(...configOption)
     .action(lazy(() => import('./app/serve').then(m => m.default)));
 
+  // TODO(Rugvip): Deprecate in favor of script variant
   program
     .command('backend:build')
     .description('Build a backend plugin')
@@ -139,6 +142,7 @@ export function registerCommands(program: CommanderStatic) {
     .option('--experimental-type-build', 'Enable experimental type build')
     .action(lazy(() => import('./backend/build').then(m => m.default)));
 
+  // TODO(Rugvip): Deprecate in favor of script variant
   program
     .command('backend:bundle')
     .description('Bundle the backend into a deployment archive')
@@ -148,6 +152,7 @@ export function registerCommands(program: CommanderStatic) {
     )
     .action(lazy(() => import('./backend/bundle').then(m => m.default)));
 
+  // TODO(Rugvip): Deprecate in favor of script variant
   program
     .command('backend:dev')
     .description('Start local development server with HMR for the backend')
@@ -196,6 +201,7 @@ export function registerCommands(program: CommanderStatic) {
       lazy(() => import('./create-plugin/createPlugin').then(m => m.default)),
     );
 
+  // TODO(Rugvip): Deprecate in favor of script variant
   program
     .command('plugin:build')
     .description('Build a plugin')
@@ -203,6 +209,7 @@ export function registerCommands(program: CommanderStatic) {
     .option('--experimental-type-build', 'Enable experimental type build')
     .action(lazy(() => import('./plugin/build').then(m => m.default)));
 
+  // TODO(Rugvip): Deprecate in favor of script variant
   program
     .command('plugin:serve')
     .description('Serves the dev/ folder of a plugin')
@@ -217,6 +224,7 @@ export function registerCommands(program: CommanderStatic) {
     .description('Diff an existing plugin with the creation template')
     .action(lazy(() => import('./plugin/diff').then(m => m.default)));
 
+  // TODO(Rugvip): Deprecate in favor of script variant
   program
     .command('build')
     .description('Build a package for publishing')
@@ -225,6 +233,7 @@ export function registerCommands(program: CommanderStatic) {
     .option('--experimental-type-build', 'Enable experimental type build')
     .action(lazy(() => import('./oldBuild').then(m => m.default)));
 
+  // TODO(Rugvip): Deprecate in favor of script variant
   program
     .command('lint')
     .option(
@@ -236,6 +245,7 @@ export function registerCommands(program: CommanderStatic) {
     .description('Lint a package')
     .action(lazy(() => import('./lint').then(m => m.default)));
 
+  // TODO(Rugvip): Deprecate in favor of script variant
   program
     .command('test')
     .allowUnknownOption(true) // Allows the command to run, but we still need to parse raw args
@@ -315,16 +325,19 @@ export function registerCommands(program: CommanderStatic) {
     .description('Check Backstage package versioning')
     .action(lazy(() => import('./versions/lint').then(m => m.default)));
 
+  // TODO(Rugvip): Deprecate in favor of script variant
   program
     .command('prepack')
     .description('Prepares a package for packaging before publishing')
     .action(lazy(() => import('./pack').then(m => m.pre)));
 
+  // TODO(Rugvip): Deprecate in favor of script variant
   program
     .command('postpack')
     .description('Restores the changes made by the prepack command')
     .action(lazy(() => import('./pack').then(m => m.post)));
 
+  // TODO(Rugvip): Deprecate in favor of script variant
   program
     .command('clean')
     .description('Delete cache directories')