@objectstack/cli 2.0.6 → 3.0.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @objectstack/cli@2.0.6 build /home/runner/work/spec/spec/packages/cli
+> @objectstack/cli@3.0.0 build /home/runner/work/spec/spec/packages/cli
 > tsup
 
 CLI Building entry: src/bin.ts
@@ -15,10 +15,14 @@
 ESM Build start
 CLI Cleaning output folder
 ESM Build start
-ESM dist/index.js 58.94 KB
-ESM ⚡️ Build success in 158ms
-ESM dist/bin.js 61.55 KB
+ESM dist/index.js           69.92 KB
+ESM dist/config-UN34WBHT.js 151.00 B
+ESM dist/chunk-CSHQEILI.js  7.29 KB
+ESM ⚡️ Build success in 188ms
+ESM dist/bin.js             72.87 KB
+ESM dist/config-A7BN6UIT.js 171.00 B
+ESM dist/chunk-Q74JNWKD.js  7.31 KB
 ESM ⚡️ Build success in 186ms
 DTS Build start
-DTS ⚡️ Build success in 7538ms
-DTS dist/index.d.ts 2.93 KB
+DTS ⚡️ Build success in 9514ms
+DTS dist/index.d.ts 3.42 KB

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @objectstack/cli
 
+## 3.0.0
+
+### Major Changes
+
+- Release v3.0.0 — unified version bump for all ObjectStack packages.
+
+### Patch Changes
+
+- Updated dependencies
+  - @objectstack/spec@3.0.0
+  - @objectstack/core@3.0.0
+  - @objectstack/objectql@3.0.0
+  - @objectstack/runtime@3.0.0
+  - @objectstack/rest@3.0.0
+  - @objectstack/driver-memory@3.0.0
+  - @objectstack/plugin-hono-server@3.0.0
+
+## 2.0.7
+
+### Patch Changes
+
+- Updated dependencies
+  - @objectstack/spec@2.0.7
+  - @objectstack/core@2.0.7
+  - @objectstack/objectql@2.0.7
+  - @objectstack/driver-memory@2.0.7
+  - @objectstack/plugin-hono-server@2.0.7
+  - @objectstack/rest@2.0.7
+  - @objectstack/runtime@2.0.7
+
 ## 2.0.6
 
 ### Patch Changes

package/README.md

@@ -58,6 +58,15 @@ os compile
 
 Available generate types: `object`, `view`, `action`, `flow`, `agent`, `dashboard`, `app`
 
+### Plugin Management
+
+| Command | Description |
+|---------|-------------|
+| `os plugin list [config]` | List plugins defined in configuration (alias: `os plugin ls`) |
+| `os plugin info <name> [config]` | Show detailed plugin information |
+| `os plugin add <package>` | Add a plugin import and entry to config |
+| `os plugin remove <name>` | Remove a plugin from config (alias: `os plugin rm`) |
+
 ### Quality
 
 | Command | Description |
@@ -118,6 +127,81 @@ export default defineStack({
 - `-d, --dir <directory>` — Override target directory
 - `--dry-run` — Preview without writing files
 
+### `os plugin list`
+
+- `--json` — Output as JSON
+
+### `os plugin add`
+
+- `-d, --dev` — Add as a dev-only plugin
+- `-c, --config <path>` — Configuration file path
+
+### `os plugin remove`
+
+- `-c, --config <path>` — Configuration file path
+
+## Plugin CLI Extensions
+
+Plugins can extend the CLI with custom commands via the `contributes.commands` manifest field. The CLI automatically discovers and loads these commands at startup.
+
+### How to Create a CLI Plugin
+
+**1. Declare commands in the plugin manifest:**
+
+```typescript
+export default defineStack({
+  manifest: {
+    id: 'com.acme.marketplace',
+    version: '1.0.0',
+    type: 'plugin',
+    name: 'Marketplace Plugin',
+    contributes: {
+      commands: [
+        {
+          name: 'marketplace',
+          description: 'Manage marketplace applications',
+          module: './dist/cli.js',
+        },
+      ],
+    },
+  },
+});
+```
+
+**2. Export Commander.js commands from the module:**
+
+```typescript
+// src/cli.ts
+import { Command } from 'commander';
+
+const marketplaceCommand = new Command('marketplace')
+  .description('Manage marketplace applications')
+  .addCommand(
+    new Command('search')
+      .argument('<query>')
+      .action(async (query) => { /* ... */ })
+  )
+  .addCommand(
+    new Command('install')
+      .argument('<app>')
+      .action(async (app) => { /* ... */ })
+  );
+
+// Named export (recommended)
+export const commands = [marketplaceCommand];
+// Also supports: export default Command | Command[]
+```
+
+**3. Register the plugin in the host project and use:**
+
+```bash
+os plugin add @acme/plugin-marketplace
+os marketplace search "crm"
+os marketplace install com.acme.crm
+```
+
+For a complete guide, see the [Plugin CLI Extensions](/docs/guides/plugins#cli-command-extensions) section in the Plugins guide.
+
 ### `os info`
 
 - `--json` — Output as JSON
@@ -133,9 +217,10 @@ os init                          # 1. Create project
 os generate object customer      # 2. Add a Customer object
 os generate object order         # 3. Add an Order object  
 os generate view customer        # 4. Add a list view
-os validate                      # 5. Validate everything
-os dev                           # 6. Start dev server
-os compile                       # 7. Build for production
+os plugin add @objectstack/plugin-auth  # 5. Add auth plugin
+os validate                      # 6. Validate everything
+os dev                           # 7. Start dev server
+os compile                       # 8. Build for production
 ```
 
 ## License