orbital-command 0.1.4 → 0.3.0

package/bin/orbital.js

@@ -31,6 +31,11 @@ function resolveBin(name) {
 // CLI Helpers
 // ---------------------------------------------------------------------------
 
+function getFlagValue(args, flag) {
+  const idx = args.indexOf(flag);
+  return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
+}
+
 function detectProjectRoot() {
   try {
     return execFileSync('git', ['rev-parse', '--show-toplevel'], { encoding: 'utf8' }).trim();
@@ -131,59 +136,152 @@ async function loadSharedModule() {
   }
 }
 
+/**
+ * Load the interactive wizard module.
+ */
+async function loadWizardModule() {
+  try {
+    return await import('../dist/server/server/wizard/index.js');
+  } catch {
+    try {
+      return await import('../server/wizard/index.js');
+    } catch {
+      console.error('Error: Wizard module not found.');
+      console.error('Try reinstalling: npm install -g orbital-command');
+      process.exit(1);
+    }
+  }
+}
+
 // ---------------------------------------------------------------------------
 // Commands
 // ---------------------------------------------------------------------------
 
+function orbitalSetupDone() {
+  return fs.existsSync(path.join(ORBITAL_HOME, 'config.json'));
+}
+
+function autoRegisterProject(projectRoot) {
+  if (!fs.existsSync(ORBITAL_HOME)) fs.mkdirSync(ORBITAL_HOME, { recursive: true });
+  const registry = loadRegistry();
+  if (!(registry.projects || []).some(p => p.path === projectRoot)) {
+    cmdRegister([projectRoot]);
+  }
+}
+
 async function cmdInit(args) {
-  const force = args.includes('--force');
+  const isYes = args.includes('--yes') || args.includes('-y');
+  const isInteractive = process.stdout.isTTY && !process.env.CI && !isYes;
   const projectRoot = detectProjectRoot();
 
-  const { runInit } = await loadSharedModule();
-  runInit(projectRoot, { force });
+  if (isInteractive) {
+    const wiz = await loadWizardModule();
+    const version = getPackageVersion();
 
+    // If Orbital hasn't been set up yet, run Phase 1 first
+    if (!orbitalSetupDone()) {
+      await wiz.runSetupWizard(version);
+    }
+
+    // Phase 2: project setup for current directory
+    await wiz.runProjectSetup(projectRoot, version, args);
+    stampTemplateVersion(projectRoot);
+    return;
+  }
+
+  // Non-interactive / --yes fallback (existing behavior preserved)
+  const force = args.includes('--force');
+  const globalPrivate = loadRegistry().privateMode === true;
+  const isPrivate = args.includes('--private') || globalPrivate;
+  const preset = getFlagValue(args, '--preset');
+  const projectName = getFlagValue(args, '--project-name');
+  const serverPort = getFlagValue(args, '--server-port');
+  const clientPort = getFlagValue(args, '--client-port');
+
+  const { runInit } = await loadSharedModule();
+  runInit(projectRoot, {
+    force,
+    preset: preset || undefined,
+    projectName: projectName || undefined,
+    serverPort: serverPort ? Number(serverPort) : undefined,
+    clientPort: clientPort ? Number(clientPort) : undefined,
+  });
   stampTemplateVersion(projectRoot);
-  console.log(`Run \`orbital dev\` to start the development server.\n`);
+
+  if (isPrivate) {
+    const configPath = path.join(projectRoot, '.claude', 'orbital.config.json');
+    if (fs.existsSync(configPath)) {
+      try {
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        if (!config.telemetry) config.telemetry = {};
+        config.telemetry.enabled = false;
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+
+      } catch { /* leave config as-is */ }
+    }
+  }
+
+  autoRegisterProject(projectRoot);
+  console.log(`Run \`orbital launch\` to start the dashboard.\n`);
 }
 
-function cmdDev() {
+function cmdLaunchOrDev(forceViteFlag) {
   const shouldOpen = process.argv.includes('--open');
+  const forceVite = forceViteFlag || process.argv.includes('--vite');
   const projectRoot = detectProjectRoot();
   const config = loadConfig(projectRoot);
   const serverPort = config.serverPort || 4444;
   const clientPort = config.clientPort || 4445;
 
-  console.log(`\nOrbital Command — dev`);
+  autoRegisterProject(projectRoot);
+
+  // Detect packaged mode: dist/index.html exists → serve pre-built frontend
+  const hasPrebuiltFrontend = fs.existsSync(path.join(PACKAGE_ROOT, 'dist', 'index.html'));
+  const useVite = forceVite || !hasPrebuiltFrontend;
+
+  console.log(`\nOrbital Command — ${useVite ? 'dev' : 'launch'}`);
   console.log(`Project root: ${projectRoot}`);
-  console.log(`Server: http://localhost:${serverPort}`);
-  console.log(`Client: http://localhost:${clientPort}\n`);
+  if (useVite) {
+    console.log(`Server: http://localhost:${serverPort}`);
+    console.log(`Client: http://localhost:${clientPort} (Vite dev server)\n`);
+  } else {
+    console.log(`Dashboard: http://localhost:${serverPort}\n`);
+  }
 
   checkTemplatesStaleness(projectRoot);
 
   const env = {
     ...process.env,
-    ORBITAL_PROJECT_ROOT: projectRoot,
+    ORBITAL_LAUNCH_MODE: 'central',
+    ORBITAL_AUTO_REGISTER: projectRoot,
     ORBITAL_SERVER_PORT: String(serverPort),
   };
 
-  // Start the API server
+  const serverScript = path.join(PACKAGE_ROOT, 'server', 'launch.ts');
   const tsxBin = resolveBin('tsx');
   const serverProcess = tsxBin
-    ? spawn(tsxBin, ['watch', path.join(PACKAGE_ROOT, 'server', 'index.ts')],
+    ? spawn(tsxBin, ['watch', serverScript],
         { stdio: 'inherit', env, cwd: PACKAGE_ROOT })
-    : spawn('npx', ['tsx', 'watch', path.join(PACKAGE_ROOT, 'server', 'index.ts')],
+    : spawn('npx', ['tsx', 'watch', serverScript],
         { stdio: 'inherit', env, cwd: PACKAGE_ROOT });
 
-  // Start the Vite dev server
-  const viteBin = resolveBin('vite');
-  const viteProcess = viteBin
-    ? spawn(viteBin, ['--config', path.join(PACKAGE_ROOT, 'vite.config.ts'), '--port', String(clientPort)],
-        { stdio: 'inherit', env, cwd: PACKAGE_ROOT })
-    : spawn('npx', ['vite', '--config', path.join(PACKAGE_ROOT, 'vite.config.ts'), '--port', String(clientPort)],
-        { stdio: 'inherit', env, cwd: PACKAGE_ROOT });
+  let viteProcess = null;
+
+  if (useVite) {
+    const viteBin = resolveBin('vite');
+    viteProcess = viteBin
+      ? spawn(viteBin, ['--config', path.join(PACKAGE_ROOT, 'vite.config.ts'), '--port', String(clientPort)],
+          { stdio: 'inherit', env, cwd: PACKAGE_ROOT })
+      : spawn('npx', ['vite', '--config', path.join(PACKAGE_ROOT, 'vite.config.ts'), '--port', String(clientPort)],
+          { stdio: 'inherit', env, cwd: PACKAGE_ROOT });
+  }
+
+  const dashboardUrl = useVite
+    ? `http://localhost:${clientPort}`
+    : `http://localhost:${serverPort}`;
 
   if (shouldOpen) {
-    setTimeout(() => openBrowser(`http://localhost:${clientPort}`), 2000);
+    setTimeout(() => openBrowser(dashboardUrl), 2000);
   }
 
   let exiting = false;
@@ -192,7 +290,7 @@ function cmdDev() {
     if (exiting) return;
     exiting = true;
     serverProcess.kill();
-    viteProcess.kill();
+    if (viteProcess) viteProcess.kill();
     process.exit(0);
   }
   process.on('SIGINT', cleanup);
@@ -202,16 +300,18 @@ function cmdDev() {
     if (exiting) return;
     exiting = true;
     console.log(`Server exited with code ${code}`);
-    viteProcess.kill();
-    process.exit(code || 0);
-  });
-  viteProcess.on('exit', (code) => {
-    if (exiting) return;
-    exiting = true;
-    console.log(`Vite exited with code ${code}`);
-    serverProcess.kill();
+    if (viteProcess) viteProcess.kill();
     process.exit(code || 0);
   });
+  if (viteProcess) {
+    viteProcess.on('exit', (code) => {
+      if (exiting) return;
+      exiting = true;
+      console.log(`Vite exited with code ${code}`);
+      serverProcess.kill();
+      process.exit(code || 0);
+    });
+  }
 }
 
 function cmdBuild() {
@@ -265,20 +365,442 @@ function cmdEmit(args) {
   console.log(`  File: ${path.relative(projectRoot, filePath)}`);
 }
 
-async function cmdUpdate() {
+async function cmdUpdate(args) {
   const projectRoot = detectProjectRoot();
+  const dryRun = args.includes('--dry-run');
 
   const { runUpdate } = await loadSharedModule();
-  runUpdate(projectRoot);
+  runUpdate(projectRoot, { dryRun });
 
-  stampTemplateVersion(projectRoot);
+  if (!dryRun) stampTemplateVersion(projectRoot);
 }
 
-async function cmdUninstall() {
+async function cmdUninstall(args) {
   const projectRoot = detectProjectRoot();
+  const dryRun = args.includes('--dry-run');
+  const keepConfig = args.includes('--keep-config');
 
   const { runUninstall } = await loadSharedModule();
-  runUninstall(projectRoot);
+  runUninstall(projectRoot, { dryRun, keepConfig });
+}
+
+// ---------------------------------------------------------------------------
+// Manifest management commands
+// ---------------------------------------------------------------------------
+
+async function cmdValidate() {
+  const projectRoot = detectProjectRoot();
+
+  const mod = await loadSharedModule();
+  const report = mod.validate(projectRoot, getPackageVersion());
+  console.log(mod.formatValidationReport(report));
+  process.exit(report.errors > 0 ? 1 : 0);
+}
+
+async function cmdStatus() {
+  const projectRoot = detectProjectRoot();
+
+  const mod = await loadSharedModule();
+  const manifest = mod.loadManifest(projectRoot);
+
+  if (!manifest) {
+    console.log('\nNo manifest found. Run `orbital init` or `orbital update` to create one.\n');
+    return;
+  }
+
+  const claudeDir = path.join(projectRoot, '.claude');
+  mod.refreshFileStatuses(manifest, claudeDir);
+
+  const summary = mod.summarizeManifest(manifest);
+  const packageVersion = getPackageVersion();
+  const needsUpdate = manifest.packageVersion !== packageVersion;
+
+  console.log(`\nOrbital Command v${packageVersion}${needsUpdate ? ` (installed: ${manifest.packageVersion} → needs update)` : ''}\n`);
+
+  for (const [type, counts] of Object.entries(summary.byType)) {
+    const parts = [];
+    if (counts.synced) parts.push(`${counts.synced} synced`);
+    if (counts.outdated) parts.push(`${counts.outdated} outdated`);
+    if (counts.modified) parts.push(`${counts.modified} modified`);
+    if (counts.pinned) parts.push(`${counts.pinned} pinned`);
+    if (counts.userOwned) parts.push(`${counts.userOwned} user-owned`);
+    console.log(`  ${type.padEnd(16)} ${parts.join(', ')}`);
+  }
+
+  // Show outdated files (template moved ahead, user hasn't touched)
+  const outdated = Object.entries(manifest.files)
+    .filter(([, r]) => r.status === 'outdated');
+  if (outdated.length > 0) {
+    console.log('\n  Outdated files (safe to update):');
+    for (const [file] of outdated) {
+      console.log(`    ${file}`);
+    }
+  }
+
+  // Show modified files (user edited)
+  const modified = Object.entries(manifest.files)
+    .filter(([, r]) => r.status === 'modified');
+  if (modified.length > 0) {
+    console.log('\n  Modified files (user edited):');
+    for (const [file] of modified) {
+      console.log(`    ${file}  (run 'orbital diff ${file}')`);
+    }
+  }
+
+  // Show pinned files
+  const pinned = Object.entries(manifest.files)
+    .filter(([, r]) => r.status === 'pinned');
+  if (pinned.length > 0) {
+    console.log('\n  Pinned files:');
+    for (const [file, record] of pinned) {
+      const reason = record.pinnedReason ? `"${record.pinnedReason}"` : '';
+      console.log(`    ${file}  ${reason}`);
+    }
+  }
+
+  console.log();
+}
+
+async function cmdPin(args) {
+  const projectRoot = detectProjectRoot();
+  const filePath = args.find(a => !a.startsWith('--'));
+  const reasonIdx = args.indexOf('--reason');
+  const reason = reasonIdx !== -1 ? args[reasonIdx + 1] : undefined;
+
+  if (!filePath) {
+    console.error('Usage: orbital pin <relative-path> [--reason "..."]');
+    process.exit(1);
+  }
+
+  const mod = await loadSharedModule();
+  const manifest = mod.loadManifest(projectRoot);
+  if (!manifest) {
+    console.error('No manifest found. Run `orbital init` first.');
+    process.exit(1);
+  }
+
+  const record = manifest.files[filePath];
+  if (!record) {
+    console.error(`File not tracked: ${filePath}`);
+    process.exit(1);
+  }
+  if (record.origin === 'user') {
+    console.error(`Cannot pin user-owned file: ${filePath}`);
+    process.exit(1);
+  }
+
+  record.status = 'pinned';
+  record.pinnedAt = new Date().toISOString();
+  if (reason) record.pinnedReason = reason;
+
+  mod.saveManifest(projectRoot, manifest);
+  console.log(`Pinned: ${filePath}${reason ? ` (${reason})` : ''}`);
+}
+
+async function cmdUnpin(args) {
+  const projectRoot = detectProjectRoot();
+  const filePath = args[0];
+
+  if (!filePath) {
+    console.error('Usage: orbital unpin <relative-path>');
+    process.exit(1);
+  }
+
+  const mod = await loadSharedModule();
+  const manifest = mod.loadManifest(projectRoot);
+  if (!manifest) {
+    console.error('No manifest found. Run `orbital init` first.');
+    process.exit(1);
+  }
+
+  const record = manifest.files[filePath];
+  if (!record || record.status !== 'pinned') {
+    console.error(`File is not pinned: ${filePath}`);
+    process.exit(1);
+  }
+
+  // Clear pinned state, then recompute
+  record.status = 'synced';
+  delete record.pinnedAt;
+  delete record.pinnedReason;
+
+  const absPath = path.join(projectRoot, '.claude', filePath);
+  if (fs.existsSync(absPath)) {
+    const currentHash = mod.hashFile(absPath);
+    record.status = mod.computeFileStatus(record, currentHash);
+  } else {
+    record.status = 'synced';
+  }
+
+  mod.saveManifest(projectRoot, manifest);
+  console.log(`Unpinned: ${filePath} (now ${record.status})`);
+}
+
+async function cmdPins() {
+  const projectRoot = detectProjectRoot();
+
+  const mod = await loadSharedModule();
+  const manifest = mod.loadManifest(projectRoot);
+  if (!manifest) {
+    console.error('No manifest found. Run `orbital init` first.');
+    process.exit(1);
+  }
+
+  const pinned = Object.entries(manifest.files)
+    .filter(([, r]) => r.status === 'pinned');
+
+  if (pinned.length === 0) {
+    console.log('No pinned files.');
+    return;
+  }
+
+  console.log(`\n  Pinned files:\n`);
+  for (const [file, record] of pinned) {
+    const reason = record.pinnedReason || '(no reason)';
+    const date = record.pinnedAt ? new Date(record.pinnedAt).toLocaleDateString() : '';
+    console.log(`  ${file}`);
+    console.log(`    Reason: ${reason}  Pinned: ${date}`);
+    if (record.templateHash !== record.installedHash) {
+      console.log(`    Template has changed since pin — run 'orbital diff ${file}' to compare`);
+    }
+  }
+  console.log();
+}
+
+async function cmdDiff(args) {
+  const projectRoot = detectProjectRoot();
+  const filePath = args[0];
+
+  if (!filePath) {
+    console.error('Usage: orbital diff <relative-path>');
+    process.exit(1);
+  }
+
+  const mod = await loadSharedModule();
+  const manifest = mod.loadManifest(projectRoot);
+  if (!manifest) {
+    console.error('No manifest found. Run `orbital init` first.');
+    process.exit(1);
+  }
+
+  const record = manifest.files[filePath];
+  if (!record || record.origin !== 'template') {
+    console.error(`Not a template file: ${filePath}`);
+    process.exit(1);
+  }
+
+  // Resolve template path
+  let templateRelPath = filePath;
+  if (filePath.startsWith('config/workflows/')) {
+    templateRelPath = filePath.replace('config/workflows/', 'presets/');
+  }
+
+  const templatePath = path.join(PACKAGE_ROOT, 'templates', templateRelPath);
+  const localPath = path.join(projectRoot, '.claude', filePath);
+
+  if (!fs.existsSync(templatePath)) {
+    console.error(`Template file not found: ${templateRelPath}`);
+    process.exit(1);
+  }
+  if (!fs.existsSync(localPath)) {
+    console.log('Local file does not exist. Template content:');
+    console.log(fs.readFileSync(templatePath, 'utf-8'));
+    return;
+  }
+
+  // Use git diff for nice formatting (safe: no user input in arguments)
+  const { execFileSync } = await import('child_process');
+  try {
+    const output = execFileSync(
+      'git', ['diff', '--no-index', '--color', '--', templatePath, localPath],
+      { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
+    );
+    console.log(output);
+  } catch (e) {
+    // git diff exits 1 when files differ — that's expected
+    if (e.stdout) console.log(e.stdout);
+    else console.log('Files differ but git diff is unavailable.');
+  }
+}
+
+async function cmdReset(args) {
+  const projectRoot = detectProjectRoot();
+  const filePath = args[0];
+
+  if (!filePath) {
+    console.error('Usage: orbital reset <relative-path>');
+    process.exit(1);
+  }
+
+  const mod = await loadSharedModule();
+  const manifest = mod.loadManifest(projectRoot);
+  if (!manifest) {
+    console.error('No manifest found. Run `orbital init` first.');
+    process.exit(1);
+  }
+
+  const record = manifest.files[filePath];
+  if (!record || record.origin !== 'template') {
+    console.error(`Not a template file: ${filePath}`);
+    process.exit(1);
+  }
+
+  // Resolve and copy template file
+  let templateRelPath = filePath;
+  if (filePath.startsWith('config/workflows/')) {
+    templateRelPath = filePath.replace('config/workflows/', 'presets/');
+  }
+
+  const templatePath = path.join(PACKAGE_ROOT, 'templates', templateRelPath);
+  const localPath = path.join(projectRoot, '.claude', filePath);
+
+  if (!fs.existsSync(templatePath)) {
+    console.error(`Template file not found: ${templateRelPath}`);
+    process.exit(1);
+  }
+
+  fs.copyFileSync(templatePath, localPath);
+  const newHash = mod.hashFile(localPath);
+  record.status = 'synced';
+  record.templateHash = newHash;
+  record.installedHash = newHash;
+  delete record.pinnedAt;
+  delete record.pinnedReason;
+
+  mod.saveManifest(projectRoot, manifest);
+  console.log(`Reset: ${filePath} → synced with template`);
+}
+
+// ---------------------------------------------------------------------------
+// Multi-project commands
+// ---------------------------------------------------------------------------
+
+const ORBITAL_HOME = path.join(process.env.HOME || process.env.USERPROFILE || '~', '.orbital');
+const REGISTRY_PATH = path.join(ORBITAL_HOME, 'config.json');
+
+function loadRegistry() {
+  if (!fs.existsSync(REGISTRY_PATH)) return { version: 1, projects: [] };
+  try {
+    return JSON.parse(fs.readFileSync(REGISTRY_PATH, 'utf8'));
+  } catch {
+    return { version: 1, projects: [] };
+  }
+}
+
+// cmdLaunch removed — merged into cmdLaunchOrDev() above
+
+function cmdRegister(args) {
+  const targetPath = args[0] ? path.resolve(args[0]) : detectProjectRoot();
+  const nameFlag = args.indexOf('--alias');
+  const name = nameFlag >= 0 ? args[nameFlag + 1] : path.basename(targetPath);
+
+  // Ensure ~/.orbital/ exists
+  if (!fs.existsSync(ORBITAL_HOME)) fs.mkdirSync(ORBITAL_HOME, { recursive: true });
+
+  // Check the project has been initialized
+  if (!fs.existsSync(path.join(targetPath, '.claude'))) {
+    console.error(`Error: ${targetPath} has not been initialized with Orbital Command.`);
+    console.error(`Run \`orbital init\` in that directory first.`);
+    process.exit(1);
+  }
+
+  const registry = loadRegistry();
+
+  // Check if already registered
+  if (registry.projects?.some(p => p.path === targetPath)) {
+    console.log(`Project already registered: ${targetPath}`);
+    return;
+  }
+
+  // Color palette
+  const COLORS = [
+    '210 80% 55%', '340 75% 55%', '160 60% 45%', '30 90% 55%',
+    '270 65% 55%', '50 85% 50%', '180 55% 45%', '0 70% 55%',
+    '120 50% 42%', '300 60% 50%', '200 70% 50%', '15 80% 55%',
+  ];
+  const usedColors = (registry.projects || []).map(p => p.color);
+  const color = COLORS.find(c => !usedColors.includes(c)) || COLORS[0];
+
+  // Generate slug
+  const baseSlug = path.basename(targetPath).toLowerCase().replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '') || 'project';
+  const existingIds = (registry.projects || []).map(p => p.id);
+  const slug = existingIds.includes(baseSlug)
+    ? `${baseSlug}-${crypto.createHash('sha256').update(targetPath).digest('hex').slice(0, 4)}`
+    : baseSlug;
+
+  const project = {
+    id: slug,
+    path: targetPath,
+    name,
+    color,
+    registeredAt: new Date().toISOString(),
+    enabled: true,
+  };
+
+  if (!registry.projects) registry.projects = [];
+  registry.projects.push(project);
+  fs.writeFileSync(REGISTRY_PATH, JSON.stringify(registry, null, 2), 'utf8');
+
+  console.log(`Registered project: ${name}`);
+  console.log(`  ID:    ${slug}`);
+  console.log(`  Path:  ${targetPath}`);
+  console.log(`  Color: ${color}`);
+}
+
+function cmdUnregister(args) {
+  const idOrPath = args[0];
+  if (!idOrPath) {
+    console.error('Usage: orbital unregister <id-or-path>');
+    process.exit(1);
+  }
+
+  const absPath = path.isAbsolute(idOrPath) ? idOrPath : path.resolve(idOrPath);
+  const registry = loadRegistry();
+  const idx = (registry.projects || []).findIndex(p => p.id === idOrPath || p.path === absPath);
+
+  if (idx === -1) {
+    console.error(`Project not found: ${idOrPath}`);
+    process.exit(1);
+  }
+
+  const removed = registry.projects.splice(idx, 1)[0];
+  fs.writeFileSync(REGISTRY_PATH, JSON.stringify(registry, null, 2), 'utf8');
+
+  console.log(`Unregistered project: ${removed.name} (${removed.id})`);
+  console.log(`  Project files in ${removed.path} are preserved.`);
+}
+
+function cmdProjects() {
+  const registry = loadRegistry();
+  const projects = registry.projects || [];
+
+  if (projects.length === 0) {
+    console.log('\nNo projects registered.');
+    console.log('Use `orbital register` or `orbital init` to add a project.\n');
+    return;
+  }
+
+  console.log(`\n  ${'ID'.padEnd(22)} ${'NAME'.padEnd(22)} ${'STATUS'.padEnd(10)} PATH`);
+  console.log(`  ${'─'.repeat(22)} ${'─'.repeat(22)} ${'─'.repeat(10)} ${'─'.repeat(30)}`);
+  for (const p of projects) {
+    const status = p.enabled ? (fs.existsSync(p.path) ? 'active' : 'offline') : 'disabled';
+    console.log(`  ${p.id.padEnd(22)} ${p.name.padEnd(22)} ${status.padEnd(10)} ${p.path}`);
+  }
+  console.log();
+}
+
+async function cmdConfig(args) {
+  const { runConfigEditor } = await loadWizardModule();
+  const projectRoot = detectProjectRoot();
+  const version = getPackageVersion();
+  await runConfigEditor(projectRoot, version, args);
+}
+
+async function cmdDoctor() {
+  const { runDoctor } = await loadWizardModule();
+  const projectRoot = detectProjectRoot();
+  const version = getPackageVersion();
+  await runDoctor(projectRoot, version);
 }
 
 function printHelp() {
@@ -289,29 +811,66 @@ Usage:
   orbital <command> [options]
 
 Commands:
-  init              Scaffold Orbital Command into the current project
-  dev               Start the development server (API + Vite)
-  build             Production build of the dashboard
+  init              Set up Orbital Command (interactive wizard)
+  launch            Start the dashboard
+  config            Modify project settings interactively
+  doctor            Health check and version diagnostics
+  update            Sync templates and apply migrations
+  status            Show template sync status
+
+Aliases:
+  setup             Same as init
+  dev               Same as launch --vite (development with HMR)
+
+Config Subcommands:
+  config show       Print current config as JSON
+  config set <k> <v> Set a config value non-interactively
+
+Template Management:
+  validate          Check cross-references and consistency
+  pin <path>        Lock a file from updates
+  unpin <path>      Unlock a pinned file
+  pins              List all pinned files
+  diff <path>       Show diff between template and local file
+  reset <path>      Restore a file from the current template
+
+Project Management:
+  register [path]   Register a project with the dashboard
+  unregister <id>   Remove a project from the dashboard
+  projects          List all registered projects
+
+Other:
+  build             Production build of the dashboard frontend
   emit <TYPE> <JSON>  Emit an orbital event
-  update            Re-copy hooks/skills/agents from package templates
   uninstall         Remove Orbital artifacts from the project
 
 Init Options:
-  --force           Overwrite existing hooks, skills, and agents
-  --skip-plugins    Skip plugin installation
-  --yes, -y         Auto-accept all prompts
+  --force              Overwrite existing hooks, skills, and agents
+  --yes, -y            Skip the wizard, use auto-detected defaults
+  --private            Disable telemetry for this project
+  --preset <name>      Workflow preset (default/minimal/development/gitflow)
+  --project-name <n>   Override auto-detected project name
+  --server-port <n>    Override default server port (4444)
+  --client-port <n>    Override default client port (4445)
+
+Launch Options:
+  --open            Open the dashboard in the browser
+  --vite            Force Vite dev server for HMR
+
+Update Options:
+  --dry-run         Preview changes without applying them
 
-Dev Options:
-  --open            Open the dashboard in the default browser
+Uninstall Options:
+  --dry-run         Preview removal without applying
+  --keep-config     Keep orbital.config.json for re-initialization
 
 Examples:
   orbital init
-  orbital init --force
-  orbital dev
-  orbital dev --open
-  orbital emit SCOPE_TRANSITION '{"scope":"042","from":"implementing","to":"review"}'
-  orbital update
-  orbital uninstall
+  orbital launch --open
+  orbital config
+  orbital doctor
+  orbital update --dry-run
+  orbital status
 `);
 }
 
@@ -323,11 +882,30 @@ const [command, ...args] = process.argv.slice(2);
 
 async function main() {
   switch (command) {
+    case 'launch':
+      cmdLaunchOrDev(false);
+      break;
     case 'init':
+    case 'setup':
       await cmdInit(args);
       break;
+    case 'config':
+      await cmdConfig(args);
+      break;
+    case 'doctor':
+      await cmdDoctor();
+      break;
     case 'dev':
-      cmdDev();
+      cmdLaunchOrDev(true);
+      break;
+    case 'register':
+      cmdRegister(args);
+      break;
+    case 'unregister':
+      cmdUnregister(args);
+      break;
+    case 'projects':
+      cmdProjects();
       break;
     case 'build':
       cmdBuild();
@@ -336,18 +914,63 @@ async function main() {
       cmdEmit(args);
       break;
     case 'update':
-      await cmdUpdate();
+      await cmdUpdate(args);
       break;
     case 'uninstall':
-      await cmdUninstall();
+      await cmdUninstall(args);
+      break;
+    case 'status':
+      await cmdStatus();
+      break;
+    case 'validate':
+      await cmdValidate();
+      break;
+    case 'pin':
+      await cmdPin(args);
+      break;
+    case 'unpin':
+      await cmdUnpin(args);
       break;
+    case 'pins':
+      await cmdPins();
+      break;
+    case 'diff':
+      await cmdDiff(args);
+      break;
+    case 'reset':
+      await cmdReset(args);
+      break;
+    case 'private': {
+      const registry = loadRegistry();
+      const enable = args[0] !== 'off';
+      registry.privateMode = enable;
+      if (!fs.existsSync(ORBITAL_HOME)) fs.mkdirSync(ORBITAL_HOME, { recursive: true });
+      fs.writeFileSync(REGISTRY_PATH, JSON.stringify(registry, null, 2), 'utf8');
+      console.log(`Private mode ${enable ? 'enabled' : 'disabled'} globally.`);
+
+      break;
+    }
     case 'help':
     case '--help':
     case '-h':
       printHelp();
       break;
     case undefined:
-      printHelp();
+      if (process.stdout.isTTY && !process.env.CI) {
+        const wiz = await loadWizardModule();
+        const version = getPackageVersion();
+        if (!orbitalSetupDone()) {
+          // First time — run Phase 1 setup
+          await wiz.runSetupWizard(version);
+        } else {
+          // Already set up — run Phase 2 for current directory
+          const projectRoot = detectProjectRoot();
+          await wiz.runProjectSetup(projectRoot, version, []);
+          stampTemplateVersion(projectRoot);
+        }
+      } else {
+        printHelp();
+      }
       break;
     default:
       console.error(`Unknown command: ${command}`);