refactor: migrate @object-ui/cli to @objectstack/plugin-ui with oclif commands

- Renamed package from @object-ui/cli to @objectstack/plugin-ui
- Created 15 oclif Command classes under src/commands/ui/
- Added @oclif/core dependency and oclif plugin configuration in package.json
- Updated tsup.config.ts with separate build configs for lib and oclif commands
- Preserved backward-compatible Commander.js CLI entry (cli.ts)
- Fixed pre-existing TS issues in dev.ts and start.ts surfaced by new build scope

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

packages/cli/package.json

@@ -1,7 +1,7 @@
 {
-  "name": "@object-ui/cli",
+  "name": "@objectstack/plugin-ui",
   "version": "3.0.3",
-  "description": "CLI tool for Object UI - Build applications from JSON schemas",
+  "description": "ObjectStack CLI plugin for Object UI — oclif-based UI toolchain commands (os ui dev, os ui build, etc.)",
   "type": "module",
   "homepage": "https://www.objectui.org",
   "repository": {
@@ -28,21 +28,29 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "lint": "eslint src"
+    "lint": "eslint src",
+    "test": "vitest run"
   },
   "keywords": [
+    "objectstack",
     "object-ui",
+    "oclif-plugin",
     "cli",
     "schema-driven",
     "ui-builder",
     "json"
   ],
-  "author": "ObjectQL Team",
+  "author": "ObjectStack Team",
   "license": "MIT",
+  "oclif": {
+    "commands": "./dist/commands",
+    "hooks": {}
+  },
   "dependencies": {
     "@object-ui/components": "workspace:*",
     "@object-ui/react": "workspace:*",
     "@object-ui/types": "workspace:*",
+    "@oclif/core": "^4.8.0",
     "@types/glob": "^9.0.0",
     "@vitejs/plugin-react": "^5.1.4",
     "chalk": "^5.6.2",
@@ -58,6 +66,7 @@
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^25.2.3",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   }
 }

packages/cli/src/commands/dev.ts

@@ -193,7 +193,7 @@ export async function dev(schemaPath: string, options: DevOptions) {
       // We might get the cjs entry, but for aliasing usually fine. 
       // Better yet, if we can find the package root, but require.resolve gives file.
       // Let's just use what require.resolve gives.
-      // @ts-expect-error - lucidePath is dynamically resolved
+      // @ts-ignore - lucidePath is dynamically resolved
       viteConfig.resolve.alias['lucide-react'] = lucidePath;
     } catch (e) {
       console.warn('⚠️ Could not resolve lucide-react automatically:', e);

packages/cli/src/commands/start.ts

@@ -62,7 +62,7 @@ export async function start(options: StartOptions) {
   app.use(express.static(distPath));
 
   // SPA fallback - serve index.html for all routes
-  app.get('*', (req, res) => {
+  app.get('*', (_req, res) => {
     res.sendFile(indexPath);
   });
 

packages/cli/src/commands/ui/add.ts

@@ -0,0 +1,30 @@
+/**
+ * ObjectUI — oclif plugin command
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Command, Args } from '@oclif/core';
+import chalk from 'chalk';
+import { add } from '../add.js';
+
+export default class Add extends Command {
+  static override description = 'Add a new component renderer to your project';
+
+  static override args = {
+    component: Args.string({
+      description: 'Component name (e.g. Input, Grid)',
+      required: true,
+    }),
+  };
+
+  async run(): Promise<void> {
+    const { args } = await this.parse(Add);
+    try {
+      await add(args.component);
+    } catch (error) {
+      this.error(chalk.red(error instanceof Error ? error.message : String(error)));
+    }
+  }
+}

packages/cli/src/commands/ui/analyze.ts

@@ -0,0 +1,37 @@
+/**
+ * ObjectUI — oclif plugin command
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { analyze } from '../analyze.js';
+
+export default class Analyze extends Command {
+  static override description = 'Analyze application performance';
+
+  static override flags = {
+    'bundle-size': Flags.boolean({
+      description: 'Analyze bundle size',
+      default: false,
+    }),
+    'render-performance': Flags.boolean({
+      description: 'Analyze render performance',
+      default: false,
+    }),
+  };
+
+  async run(): Promise<void> {
+    const { flags } = await this.parse(Analyze);
+    try {
+      await analyze({
+        bundleSize: flags['bundle-size'],
+        renderPerformance: flags['render-performance'],
+      });
+    } catch (error) {
+      this.error(chalk.red(error instanceof Error ? error.message : String(error)));
+    }
+  }
+}

packages/cli/src/commands/ui/build.ts

@@ -0,0 +1,45 @@
+/**
+ * ObjectUI — oclif plugin command
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Command, Args, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { buildApp } from '../build.js';
+
+export default class Build extends Command {
+  static override description = 'Build application for production';
+
+  static override args = {
+    schema: Args.string({
+      description: 'Path to JSON/YAML schema file',
+      default: 'app.json',
+    }),
+  };
+
+  static override flags = {
+    'out-dir': Flags.string({
+      char: 'o',
+      description: 'Output directory',
+      default: 'dist',
+    }),
+    clean: Flags.boolean({
+      description: 'Clean output directory before build',
+      default: false,
+    }),
+  };
+
+  async run(): Promise<void> {
+    const { args, flags } = await this.parse(Build);
+    try {
+      await buildApp(args.schema, {
+        outDir: flags['out-dir'],
+        clean: flags.clean,
+      });
+    } catch (error) {
+      this.error(chalk.red(error instanceof Error ? error.message : String(error)));
+    }
+  }
+}

packages/cli/src/commands/ui/check.ts

@@ -0,0 +1,22 @@
+/**
+ * ObjectUI — oclif plugin command
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Command } from '@oclif/core';
+import chalk from 'chalk';
+import { check } from '../check.js';
+
+export default class Check extends Command {
+  static override description = 'Validate schema files';
+
+  async run(): Promise<void> {
+    try {
+      await check();
+    } catch (error) {
+      this.error(chalk.red(error instanceof Error ? error.message : String(error)));
+    }
+  }
+}

packages/cli/src/commands/ui/create-plugin.ts

@@ -0,0 +1,30 @@
+/**
+ * ObjectUI — oclif plugin command
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Command, Args } from '@oclif/core';
+import chalk from 'chalk';
+import { createPlugin } from '../create-plugin.js';
+
+export default class CreatePlugin extends Command {
+  static override description = 'Create a new ObjectUI plugin';
+
+  static override args = {
+    name: Args.string({
+      description: 'Name of the plugin',
+      required: true,
+    }),
+  };
+
+  async run(): Promise<void> {
+    const { args } = await this.parse(CreatePlugin);
+    try {
+      await createPlugin(args.name);
+    } catch (error) {
+      this.error(chalk.red(error instanceof Error ? error.message : String(error)));
+    }
+  }
+}

packages/cli/src/commands/ui/dev.ts

@@ -0,0 +1,52 @@
+/**
+ * ObjectUI — oclif plugin command
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Command, Args, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { dev } from '../dev.js';
+
+export default class Dev extends Command {
+  static override description = 'Start development server (alias for serve)';
+
+  static override args = {
+    schema: Args.string({
+      description: 'Path to JSON/YAML schema file',
+      default: 'app.json',
+    }),
+  };
+
+  static override flags = {
+    port: Flags.string({
+      char: 'p',
+      description: 'Port to run the server on',
+      default: '3000',
+    }),
+    host: Flags.string({
+      char: 'H',
+      description: 'Host to bind the server to',
+      default: 'localhost',
+    }),
+    open: Flags.boolean({
+      description: 'Open browser automatically',
+      default: true,
+      allowNo: true,
+    }),
+  };
+
+  async run(): Promise<void> {
+    const { args, flags } = await this.parse(Dev);
+    try {
+      await dev(args.schema, {
+        port: flags.port,
+        host: flags.host,
+        open: flags.open,
+      });
+    } catch (error) {
+      this.error(chalk.red(error instanceof Error ? error.message : String(error)));
+    }
+  }
+}

packages/cli/src/commands/ui/doctor.ts

@@ -0,0 +1,22 @@
+/**
+ * ObjectUI — oclif plugin command
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Command } from '@oclif/core';
+import chalk from 'chalk';
+import { doctor } from '../doctor.js';
+
+export default class Doctor extends Command {
+  static override description = 'Diagnose and fix common issues';
+
+  async run(): Promise<void> {
+    try {
+      await doctor();
+    } catch (error) {
+      this.error(chalk.red(error instanceof Error ? error.message : String(error)));
+    }
+  }
+}