@rudderjs/cli 4.12.0 → 4.14.0

package/dist/commands/make/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../../src/commands/make/notification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAyB9C;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUvD"}

package/dist/commands/make/notification.js

@@ -0,0 +1,39 @@
+import { registerMake } from './_shared.js';
+export function stub(className) {
+    return `import { Notification, type Notifiable } from '@rudderjs/notification'
+
+/**
+ * Notification. Send it with notify(user, new ${className}()).
+ * Declare the channels in via(), then implement the matching builder
+ * (toMail / toDatabase / toBroadcast).
+ */
+export class ${className} extends Notification {
+  via(_notifiable: Notifiable): string[] {
+    // TODO: choose channels — 'mail', 'database', 'broadcast'
+    return ['database']
+  }
+
+  toDatabase(_notifiable: Notifiable): Record<string, unknown> {
+    return {
+      // TODO: the data to persist for this notification
+    }
+  }
+
+  // toMail(notifiable: Notifiable) {
+  //   return new SomeMailable()
+  // }
+}
+`;
+}
+export function makeNotification(program) {
+    registerMake(program, {
+        command: 'make:notification',
+        description: 'Create a new notification class',
+        label: 'Notification created',
+        suffix: 'Notification',
+        directory: 'app/Notifications',
+        testKind: 'unit',
+        stub,
+    });
+}
+//# sourceMappingURL=notification.js.map

package/dist/commands/make/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../../../src/commands/make/notification.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,MAAM,UAAU,IAAI,CAAC,SAAiB;IACpC,OAAO;;;iDAGwC,SAAS;;;;eAI3C,SAAS;;;;;;;;;;;;;;;;CAgBvB,CAAA;AACD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,YAAY,CAAC,OAAO,EAAE;QACpB,OAAO,EAAM,mBAAmB;QAChC,WAAW,EAAE,iCAAiC;QAC9C,KAAK,EAAQ,sBAAsB;QACnC,MAAM,EAAO,cAAc;QAC3B,SAAS,EAAI,mBAAmB;QAChC,QAAQ,EAAK,MAAM;QACnB,IAAI;KACL,CAAC,CAAA;AACJ,CAAC"}

package/dist/commands/make/observer.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+export declare function stub(className: string): string;
+export declare function makeObserver(program: Command): void;
+//# sourceMappingURL=observer.d.ts.map

package/dist/commands/make/observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../../src/commands/make/observer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA+B9C;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUnD"}

package/dist/commands/make/observer.js

@@ -0,0 +1,45 @@
+import { registerMake } from './_shared.js';
+export function stub(className) {
+    return `import type { ModelObserver } from '@rudderjs/orm'
+
+/**
+ * Model observer. Register it on a model (e.g. in a provider's boot()):
+ *
+ *   Post.observe(${className})
+ *
+ * Implement any subset of the lifecycle hooks below — 'creating'/'updating'/
+ * 'saving' may return a (possibly mutated) attributes object; 'deleting'/
+ * 'updating'/'restoring' may return false to cancel the operation.
+ */
+export class ${className} implements ModelObserver {
+  creating(data: Record<string, unknown>): Record<string, unknown> | void {
+    // TODO: inspect/mutate attributes before the row is inserted
+    return data
+  }
+
+  created(_record: Record<string, unknown>): void {
+    // TODO: react after the row is inserted
+  }
+
+  updating(_id: string | number, data: Record<string, unknown>): Record<string, unknown> | false | void {
+    return data
+  }
+
+  updated(_record: Record<string, unknown>): void {}
+
+  deleted(_id: string | number): void {}
+}
+`;
+}
+export function makeObserver(program) {
+    registerMake(program, {
+        command: 'make:observer',
+        description: 'Create a new model observer class',
+        label: 'Observer created',
+        suffix: 'Observer',
+        directory: 'app/Observers',
+        testKind: 'unit',
+        stub,
+    });
+}
+//# sourceMappingURL=observer.js.map

