fix(cli): show help for a bare devframe invocation

Bare `devframe` (no subcommand) silently exited 0 — cac only shows help
automatically for an explicit -h/--help flag, not an unmatched command.
Check matchedCommand after parse() and fall back to outputHelp(), guarding
against the already-handled --help case so it doesn't print twice.

Author: antfubot

packages/devframe/src/cli/main.test.ts

@@ -0,0 +1,37 @@
+import { afterEach, describe, expect, it, vi } from 'vitest'
+import { runDevframeCli } from './main'
+
+describe('runDevframeCli', () => {
+  afterEach(() => {
+    vi.restoreAllMocks()
+  })
+
+  it('shows help for a bare invocation (no subcommand)', async () => {
+    const info = vi.spyOn(console, 'info').mockImplementation(() => {})
+    await runDevframeCli(['node', 'devframe'])
+    expect(info).toHaveBeenCalledTimes(1)
+    expect(info.mock.calls[0]![0]).toContain('connect')
+  })
+
+  it('shows help exactly once for --help (not doubled by the bare-invocation fallback)', async () => {
+    const info = vi.spyOn(console, 'info').mockImplementation(() => {})
+    await runDevframeCli(['node', 'devframe', '--help'])
+    expect(info).toHaveBeenCalledTimes(1)
+  })
+
+  it('shows help for an unrecognized subcommand', async () => {
+    const info = vi.spyOn(console, 'info').mockImplementation(() => {})
+    await runDevframeCli(['node', 'devframe', 'bogus'])
+    expect(info).toHaveBeenCalledTimes(1)
+  })
+
+  it('does not show help when a real subcommand matches', async () => {
+    const info = vi.spyOn(console, 'info').mockImplementation(() => {})
+    // `connect --help` matches the `connect` command and prints *its* help
+    // (cac's built-in per-command path) rather than the bare-invocation
+    // fallback — still exactly once.
+    await runDevframeCli(['node', 'devframe', 'connect', '--help'])
+    expect(info).toHaveBeenCalledTimes(1)
+    expect(info.mock.calls[0]![0]).toContain('--port')
+  })
+})

packages/devframe/src/cli/main.ts

@@ -28,5 +28,14 @@ export async function runDevframeCli(argv: string[] = process.argv): Promise<voi
 
   cli.help()
   cli.parse(argv, { run: false })
+  // A bare `devframe` (no subcommand) also leaves `matchedCommand` unset —
+  // same as `-h`/`--help`, which cac already prints help for internally.
+  // Only step in for the *other* unset case (no help flag, no command) so
+  // `--help` doesn't print twice.
+  if (!cli.matchedCommand) {
+    if (!cli.options.help)
+      cli.outputHelp()
+    return
+  }
   await cli.runMatchedCommand()
 }