From 19c2adb92d2d9a3b661260b3e24713f4b774d773 Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan.jait@bytedance.com>
Date: Fri, 31 Jul 2026 16:19:41 +0800
Subject: [PATCH 1/2] feat(cli): add format alias for fmt

---
 packages/rstack/src/cli/commands.ts         | 22 ++++++++++-----------
 packages/rstack/tests/cli/fmt/index.test.ts | 13 +++++++++++-
 2 files changed, 23 insertions(+), 12 deletions(-)

diff --git a/packages/rstack/src/cli/commands.ts b/packages/rstack/src/cli/commands.ts
index 6cdea3c..315ce4c 100644
--- a/packages/rstack/src/cli/commands.ts
+++ b/packages/rstack/src/cli/commands.ts
@@ -15,16 +15,16 @@ ${color.cyan('Usage')}:
 ${color.yellow('  $ rs [command] [...options]')}
 
 ${color.cyan('Commands')}:
-  dev      Run the app dev server
-  build    Build the app for production
-  preview  Preview the app production build
-  lib      Build library 
-  doc      Serve or build docs
-  fmt      Format code
-  lint     Lint code
-  test     Run tests
-  staged   Run tasks on staged Git files
-  setup    Install Git hooks
+  dev          Run the app dev server
+  build        Build the app for production
+  preview      Preview the app production build
+  lib          Build library
+  doc          Serve or build docs
+  fmt, format  Format code
+  lint         Lint code
+  test         Run tests
+  staged       Run tasks on staged Git files
+  setup        Install Git hooks
 
 ${color.dim(`For command-specific options, run:
   $ rs <command> -h`)}
@@ -144,7 +144,7 @@ export async function setupCommands(): Promise<void> {
     return;
   }
 
-  if (command === 'fmt') {
+  if (command === 'fmt' || command === 'format') {
     const { runFmtCLI } = await import(
       /* rspackChunkName: 'fmt' */
       '../fmt/cli.ts'
diff --git a/packages/rstack/tests/cli/fmt/index.test.ts b/packages/rstack/tests/cli/fmt/index.test.ts
index 6f30566..6312782 100644
--- a/packages/rstack/tests/cli/fmt/index.test.ts
+++ b/packages/rstack/tests/cli/fmt/index.test.ts
@@ -45,12 +45,23 @@ test('displays fmt help without loading config', () => {
   const fmt = runFmt(['--help']);
 
   expect(topLevel.status).toBe(0);
-  expect(topLevel.stdout).toContain('fmt      Format code');
+  expect(topLevel.stdout).toContain('fmt, format  Format code');
   expect(fmt.status).toBe(0);
   expect(fmt.stdout).toContain('Usage:\n  $ rs fmt [options] [files/globs...]');
   expect(fmt.stderr).toBe('');
 });
 
+test('supports format as an alias for fmt', () => {
+  writeProjectFile('index.ts', 'const message="hello"');
+
+  const result = runCLI(['format', 'index.ts']);
+
+  expect(result.status).toBe(0);
+  expect(result.stdout).toBe('index.ts\n');
+  expect(result.stderr).toBe('');
+  expect(readProjectFile('index.ts')).toBe('const message = "hello";\n');
+});
+
 test('returns exit code 1 for invalid arguments', () => {
   const result = runFmt(['--write', '--check']);
 

From c6fd26b19f09bb8beb54df1fb9a475029a6cfbd8 Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan.jait@bytedance.com>
Date: Fri, 31 Jul 2026 16:46:06 +0800
Subject: [PATCH 2/2] test: make setup help assertion spacing agnostic

---
 packages/rstack/tests/cli/setup/index.test.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/rstack/tests/cli/setup/index.test.ts b/packages/rstack/tests/cli/setup/index.test.ts
index 63d2e67..2429e69 100644
--- a/packages/rstack/tests/cli/setup/index.test.ts
+++ b/packages/rstack/tests/cli/setup/index.test.ts
@@ -43,7 +43,7 @@ afterEach(() => {
 });
 
 test('displays setup help', ({ execCli, expect }) => {
-  expect(execCli('--help', { cwd })).toContain('setup    Install Git hooks');
+  expect(execCli('--help', { cwd })).toMatch(/setup\s+Install Git hooks/);
 
   const output = execCli('setup --help', { cwd });