package/dist/commands/make/observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.js","sourceRoot":"","sources":["../../../src/commands/make/observer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,MAAM,UAAU,IAAI,CAAC,SAAiB;IACpC,OAAO;;;;;oBAKW,SAAS;;;;;;eAMd,SAAS;;;;;;;;;;;;;;;;;;CAkBvB,CAAA;AACD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,YAAY,CAAC,OAAO,EAAE;QACpB,OAAO,EAAM,eAAe;QAC5B,WAAW,EAAE,mCAAmC;QAChD,KAAK,EAAQ,kBAAkB;QAC/B,MAAM,EAAO,UAAU;QACvB,SAAS,EAAI,eAAe;QAC5B,QAAQ,EAAK,MAAM;QACnB,IAAI;KACL,CAAC,CAAA;AACJ,CAAC"}

package/dist/commands/make/policy.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+export declare function stub(className: string): string;
+export declare function makePolicy(program: Command): void;
+//# sourceMappingURL=policy.d.ts.map

package/dist/commands/make/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/commands/make/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA0C9C;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUjD"}

package/dist/commands/make/policy.js

@@ -0,0 +1,56 @@
+import { registerMake } from './_shared.js';
+export function stub(className) {
+    return `import type { Authenticatable } from '@rudderjs/auth'
+import { Policy } from '@rudderjs/auth'
+
+/**
+ * Authorization policy. Register it against a model in a provider's boot():
+ *
+ *   Gate.policy(Post, ${className})
+ *
+ * then authorize with Gate.allows('update', post) / Gate.authorize(...).
+ * Each method below is an "ability" — return true to allow, false to deny.
+ */
+export class ${className} extends Policy {
+  /**
+   * Runs before every ability. Return true/false to short-circuit (e.g. grant
+   * admins everything), or null/undefined to fall through to the ability below.
+   */
+  // before(user: Authenticatable) {
+  //   return null
+  // }
+
+  viewAny(_user: Authenticatable): boolean {
+    return true
+  }
+
+  view(_user: Authenticatable, _model: unknown): boolean {
+    return true
+  }
+
+  create(_user: Authenticatable): boolean {
+    return true
+  }
+
+  update(_user: Authenticatable, _model: unknown): boolean {
+    return false
+  }
+
+  delete(_user: Authenticatable, _model: unknown): boolean {
+    return false
+  }
+}
+`;
+}
+export function makePolicy(program) {
+    registerMake(program, {
+        command: 'make:policy',
+        description: 'Create a new authorization policy class',
+        label: 'Policy created',
+        suffix: 'Policy',
+        directory: 'app/Policies',
+        testKind: 'unit',
+        stub,
+    });
+}
+//# sourceMappingURL=policy.js.map

package/dist/commands/make/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/commands/make/policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,MAAM,UAAU,IAAI,CAAC,SAAiB;IACpC,OAAO;;;;;;yBAMgB,SAAS;;;;;eAKnB,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BvB,CAAA;AACD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,YAAY,CAAC,OAAO,EAAE;QACpB,OAAO,EAAM,aAAa;QAC1B,WAAW,EAAE,yCAAyC;QACtD,KAAK,EAAQ,gBAAgB;QAC7B,MAAM,EAAO,QAAQ;QACrB,SAAS,EAAI,cAAc;QAC3B,QAAQ,EAAK,MAAM;QACnB,IAAI;KACL,CAAC,CAAA;AACJ,CAAC"}

package/dist/commands/make/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/commands/make/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAc9C;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CASnD"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/commands/make/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAc9C;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUnD"}

package/dist/commands/make/provider.js

@@ -21,6 +21,7 @@ export function makeProvider(program) {
         label: 'Provider created',
         suffix: 'ServiceProvider',
         directory: 'app/Providers',
+        testKind: 'unit',
         stub,
     });
 }

