@quatrain/cli 1.1.8

package/README.md

@@ -0,0 +1,60 @@
+# @quatrain/core-cli
+
+The official Command Line Interface (CLI) for the Quatrain ecosystem.
+This CLI provides tools to scaffold projects, generate normalized bootloader configurations, and create migration files.
+
+## Installation
+
+You can install the CLI globally via NPM or Yarn, or run it on the fly using `npx` or `bunx`.
+
+### Global Installation
+
+```bash
+npm install -g @quatrain/core-cli
+# or
+yarn global add @quatrain/core-cli
+# or via Bun
+bun add -g @quatrain/core-cli
+```
+
+### On-the-fly Execution
+
+```bash
+npx @quatrain/core-cli <command>
+# or
+bunx @quatrain/core-cli <command>
+```
+
+## Commands
+
+### `core generate scaffold <project-name>`
+Quickly initializes a new Quatrain project.
+- Creates a base directory.
+- Sets up the `apps/`, `data/`, `config/`, `packages/`, and `migrations/` folders.
+- Generates a monorepo-ready `package.json` utilizing Yarn workspaces.
+- Generates a `tsconfig.json` pre-configured with the required path mappings.
+
+### `core generate config`
+Starts an interactive wizard to generate a `quatrain.json` configuration file.
+- Prompts for Backend, Auth, Queue, Storage, and Messaging adapters.
+- Generates a normalized JSON configuration.
+- The generated `env(...)` tokens will be resolved at runtime by the `AppBootloader`.
+
+### `core generate migration <name>`
+Scaffolds a new migration file.
+- Creates a `migrations/` directory if it does not exist.
+- Generates a timestamped TypeScript file (e.g., `20260427184500_init.ts`).
+- Provides boilerplate `up()` and `down()` methods.
+
+## Language Guidelines
+> **Recommendation:** All text contents (such as console logs, commit messages, and comments) within the Quatrain ecosystem must be written in **International English**. This ensures accessibility and maintainability for developers worldwide.
+
+## HOWTO / Usage Examples
+
+```bash
+# Example of scaffolding a new project
+yarn global add @quatrain/core-cli
+quatrain generate scaffold my-app
+cd my-app
+yarn install
+```

package/bin/core.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../dist/cli.js');

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const config_1 = require("./commands/generate/config");
+const migration_1 = require("./commands/generate/migration");
+const scaffold_1 = require("./commands/generate/scaffold");
+const deploy_1 = require("./commands/deploy");
+const program = new commander_1.Command();
+program
+    .name('core')
+    .description('Global CLI for Quatrain Core (configuration generation, migrations...)')
+    .version('1.0.0');
+program
+    .command('deploy')
+    .description('Manage Kubernetes installations (create, list, modify, promote, delete)')
+    .action(deploy_1.deployCommand);
+const generate = program
+    .command('generate')
+    .description('Generate files (config, migration, etc.)');
+generate
+    .command('config')
+    .description('Generate a normalized configuration file for the bootloader')
+    .action(config_1.generateConfig);
+generate
+    .command('migration <name>')
+    .description('Generate a blank migration file')
+    .action(migration_1.generateMigration);
+generate
+    .command('scaffold <project-name>')
+    .description('Initialize a new Quatrain project with its basic structure')
+    .action(scaffold_1.generateScaffold);
+program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AAAA,yCAAmC;AACnC,uDAA2D;AAC3D,6DAAiE;AACjE,2DAA+D;AAC/D,8CAAiD;AAEjD,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAA;AAE7B,OAAO;KACH,IAAI,CAAC,MAAM,CAAC;KACZ,WAAW,CAAC,wEAAwE,CAAC;KACrF,OAAO,CAAC,OAAO,CAAC,CAAA;AAEpB,OAAO;KACH,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,yEAAyE,CAAC;KACtF,MAAM,CAAC,sBAAa,CAAC,CAAA;AAEzB,MAAM,QAAQ,GAAG,OAAO;KACpB,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,0CAA0C,CAAC,CAAA;AAE3D,QAAQ;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,6DAA6D,CAAC;KAC1E,MAAM,CAAC,uBAAc,CAAC,CAAA;AAE1B,QAAQ;KACJ,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,iCAAiC,CAAC;KAC9C,MAAM,CAAC,6BAAiB,CAAC,CAAA;AAE7B,QAAQ;KACJ,OAAO,CAAC,yBAAyB,CAAC;KAClC,WAAW,CAAC,4DAA4D,CAAC;KACzE,MAAM,CAAC,2BAAgB,CAAC,CAAA;AAE5B,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/dist/commands/deploy.d.ts

@@ -0,0 +1,2 @@
+export declare function deployCommand(): Promise<void>;
+//# sourceMappingURL=deploy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAgVA,wBAAsB,aAAa,kBA4elC"}