refactor: drop realms --add/--init/--remove/--llm hidden aliases

PR #15 introduced positional subcommands (realms add/remove/init/llm)
and kept the old flag forms as hidden aliases for backwards compat.
Since the restructure has not yet been released (still on PR), there
are no users to migrate. Clean break is simpler.

Per backspace's PR #15 review: "do we want backward compatibility?
IMO we might as well make a clean break as this is not officially
released."

- Remove 9 `.addOption(new Option('--xxx').hideHelp())` calls
- Remove legacy flag dispatcher `realmsCommand()` and RealmsOptions
- Drop unused `Option` import from commander

`boxel realms` with no subcommand still shows the list. The `list`
alias for `workspace-list` stays (backspace: "I think we can treat
list as a shorthand").

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Chris

src/commands/realms.ts

@@ -108,50 +108,6 @@ export async function realmsLlmCommand(): Promise<void> {
   console.log(generateLLMGuidance(config));
 }
 
-// Legacy flag-based interface (backwards compat)
-interface RealmsOptions {
-  add?: string;
-  remove?: string;
-  purpose?: string;
-  patterns?: string;
-  cardTypes?: string;
-  notes?: string;
-  default?: boolean;
-  llm?: boolean;
-  init?: boolean;
-}
-
-export async function realmsCommand(options: RealmsOptions): Promise<void> {
-  if (options.init) {
-    await realmsInitCommand();
-    return;
-  }
-
-  if (options.add) {
-    await realmsAddCommand(options.add, {
-      purpose: options.purpose,
-      patterns: options.patterns,
-      cardTypes: options.cardTypes,
-      notes: options.notes,
-      default: options.default,
-    });
-    return;
-  }
-
-  if (options.remove) {
-    await realmsRemoveCommand(options.remove);
-    return;
-  }
-
-  if (options.llm) {
-    await realmsLlmCommand();
-    return;
-  }
-
-  // Default: show summary
-  await realmsListCommand();
-}
-
 export async function updateRealmConfig(
   realmPath: string,
   updates: Partial<RealmConfig>

src/index.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import 'dotenv/config';
-import { Command, InvalidArgumentError, Option } from 'commander';
+import { Command, InvalidArgumentError } from 'commander';
 
 /** Parse a positive integer from a CLI flag; throw a friendly error otherwise. */
 function parsePositiveInt(raw: string, _prev: unknown): number {
@@ -30,7 +30,7 @@ import { editCommand } from './commands/edit.js';
 import { milestoneCommand } from './commands/milestone.js';
 import { shareCommand } from './commands/share.js';
 import { gatherCommand } from './commands/gather.js';
-import { realmsCommand, realmsListCommand, realmsAddCommand, realmsRemoveCommand, realmsInitCommand, realmsLlmCommand } from './commands/realms.js';
+import { realmsListCommand, realmsAddCommand, realmsRemoveCommand, realmsInitCommand, realmsLlmCommand } from './commands/realms.js';
 import { profileCommand } from './commands/profile.js';
 import { repairRealmCommand, repairRealmsCommand } from './commands/repair.js';
 import { consolidateWorkspacesCommand } from './commands/consolidate.js';
@@ -362,33 +362,9 @@ program
 const realmsCmd = program
   .command('realms')
   .description('Manage local realm configurations for development')
-  .addOption(new Option('--init').hideHelp())
-  .addOption(new Option('--add <path>').hideHelp())
-  .addOption(new Option('--remove <path>').hideHelp())
-  .addOption(new Option('--purpose <text>').hideHelp())
-  .addOption(new Option('--patterns <list>').hideHelp())
-  .addOption(new Option('--card-types <list>').hideHelp())
-  .addOption(new Option('--notes <text>').hideHelp())
-  .addOption(new Option('--default').hideHelp())
-  .addOption(new Option('--llm').hideHelp())
-  .action(async (options: {
-    init?: boolean;
-    add?: string;
-    remove?: string;
-    purpose?: string;
-    patterns?: string;
-    cardTypes?: string;
-    notes?: string;
-    default?: boolean;
-    llm?: boolean;
-  }) => {
-    // Handle legacy flag-based usage
-    if (options.init || options.add || options.remove || options.llm) {
-      await realmsCommand(options);
-    } else {
-      // Default: show list
-      await realmsListCommand();
-    }
+  .action(async () => {
+    // `boxel realms` with no subcommand shows the list
+    await realmsListCommand();
   });
 
 realmsCmd