package/dist/commands/make/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/commands/make/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,MAAM,UAAU,IAAI,CAAC,SAAiB;IACpC,OAAO;;eAEM,SAAS;;;;;;;;;;CAUvB,CAAA;AACD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,YAAY,CAAC,OAAO,EAAE;QACpB,OAAO,EAAM,eAAe;QAC5B,WAAW,EAAE,qCAAqC;QAClD,KAAK,EAAQ,kBAAkB;QAC/B,MAAM,EAAO,iBAAiB;QAC9B,SAAS,EAAI,eAAe;QAC5B,IAAI;KACL,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/commands/make/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,MAAM,UAAU,IAAI,CAAC,SAAiB;IACpC,OAAO;;eAEM,SAAS;;;;;;;;;;CAUvB,CAAA;AACD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,YAAY,CAAC,OAAO,EAAE;QACpB,OAAO,EAAM,eAAe;QAC5B,WAAW,EAAE,qCAAqC;QAClD,KAAK,EAAQ,kBAAkB;QAC/B,MAAM,EAAO,iBAAiB;QAC9B,SAAS,EAAI,eAAe;QAC5B,QAAQ,EAAK,MAAM;QACnB,IAAI;KACL,CAAC,CAAA;AACJ,CAAC"}

package/dist/commands/make/request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/commands/make/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAuC9C;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CASlD"}
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../../src/commands/make/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,wBAAgB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAuC9C;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUlD"}

package/dist/commands/make/request.js

@@ -46,6 +46,7 @@ export function makeRequest(program) {
         label: 'Request created',
         suffix: 'Request',
         directory: 'app/Http/Requests',
+        testKind: 'unit',
         stub,
     });
 }

package/dist/commands/make/request.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../src/commands/make/request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,MAAM,UAAU,IAAI,CAAC,SAAiB;IACpC,OAAO;;eAEM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCvB,CAAA;AACD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,YAAY,CAAC,OAAO,EAAE;QACpB,OAAO,EAAM,cAAc;QAC3B,WAAW,EAAE,iCAAiC;QAC9C,KAAK,EAAQ,iBAAiB;QAC9B,MAAM,EAAO,SAAS;QACtB,SAAS,EAAI,mBAAmB;QAChC,IAAI;KACL,CAAC,CAAA;AACJ,CAAC"}
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../src/commands/make/request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,MAAM,UAAU,IAAI,CAAC,SAAiB;IACpC,OAAO;;eAEM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCvB,CAAA;AACD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,YAAY,CAAC,OAAO,EAAE;QACpB,OAAO,EAAM,cAAc;QAC3B,WAAW,EAAE,iCAAiC;QAC9C,KAAK,EAAQ,iBAAiB;QAC9B,MAAM,EAAO,SAAS;QACtB,SAAS,EAAI,mBAAmB;QAChC,QAAQ,EAAK,MAAM;QACnB,IAAI;KACL,CAAC,CAAA;AACJ,CAAC"}

package/dist/commands/make/test-stubs.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Test-file stubs shared by `make:test` and the `--with-test` flag on the
+ * other `make:*` generators. Kept import-free so `_shared.ts` (the generator
+ * harness) and `test.ts` (the make:test command) can both use them without a
+ * module cycle.
+ */
+/**
+ * Feature test — boots the app via `AppTestCase` and exercises HTTP / DB /
+ * services. The convention assumed here matches `docs/guide/testing.md`:
+ * apps export `class AppTestCase extends TestCase` from `tests/TestCase.ts`.
+ * The generated file uses Node's built-in `node:test` runner (the documented
+ * runner — runs via `tsx --test tests/**\/*.test.ts`).
+ *
+ * @param sourceRel — when set (the `--with-test` flow), a `// Covers …`
+ * comment points the test back at the file it was generated alongside.
+ */
+export declare function featureStub(testName: string, sourceRel?: string): string;
+/**
+ * Unit test — plain `node:test` + `assert`. No app boot, no TestCase,
+ * no `@rudderjs/testing`. The right shape for pure functions, validators,
+ * domain logic, or anything that shouldn't pay the boot cost.
+ */
+export declare function unitStub(testName: string, sourceRel?: string): string;
+//# sourceMappingURL=test-stubs.d.ts.map

package/dist/commands/make/test-stubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-stubs.d.ts","sourceRoot":"","sources":["../../../src/commands/make/test-stubs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBxE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAUrE"}

package/dist/commands/make/test-stubs.js

