@venturekit/cli 0.0.0-dev.20260307234057 → 0.0.0-dev.20260308002709

package/dist/commands/help.d.ts

@@ -0,0 +1,7 @@
+/**
+ * vk help - Explain how the VentureKit CLI works
+ */
+import { Command } from 'commander';
+export declare function helpCommand(program: Command): void;
+export declare function showHelp(): void;
+//# sourceMappingURL=help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwDpC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAOlD;AAED,wBAAgB,QAAQ,IAAI,IAAI,CAE/B"}

package/dist/commands/help.js

@@ -0,0 +1,68 @@
+/**
+ * vk help - Explain how the VentureKit CLI works
+ */
+import chalk from 'chalk';
+const HELP_TEXT = `
+${chalk.bold.blue('VentureKit CLI')} — Build and ship SaaS products fast on AWS.
+
+${chalk.yellow('⚠  This project is in active development and not production-ready.')}
+${chalk.yellow('   APIs may change without notice. Do not use dev builds in production.')}
+
+${chalk.bold('USAGE')}
+
+  ${chalk.cyan('vk <command> [options]')}
+
+${chalk.bold('COMMANDS')}
+
+  ${chalk.green('init')}       Scaffold a new VentureKit project from a template.
+             Templates: ${chalk.dim('minimal, api, fullstack')}
+
+  ${chalk.green('dev')}        Start a local development server powered by SST.
+             Watches for changes and hot-reloads your functions.
+
+  ${chalk.green('deploy')}     Deploy your project to AWS via SST/CDK.
+             Supports stage-based deployments (dev, staging, prod).
+
+  ${chalk.green('remove')}     Tear down deployed AWS resources for a given stage.
+
+  ${chalk.green('generate')}   Generate boilerplate code — routes, handlers, configs.
+
+  ${chalk.green('migrate')}    Run database migrations powered by Drizzle Kit.
+
+${chalk.bold('GETTING STARTED')}
+
+  1. Create a new project:
+     ${chalk.cyan('vk init my-app')}
+
+  2. Move into the project directory:
+     ${chalk.cyan('cd my-app')}
+
+  3. Start the dev server:
+     ${chalk.cyan('vk dev')}
+
+  4. Deploy to AWS:
+     ${chalk.cyan('vk deploy')}
+
+${chalk.bold('OPTIONS')}
+
+  Most commands accept ${chalk.cyan('--stage <name>')} to target a specific environment.
+  Use ${chalk.cyan('--help')} on any command for detailed usage, e.g. ${chalk.cyan('vk init --help')}
+
+${chalk.bold('LINKS')}
+
+  Documentation  ${chalk.dim('https://venturekit.dev')}
+  GitHub         ${chalk.dim('https://github.com/venturekit-dev/venturekit')}
+  npm            ${chalk.dim('https://www.npmjs.com/org/venturekit')}
+`;
+export function helpCommand(program) {
+    program
+        .command('help')
+        .description('Show detailed help on how the VentureKit CLI works')
+        .action(() => {
+        console.log(HELP_TEXT);
+    });
+}
+export function showHelp() {
+    console.log(HELP_TEXT);
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,SAAS,GAAG;EAChB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC;;EAEjC,KAAK,CAAC,MAAM,CAAC,oEAAoE,CAAC;EAClF,KAAK,CAAC,MAAM,CAAC,yEAAyE,CAAC;;EAEvF,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;;IAEjB,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC;;EAEtC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;;IAEpB,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;0BACG,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC;;IAE1D,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;;;IAGlB,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;;;IAGrB,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;;IAErB,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;;IAEvB,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC;;EAExB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC;;;OAGxB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC;;;OAG5B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;;;OAGvB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;;;OAGpB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;;EAE5B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;;yBAEE,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,4CAA4C,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC;;EAElG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;;mBAEF,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC;mBACnC,KAAK,CAAC,GAAG,CAAC,8CAA8C,CAAC;mBACzD,KAAK,CAAC,GAAG,CAAC,sCAAsC,CAAC;CACnE,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,oDAAoD,CAAC;SACjE,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACzB,CAAC"}

package/dist/commands/init.js

@@ -78,10 +78,10 @@ export function initCommand(program) {
             }, null, 2));
             // Create sst.config.ts
             writeFileSync(join(projectDir, 'sst.config.ts'), `import { defineVenture } from '@venturekit/infra';
-import { base } from './config/base';
-import { security } from './config/security';
-import { dev } from './config/dev';
-import { prod } from './config/prod';
+import { base } from './config/base.js';
+import { security } from './config/security.js';
+import { dev } from './config/dev.js';
+import { prod } from './config/prod.js';
 
 export default defineVenture({
   base,

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAe9B;;GAEG;AACH,wBAAgB,GAAG,IAAI,IAAI,CAE1B;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAqB9B;;GAEG;AACH,wBAAgB,GAAG,IAAI,IAAI,CAE1B;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -5,12 +5,13 @@
  * Documentation: https://venturekit.dev
  */
 import { Command } from 'commander';
-import { initCommand } from './commands/init';
-import { devCommand } from './commands/dev';
-import { deployCommand } from './commands/deploy';
-import { removeCommand } from './commands/remove';
-import { generateCommand } from './commands/generate';
-import { migrateCommand } from './commands/migrate';
+import { initCommand } from './commands/init.js';
+import { devCommand } from './commands/dev.js';
+import { deployCommand } from './commands/deploy.js';
+import { removeCommand } from './commands/remove.js';
+import { generateCommand } from './commands/generate.js';
+import { migrateCommand } from './commands/migrate.js';
+import { helpCommand, showHelp } from './commands/help.js';
 const program = new Command();
 program
     .name('vk')
@@ -23,6 +24,11 @@ deployCommand(program);
 removeCommand(program);
 generateCommand(program);
 migrateCommand(program);
+helpCommand(program);
+// Show detailed help when called without a command
+program.action(() => {
+    showHelp();
+});
 /**
  * Run the CLI
  */

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,IAAI,CAAC;KACV,WAAW,CAAC,+CAA+C,CAAC;KAC5D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,oBAAoB;AACpB,WAAW,CAAC,OAAO,CAAC,CAAC;AACrB,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,cAAc,CAAC,OAAO,CAAC,CAAC;AAExB;;GAEG;AACH,MAAM,UAAU,GAAG;IACjB,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,IAAI,CAAC;KACV,WAAW,CAAC,+CAA+C,CAAC;KAC5D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,oBAAoB;AACpB,WAAW,CAAC,OAAO,CAAC,CAAC;AACrB,UAAU,CAAC,OAAO,CAAC,CAAC;AACpB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,aAAa,CAAC,OAAO,CAAC,CAAC;AACvB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,WAAW,CAAC,OAAO,CAAC,CAAC;AAErB,mDAAmD;AACnD,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE;IAClB,QAAQ,EAAE,CAAC;AACb,CAAC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,GAAG;IACjB,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venturekit/cli",
-  "version": "0.0.0-dev.20260307234057",
+  "version": "0.0.0-dev.20260308002709",
   "description": "CLI for VentureKit - scaffolding and deploy orchestration",
   "type": "module",
   "bin": {
@@ -29,7 +29,7 @@
     }
   },
   "dependencies": {
-    "@venturekit/core": "0.0.0-dev.20260307234057",
+    "@venturekit/core": "0.0.0-dev.20260308002709",
     "commander": "^12.0.0",
     "chalk": "^5.3.0",
     "ora": "^8.0.0",