@@ -0,0 +1,50 @@
+/**
+ * Test-file stubs shared by `make:test` and the `--with-test` flag on the
+ * other `make:*` generators. Kept import-free so `_shared.ts` (the generator
+ * harness) and `test.ts` (the make:test command) can both use them without a
+ * module cycle.
+ */
+/**
+ * Feature test — boots the app via `AppTestCase` and exercises HTTP / DB /
+ * services. The convention assumed here matches `docs/guide/testing.md`:
+ * apps export `class AppTestCase extends TestCase` from `tests/TestCase.ts`.
+ * The generated file uses Node's built-in `node:test` runner (the documented
+ * runner — runs via `tsx --test tests/**\/*.test.ts`).
+ *
+ * @param sourceRel — when set (the `--with-test` flow), a `// Covers …`
+ * comment points the test back at the file it was generated alongside.
+ */
+export function featureStub(testName, sourceRel) {
+    return `import { describe, it, before, after } from 'node:test'
+import { AppTestCase } from './TestCase.js'
+${sourceRel ? `\n// Covers ${sourceRel}` : ''}
+describe('${testName}', () => {
+  let t: AppTestCase
+
+  before(async () => { t = await AppTestCase.create() })
+  after (async () => { await t.teardown() })
+
+  it('does something', async () => {
+    const res = await t.get('/')
+    res.assertOk()
+  })
+})
+`;
+}
+/**
+ * Unit test — plain `node:test` + `assert`. No app boot, no TestCase,
+ * no `@rudderjs/testing`. The right shape for pure functions, validators,
+ * domain logic, or anything that shouldn't pay the boot cost.
+ */
+export function unitStub(testName, sourceRel) {
+    return `import { describe, it } from 'node:test'
+import assert from 'node:assert/strict'
+${sourceRel ? `\n// Covers ${sourceRel}` : ''}
+describe('${testName}', () => {
+  it('does something', () => {
+    assert.equal(1 + 1, 2)
+  })
+})
+`;
+}
+//# sourceMappingURL=test-stubs.js.map

package/dist/commands/make/test-stubs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-stubs.js","sourceRoot":"","sources":["../../../src/commands/make/test-stubs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,SAAkB;IAC9D,OAAO;;EAEP,SAAS,CAAC,CAAC,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;YACjC,QAAQ;;;;;;;;;;;CAWnB,CAAA;AACD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,SAAkB;IAC3D,OAAO;;EAEP,SAAS,CAAC,CAAC,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;YACjC,QAAQ;;;;;CAKnB,CAAA;AACD,CAAC"}

package/dist/commands/make/test.d.ts

@@ -1,17 +1,5 @@
 import type { Command } from 'commander';
-/**
- * Feature test — boots the app via `AppTestCase` and exercises HTTP / DB /
- * services. The convention assumed here matches `docs/guide/testing.md`:
- * apps export `class AppTestCase extends TestCase` from `tests/TestCase.ts`.
- * The generated file uses Node's built-in `node:test` runner (the documented
- * runner — runs via `tsx --test tests/**\/*.test.ts`).
- */
-export declare function featureStub(testName: string): string;
-/**
- * Unit test — plain `node:test` + `assert`. No app boot, no TestCase,
- * no `@rudderjs/testing`. The right shape for pure functions, validators,
- * domain logic, or anything that shouldn't pay the boot cost.
- */
-export declare function unitStub(testName: string): string;
+import { featureStub, unitStub } from './test-stubs.js';
+export { featureStub, unitStub };
 export declare function makeTest(program: Command): void;
 //# sourceMappingURL=test.d.ts.map

package/dist/commands/make/test.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/commands/make/test.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMxC;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgBpD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUjD;AAqBD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwB/C"}
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../../src/commands/make/test.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAA;AAqBhC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwB/C"}

package/dist/commands/make/test.js

@@ -2,47 +2,8 @@ import { existsSync } from 'node:fs';
 import path from 'node:path';
 import chalk from 'chalk';
 import { registerMake } from './_shared.js';
-// ── Stubs ─────────────────────────────────────────────────────
-/**
- * Feature test — boots the app via `AppTestCase` and exercises HTTP / DB /
- * services. The convention assumed here matches `docs/guide/testing.md`:
- * apps export `class AppTestCase extends TestCase` from `tests/TestCase.ts`.
- * The generated file uses Node's built-in `node:test` runner (the documented
- * runner — runs via `tsx --test tests/**\/*.test.ts`).
- */
-export function featureStub(testName) {
-    return `import { describe, it, before, after } from 'node:test'
-import { AppTestCase } from './TestCase.js'
-
-describe('${testName}', () => {
-  let t: AppTestCase
-
-  before(async () => { t = await AppTestCase.create() })
-  after (async () => { await t.teardown() })
-
-  it('does something', async () => {
-    const res = await t.get('/')
-    res.assertOk()
-  })
-})
-`;
-}
-/**
- * Unit test — plain `node:test` + `assert`. No app boot, no TestCase,
- * no `@rudderjs/testing`. The right shape for pure functions, validators,
- * domain logic, or anything that shouldn't pay the boot cost.
- */
-export function unitStub(testName) {
-    return `import { describe, it } from 'node:test'
-import assert from 'node:assert/strict'
-
-describe('${testName}', () => {
-  it('does something', () => {
-    assert.equal(1 + 1, 2)
-  })
-})
-`;
-}
+import { featureStub, unitStub } from './test-stubs.js';
+export { featureStub, unitStub };
 // ── Helpers ───────────────────────────────────────────────────
 /**
  * Trim a trailing `.test` so `make:test User` produces a `describe('User', …)`

package/dist/commands/make/test.js.map

@@ -1 +1 @@
-{"version":3,"file":"test.js","sourceRoot":"","sources":["../../../src/commands/make/test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C,iEAAiE;AAEjE;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO;;;YAGG,QAAQ;;;;;;;;;;;CAWnB,CAAA;AACD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,OAAO;;;YAGG,QAAQ;;;;;CAKnB,CAAA;AACD,CAAC;AAED,iEAAiE;AAEjE;;;;;GAKG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACvE,CAAC;AAED,SAAS,QAAQ,CAAC,SAAiB,EAAE,IAA6B;IAChE,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,CAAA;IAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;AAClE,CAAC;AAED,iEAAiE;AAEjE,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,YAAY,CAAC,OAAO,EAAE;QACpB,OAAO,EAAM,WAAW;QACxB,WAAW,EAAE,0FAA0F;QACvG,KAAK,EAAQ,cAAc;QAC3B,sEAAsE;QACtE,mEAAmE;QACnE,8DAA8D;QAC9D,MAAM,EAAO,OAAO;QACpB,SAAS,EAAI,OAAO;QACpB,IAAI,EAAS,QAAQ;QACrB,YAAY,EAAE;YACZ,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,kEAAkE,EAAE;SACzG;QACD,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;YAChD,uEAAuE;YACvE,2DAA2D;YAC3D,IAAI,IAAI,CAAC,MAAM,CAAC;gBAAE,OAAM;YACxB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,CAAA;YACxE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,uFAAuF,CAAC,CAAC,CAAA;YACpH,CAAC;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,WAAW;IACX,QAAQ;IACR,eAAe;IACf,QAAQ;CACT,CAAA"}
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../../src/commands/make/test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAEvD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAA;AAEhC,iEAAiE;AAEjE;;;;;GAKG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACvE,CAAC;AAED,SAAS,QAAQ,CAAC,SAAiB,EAAE,IAA6B;IAChE,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,CAAA;IAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;AAClE,CAAC;AAED,iEAAiE;AAEjE,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,YAAY,CAAC,OAAO,EAAE;QACpB,OAAO,EAAM,WAAW;QACxB,WAAW,EAAE,0FAA0F;QACvG,KAAK,EAAQ,cAAc;QAC3B,sEAAsE;QACtE,mEAAmE;QACnE,8DAA8D;QAC9D,MAAM,EAAO,OAAO;QACpB,SAAS,EAAI,OAAO;QACpB,IAAI,EAAS,QAAQ;QACrB,YAAY,EAAE;YACZ,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,kEAAkE,EAAE;SACzG;QACD,WAAW,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;YAChD,uEAAuE;YACvE,2DAA2D;YAC3D,IAAI,IAAI,CAAC,MAAM,CAAC;gBAAE,OAAM;YACxB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,CAAA;YACxE,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,uFAAuF,CAAC,CAAC,CAAA;YACpH,CAAC;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,yCAAyC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,WAAW;IACX,QAAQ;IACR,eAAe;IACf,QAAQ;CACT,CAAA"}

package/dist/commands/make.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make.d.ts","sourceRoot":"","sources":["../../src/commands/make.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAexC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8BlD"}
+{"version":3,"file":"make.d.ts","sourceRoot":"","sources":["../../src/commands/make.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAoBxC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmClD"}

package/dist/commands/make.js

@@ -8,9 +8,14 @@ import { makeRequest } from './make/request.js';
 import { makeProvider } from './make/provider.js';
 import { makeCommandCmd } from './make/command.js';
 import { makeEvent } from './make/event.js';
+import { makeException } from './make/exception.js';
 import { makeListener } from './make/listener.js';
 import { makeMail } from './make/mail.js';
 import { makeTest } from './make/test.js';
+import { makePolicy } from './make/policy.js';
+import { makeObserver } from './make/observer.js';
+import { makeCast } from './make/cast.js';
+import { makeNotification } from './make/notification.js';
 export function makeCommand(program) {
     // CLI-owned generic scaffolders
     makeController(program);
@@ -21,9 +26,14 @@ export function makeCommand(program) {
     makeProvider(program);
     makeCommandCmd(program);
     makeEvent(program);
+    makeException(program);
     makeListener(program);
     makeMail(program);
     makeTest(program);
+    makePolicy(program);
+    makeObserver(program);
+    makeCast(program);
+    makeNotification(program);
     // Package-contributed scaffolders (registered via registerMakeSpecs)
     for (const spec of getMakeSpecs()) {
         program

package/dist/commands/make.js.map

@@ -1 +1 @@
-{"version":3,"file":"make.js","sourceRoot":"","sources":["../../src/commands/make.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,gCAAgC;IAChC,cAAc,CAAC,OAAO,CAAC,CAAA;IACvB,SAAS,CAAC,OAAO,CAAC,CAAA;IAClB,OAAO,CAAC,OAAO,CAAC,CAAA;IAChB,cAAc,CAAC,OAAO,CAAC,CAAA;IACvB,WAAW,CAAC,OAAO,CAAC,CAAA;IACpB,YAAY,CAAC,OAAO,CAAC,CAAA;IACrB,cAAc,CAAC,OAAO,CAAC,CAAA;IACvB,SAAS,CAAC,OAAO,CAAC,CAAA;IAClB,YAAY,CAAC,OAAO,CAAC,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,CAAA;IACjB,QAAQ,CAAC,OAAO,CAAC,CAAA;IAEjB,qEAAqE;IACrE,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,EAAE,CAAC;QAClC,OAAO;aACJ,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,SAAS,CAAC;aACjC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC;aAC7B,MAAM,CAAC,aAAa,EAAE,kCAAkC,CAAC;aACzD,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAyB,EAAE,EAAE;YACxD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;YACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;gBACjE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,CAAA;gBACzD,OAAM;YACR,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;QAC5E,CAAC,CAAC,CAAA;IACN,CAAC;AACH,CAAC"}
+{"version":3,"file":"make.js","sourceRoot":"","sources":["../../src/commands/make.ts"],"names":[],"mappings":"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"}

package/dist/commands/optimize-clear.d.ts

@@ -0,0 +1,28 @@
+import type { Command } from 'commander';
+interface ClearResult {
+    /** Path relative to the app root, e.g. `bootstrap/cache/` */
+    target: string;
+    /** What the target holds — shown next to the checkmark */
+    label: string;
+    cleared: boolean;
+}
+/**
+ * Remove the framework's filesystem caches. Everything here is regenerated
+ * automatically: the provider manifest self-heals at boot, and Vite rebuilds
+ * its dep-optimizer cache on the next dev server start.
+ *
+ * Deliberately NOT cleared: `.rudder/types/` and `pages/__view/` (committed,
+ * regenerated by scanners — wiping them breaks a fresh-clone typecheck) and
+ * `dist/` (build output, that's `pnpm clean`'s job).
+ */
+export declare function clearFrameworkCaches(cwd: string): ClearResult[];
+/** Print one line per target — ✔ cleared / dim already-empty. */
+export declare function reportClearResults(results: ClearResult[]): void;
+/**
+ * `rudder optimize:clear` — Laravel-parity name for "wipe the framework's
+ * filesystem caches". Skip-boot: it must work when a corrupt cache is the
+ * reason the app can't boot.
+ */
+export declare function optimizeClearCommand(program: Command): void;
+export {};
+//# sourceMappingURL=optimize-clear.d.ts.map

package/dist/commands/optimize-clear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize-clear.d.ts","sourceRoot":"","sources":["../../src/commands/optimize-clear.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,UAAU,WAAW;IACnB,6DAA6D;IAC7D,MAAM,EAAG,MAAM,CAAA;IACf,0DAA0D;IAC1D,KAAK,EAAI,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAY/D;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,CAQ/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO3D"}

package/dist/commands/optimize-clear.js

@@ -0,0 +1,50 @@
+import { rmSync, existsSync } from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+/**
+ * Remove the framework's filesystem caches. Everything here is regenerated
+ * automatically: the provider manifest self-heals at boot, and Vite rebuilds
+ * its dep-optimizer cache on the next dev server start.
+ *
+ * Deliberately NOT cleared: `.rudder/types/` and `pages/__view/` (committed,
+ * regenerated by scanners — wiping them breaks a fresh-clone typecheck) and
+ * `dist/` (build output, that's `pnpm clean`'s job).
+ */
+export function clearFrameworkCaches(cwd) {
+    const targets = [
+        { target: 'bootstrap/cache/', label: 'provider manifest (self-heals at boot)' },
+        { target: 'node_modules/.vite/', label: 'Vite dep-optimizer cache' },
+    ];
+    return targets.map(({ target, label }) => {
+        const abs = path.join(cwd, target);
+        if (!existsSync(abs))
+            return { target, label, cleared: false };
+        rmSync(abs, { recursive: true, force: true });
+        return { target, label, cleared: true };
+    });
+}
+/** Print one line per target — ✔ cleared / dim already-empty. */
+export function reportClearResults(results) {
+    for (const r of results) {
+        if (r.cleared) {
+            console.log(chalk.green('  ✔ Cleared:'), chalk.cyan(r.target), chalk.dim(`— ${r.label}`));
+        }
+        else {
+            console.log(chalk.dim(`  - ${r.target} already empty`));
+        }
+    }
+}
+/**
+ * `rudder optimize:clear` — Laravel-parity name for "wipe the framework's
+ * filesystem caches". Skip-boot: it must work when a corrupt cache is the
+ * reason the app can't boot.
+ */
+export function optimizeClearCommand(program) {
+    program
+        .command('optimize:clear')
+        .description('Remove framework filesystem caches (provider manifest, Vite dep-optimizer cache)')
+        .action(() => {
+        reportClearResults(clearFrameworkCaches(process.cwd()));
+    });
+}
+//# sourceMappingURL=optimize-clear.js.map

package/dist/commands/optimize-clear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize-clear.js","sourceRoot":"","sources":["../../src/commands/optimize-clear.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,KAAK,MAAM,OAAO,CAAA;AAUzB;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,OAAO,GAAwC;QACnD,EAAE,MAAM,EAAE,kBAAkB,EAAK,KAAK,EAAE,wCAAwC,EAAE;QAClF,EAAE,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,0BAA0B,EAAE;KACrE,CAAA;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;QAClC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;QAC9D,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAC7C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IACzC,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,kBAAkB,CAAC,OAAsB;IACvD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAC3F,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,gBAAgB,CAAC,CAAC,CAAA;QACzD,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,kFAAkF,CAAC;SAC/F,MAAM,CAAC,GAAG,EAAE;QACX,kBAAkB,CAAC,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/index.js

@@ -17,6 +17,9 @@ import { aboutCommand } from './commands/about.js';
 import { testCommand } from './commands/test.js';
 import { doctorCommand } from './commands/doctor.js';
 import { tinkerCommand } from './commands/tinker.js';
+import { optimizeClearCommand } from './commands/optimize-clear.js';
+import { freshCommand } from './commands/fresh.js';
+import { downCommand, upCommand } from './commands/maintenance.js';
 import { rudder, parseSignature, CancelledError, commandObservers } from '@rudderjs/console';
 import { CliError } from './errors.js';
 // The `rudder` CLI's own version, read from its package.json at runtime — works
@@ -215,8 +218,9 @@ async function loadPackageCommands() {
             const register = mod['registerSchemaTypesCommand'];
             register(rudder, { bootApp });
         },
-        // @rudderjs/orm → db:show, db:table. Resolves the native engine (via
-        // bootApp on demand, like schema:types) to inspect its live connection.
+        // @rudderjs/orm → db:show, db:table, db:query. The inspect pair resolves
+        // the native engine (via bootApp on demand, like schema:types); db:query
+        // rides the DB facade on whatever adapter the app runs.
         async () => {
             const mod = await tryImport('@rudderjs/orm', 'commands/db-inspect');
             const register = mod['registerDbInspectCommands'];
@@ -249,6 +253,12 @@ async function loadPackageCommands() {
             const register = mod['registerRouteListCommand'];
             register(rudder);
         },
+        // @rudderjs/openapi → openapi:generate
+        async () => {
+            const mod = await tryImport('@rudderjs/openapi', 'commands/openapi-generate');
+            const register = mod['registerOpenApiGenerateCommand'];
+            register(rudder);
+        },
         // @rudderjs/core → event:list
         async () => {
             const mod = await tryImport('@rudderjs/core', 'commands/event-list');
@@ -289,6 +299,12 @@ async function loadPackageCommands() {
             const register = mod['registerEnvSyncCommand'];
             register(rudder);
         },
+        // @rudderjs/vite → config:sync
+        async () => {
+            const mod = await tryImport('@rudderjs/vite', 'commands/config-sync');
+            const register = mod['registerConfigSyncCommand'];
+            register(rudder);
+        },
     ];
     await Promise.all(loaders.map(fn => fn().catch(() => { })));
 }
@@ -366,6 +382,10 @@ async function main() {
     testCommand(program);
     doctorCommand(program, { bootApp });
     tinkerCommand(program);
+    optimizeClearCommand(program);
+    freshCommand(program);
+    downCommand(program);
+    upCommand(program);
     // Commands that scan files / manage tooling state must work even when the
     // app cannot boot (e.g. fresh clone, missing manifest, broken provider config).
     // List them here to skip the bootApp() phase entirely.
@@ -391,11 +411,19 @@ async function main() {
     // - `remove` uninstalls a package — the about-to-be-deleted provider
     //   may still be in node_modules but is being torn out; booting would
     //   be wasted work at best and surface confusing errors at worst.
+    // - `optimize:clear` must work when a corrupt cache is the reason the
+    //   app can't boot. `fresh` is an orchestrator — each step that needs
+    //   the app boots its own child process, so `fresh` itself never holds
+    //   connections to the database it is about to drop.
     const NO_BOOT_EXACT = new Set([
         'providers:discover', 'module:publish', 'view:sync', 'routes:sync', 'env:sync',
         'db:generate', 'db:push',
         'migrate', 'migrate:fresh', 'migrate:status', 'migrate:rollback', 'migrate:refresh',
         'add', 'remove', 'upgrade', 'key:generate', 'about', 'test',
+        'optimize:clear', 'fresh',
+        // `down`/`up` just write/remove the storage/framework/down flag file — no
+        // app context needed (and the app may be down because it can't boot).
+        'down', 'up',
         // `doctor` fast-path runs filesystem/env checks only. `--deep` is handled
         // inside the command's handler, which boots the app on demand (Phase 4).
         'doctor',