@malyuga/aether-cli 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MalyugaSensei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,117 @@
+# aether-cli
+
+Aether scaffolds **plain TypeScript** HTTP backends on Node’s built-in `http` module. It writes source files you own and edit by hand—it is not a runtime framework. After generation, your app runs with **no Aether dependency** and **no npm packages in `dependencies`**.
+
+Requires **Node.js 20+**.
+
+## Why Aether?
+
+Starting from an empty directory means rebuilding the same server, routing, configuration, and error handling every time. Starting from a framework means adopting its runtime, conventions, and upgrade path.
+
+Aether takes the middle ground: it generates a small, working backend and then gets out of the way. The result is ordinary TypeScript with explicit wiring, replaceable parts, and no framework-specific runtime. You can keep the generated structure, change it, or remove any part of it without fighting the tool.
+
+## When to use Aether
+
+- You want a **new TypeScript HTTP API** on **`node:http`**, with source files you edit directly
+- You prefer an **explicit composition root** (`composition.ts`) over a runtime framework
+- You need **CRUD scaffolding** by hand or from an **OpenAPI** specification
+- The generated app should ship with **zero runtime npm dependencies**
+
+Concise context for coding agents: [llms.txt](./llms.txt).
+
+## Quick start
+
+```bash
+npm i -g @malyuga/aether-cli
+
+mkdir my-api && cd my-api
+aether init
+npm install
+aether g resource users --crud
+npm run dev
+```
+
+`GET /health` works immediately. CRUD routes are wired in `src/app/composition.ts`, but the generated **repository is only an interface**—until you pass a real implementation there, CRUD handlers respond with **501 Repository not configured**. That is intentional: persistence is your code, not generated magic.
+
+Typical next step: implement `UserRepository` (or use the optional fake from `aether g resource users --crud --tests`) and pass it into `createUserModule({ repository: … })` in `composition.ts`.
+
+## What `init` gives you
+
+- **HTTP server** with graceful shutdown (`SIGINT` / `SIGTERM`)
+- **Router** and a single **composition root** (`src/app/composition.ts`) where modules and repositories are wired
+- **Config from environment** (`.env` parsed without `dotenv`); see `.env.example`
+- **Middleware**: CORS, body size limit, request logging, centralized errors, optional **Bearer** auth via `BEARER_TOKEN` in `.env` (disabled when unset; `GET /health` stays public)
+- **`GET /health`** → `{ "status": "ok" }`
+- **List helper** for collection endpoints: `?limit=1..100&offset=0` (default limit 50)
+
+Output is **CommonJS**; local imports omit file extensions. Production path: `npm run build` then `npm start` (`node dist/main.js`)—runtime needs only Node, not TypeScript or tsx.
+
+## Commands
+
+| Command | Purpose |
+|--------|---------|
+| `aether init` | Scaffold a new project in the current directory |
+| `aether g resource <name>` | Resource module (add `--crud` for full stack) |
+| `aether g middleware <name>` | Middleware stub (`--global` registers in `src/app.ts`) |
+| `aether g openapi <spec>` | Generates CRUD resources from an OpenAPI specification |
+| `aether check` | Verify layout (`composition`, config) |
+| `aether doctor` | Node version, project context, CLI templates |
+| `aether upgrade` | Reports how the project drifts from the current Aether contract; read-only, does not rewrite your code |
+| `aether help` | Full guide with examples |
+
+`generate` is aliased as **`g`**.
+
+### Useful flags
+
+- **`--dry-run`** — show planned creates/modifies without writing
+- **`--diff`** — with `--dry-run`, print a unified diff
+- **`--json`** — machine-readable output (including errors)
+- **`--force`** — overwrite existing generated files (`init` never overwrites `.env`)
+
+Resource-specific: `--crud`, `--singular`, `--tests` (with `--crud`: fake repo + smoke tests under `tests/`). OpenAPI: `--strict`, `--only a,b`.
+
+## Examples
+
+Preview scaffold before writing:
+
+```bash
+aether init --dry-run --diff
+```
+
+CRUD and tests in one step:
+
+```bash
+aether g resource orders --crud --tests
+```
+
+Generate from an API contract (re-run updates **types** and **validate** only; use `--force` to rewrite the whole module):
+
+```bash
+aether g openapi ./api.yaml --strict
+```
+
+Enable Bearer auth on all routes except health (already wired by `init`; set the token in `.env`):
+
+```bash
+BEARER_TOKEN=your-secret
+```
+
+CI-style structure check:
+
+```bash
+aether check --json
+```
+
+## Resource layout (with `--crud`)
+
+For `users` you get layers under `src/users/`:
+
+`types` → `validate` → `repository` (interface) → `service` → `controller` → `routes` → `module`, plus registration in `composition.ts`.
+
+Without OpenAPI, a manual CRUD resource starts with entity **`{ id }`** only—you extend types and validation yourself, or import fields from OpenAPI.
+
+For the full command reference and notes, run **`aether help`**.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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,119 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import { runInit } from "./commands/init.js";
+import { runGenerate } from "./commands/generate.js";
+import { runDoctor } from "./commands/doctor.js";
+import { runCheck } from "./commands/check.js";
+import { runUpgrade } from "./commands/upgrade.js";
+import { runHelp } from "./commands/help.js";
+import { CLI_NAME, DEFAULT_APP_ENTRY, EXIT_FAIL, GENERATOR, PACKAGE_JSON } from "./core/constants.js";
+import { errorToJson, formatUserError } from "./core/errors.js";
+function readCliVersion() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkg = JSON.parse(readFileSync(join(here, "..", PACKAGE_JSON), "utf8"));
+    return pkg.version;
+}
+const program = new Command();
+program
+    .name(CLI_NAME)
+    .description("Generate Node.js backend source code")
+    .version(readCliVersion())
+    .option("--json", "Machine-readable JSON output")
+    .option("--diff", "With --dry-run, print unified diff preview")
+    .addHelpText("after", `\nFull guide: ${CLI_NAME} help\n`);
+program
+    .command("init")
+    .description("Initialize a new backend project")
+    .option("-f, --force", "Overwrite existing files in target directory")
+    .option("--dry-run", "Print planned changes without writing")
+    .action(async (options) => {
+    const globals = program.opts();
+    await runInit(process.cwd(), { ...options, json: globals.json, diff: globals.diff });
+});
+program
+    .command("upgrade")
+    .description("Report migration steps toward current Aether contract")
+    .option("--dry-run", "Report only (default)")
+    .action(async (options) => {
+    const globals = program.opts();
+    process.exitCode = await runUpgrade(process.cwd(), {
+        dryRun: options.dryRun ?? true,
+        json: globals.json,
+    });
+});
+program
+    .command("doctor")
+    .description("Diagnose environment and project layout")
+    .action(async () => {
+    const globals = program.opts();
+    process.exitCode = await runDoctor(process.cwd(), globals.json);
+});
+program
+    .command("check")
+    .description("Verify Aether project structure")
+    .action(async () => {
+    const globals = program.opts();
+    process.exitCode = await runCheck(process.cwd(), { json: globals.json });
+});
+program
+    .command("help")
+    .description("Full command guide with examples")
+    .option("--no-color", "Disable ANSI styling")
+    .action((options) => {
+    const globals = program.opts();
+    process.exitCode = runHelp({ json: globals.json, color: !options.noColor });
+});
+const generate = program
+    .command("generate")
+    .alias("g")
+    .description("Generate application code");
+generate
+    .command("openapi <spec>")
+    .description("Generate CRUD resources from an OpenAPI 3 document")
+    .option("--strict", "Fail when any OpenAPI path is skipped")
+    .option("--only <names>", "Comma-separated resource names to generate", (v) => v.split(",").map((s) => s.trim()).filter(Boolean))
+    .option("-f, --force", "Overwrite existing resource files")
+    .option("--dry-run", "Print planned changes without writing")
+    .action(async (spec, options) => {
+    const globals = program.opts();
+    await runGenerate(GENERATOR.openapi, undefined, { specPath: spec, ...options, json: globals.json, diff: globals.diff });
+});
+generate
+    .command("middleware <name>")
+    .description("Generate middleware")
+    .option("--global", `Register in ${DEFAULT_APP_ENTRY} global middleware chain`)
+    .option("-f, --force", "Overwrite existing middleware file")
+    .option("--dry-run", "Print planned changes without writing")
+    .action(async (name, options) => {
+    const globals = program.opts();
+    await runGenerate(GENERATOR.middleware, name, { ...options, json: globals.json, diff: globals.diff });
+});
+generate
+    .command("resource <name>")
+    .description("Generate a resource module")
+    .option("--crud", "Generate CRUD endpoints")
+    .option("--singular <singular>", "Singular entity name (PascalCase or camelCase)")
+    .option("--tests", "With --crud: generate tests/ on create; on existing CRUD resource: add tests only")
+    .option("-f, --force", "Overwrite existing resource files")
+    .option("--dry-run", "Print planned changes without writing")
+    .action(async (name, options) => {
+    const globals = program.opts();
+    await runGenerate(GENERATOR.resource, name, { ...options, json: globals.json, diff: globals.diff });
+});
+try {
+    await program.parseAsync(process.argv);
+}
+catch (err) {
+    const globals = program.opts();
+    if (globals.json) {
+        console.error(JSON.stringify({ ok: false, error: errorToJson(err) }, null, 2));
+    }
+    else {
+        console.error(formatUserError(err));
+    }
+    process.exitCode = EXIT_FAIL;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/check.d.ts

@@ -0,0 +1,4 @@
+export declare function runCheck(cwd: string, options: {
+    json?: boolean;
+}): Promise<number>;
+//# sourceMappingURL=check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAOA,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmCxF"}

package/dist/commands/check.js

@@ -0,0 +1,45 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { createProjectContext, loadConfig } from "../core/project.js";
+import { compositionRel } from "../core/paths.js";
+import { pathExists } from "../core/plan.js";
+import { AST_SYMBOL, EXIT_FAIL, EXIT_OK } from "../core/constants.js";
+export async function runCheck(cwd, options) {
+    const issues = [];
+    try {
+        loadConfig(cwd);
+    }
+    catch (err) {
+        issues.push(err instanceof Error ? err.message : String(err));
+    }
+    try {
+        const ctx = createProjectContext(cwd);
+        const compPath = compositionRel(ctx);
+        if (!pathExists(cwd, compPath)) {
+            issues.push(`Missing ${compPath}`);
+        }
+        else {
+            const src = readFileSync(join(cwd, compPath), "utf8");
+            if (!src.includes(`function ${AST_SYMBOL.buildAppRoutes}`)) {
+                issues.push(`${compPath} must export ${AST_SYMBOL.buildAppRoutes}()`);
+            }
+        }
+    }
+    catch (err) {
+        issues.push(err instanceof Error ? err.message : String(err));
+    }
+    const ok = issues.length === 0;
+    if (options.json) {
+        console.log(JSON.stringify({ ok, issues }, null, 2));
+    }
+    else if (ok) {
+        console.log("ok: project structure checks passed");
+    }
+    else {
+        for (const issue of issues) {
+            console.error(issue);
+        }
+    }
+    return ok ? EXIT_OK : EXIT_FAIL;
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,OAA2B;IACrE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,UAAU,CAAC,GAAG,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,WAAW,QAAQ,EAAE,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;YACtD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,UAAU,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC;gBAC3D,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,gBAAgB,UAAU,CAAC,cAAc,IAAI,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IAC/B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;SAAM,IAAI,EAAE,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClC,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,8 @@
+export interface DoctorCheck {
+    id: string;
+    ok: boolean;
+    message: string;
+}
+export declare function runDoctorChecks(cwd: string): DoctorCheck[];
+export declare function runDoctor(cwd: string, json?: boolean): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CA6C1D;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAW5E"}

package/dist/commands/doctor.js

@@ -0,0 +1,62 @@
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createProjectContext } from "../core/project.js";
+import { CONFIG_FILE, DIST_DIR, EXIT_FAIL, EXIT_OK, MIN_NODE_MAJOR, TEMPLATE_INIT_DIR, TEMPLATES_DIRNAME, } from "../core/constants.js";
+export function runDoctorChecks(cwd) {
+    const checks = [];
+    const nodeMajor = Number(process.versions.node.split(".")[0]);
+    checks.push({
+        id: "node",
+        ok: nodeMajor >= MIN_NODE_MAJOR,
+        message: nodeMajor >= MIN_NODE_MAJOR
+            ? `Node ${process.version}`
+            : `Node ${process.version} is below engines (>=${MIN_NODE_MAJOR})`,
+    });
+    try {
+        createProjectContext(cwd);
+        checks.push({ id: "project", ok: true, message: "Aether project context loads" });
+    }
+    catch (err) {
+        checks.push({
+            id: "project",
+            ok: false,
+            message: err instanceof Error ? err.message : String(err),
+        });
+    }
+    const cliRoot = join(dirname(fileURLToPath(import.meta.url)), "../..");
+    const templatesDist = join(cliRoot, DIST_DIR, TEMPLATES_DIRNAME, TEMPLATE_INIT_DIR);
+    checks.push({
+        id: "templates",
+        ok: existsSync(templatesDist),
+        message: existsSync(templatesDist)
+            ? `Packaged templates present (${DIST_DIR}/${TEMPLATES_DIRNAME})`
+            : `Run npm run build to copy templates into ${DIST_DIR}/`,
+    });
+    const configPath = join(cwd, CONFIG_FILE);
+    if (existsSync(configPath)) {
+        checks.push({ id: "config", ok: true, message: `${CONFIG_FILE} found` });
+    }
+    else {
+        checks.push({
+            id: "config",
+            ok: true,
+            message: `${CONFIG_FILE} missing (defaults apply after init)`,
+        });
+    }
+    return checks;
+}
+export async function runDoctor(cwd, json) {
+    const checks = runDoctorChecks(cwd);
+    const ok = checks.every((c) => c.ok);
+    if (json) {
+        console.log(JSON.stringify({ ok, checks }, null, 2));
+    }
+    else {
+        for (const c of checks) {
+            console.log(`${c.ok ? "ok" : "fail"} ${c.id}: ${c.message}`);
+        }
+    }
+    return ok ? EXIT_OK : EXIT_FAIL;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/commands/generate.d.ts

@@ -0,0 +1,15 @@
+import { type GeneratorName } from "../core/constants.js";
+export declare function runGenerate(kind: Exclude<GeneratorName, "project">, name: string | undefined, options: {
+    crud?: boolean;
+    singular?: string;
+    tests?: boolean;
+    specPath?: string;
+    strict?: boolean;
+    only?: string[];
+    force?: boolean;
+    global?: boolean;
+    dryRun?: boolean;
+    json?: boolean;
+    diff?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAKrE,wBAAsB,WAAW,CAC/B,IAAI,EAAE,OAAO,CAAC,aAAa,EAAE,SAAS,CAAC,EACvC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GACA,OAAO,CAAC,IAAI,CAAC,CAuCf"}

package/dist/commands/generate.js

@@ -0,0 +1,51 @@
+import { commitPlan } from "../core/plan.js";
+import { createProjectContext } from "../core/project.js";
+import { GENERATOR } from "../core/constants.js";
+import { middlewareGenerator } from "../generators/middleware.js";
+import { openapiGenerator } from "../generators/openapi.js";
+import { resourceGenerator } from "../generators/resource.js";
+export async function runGenerate(kind, name, options) {
+    const ctx = createProjectContext(process.cwd());
+    let ops;
+    if (kind === GENERATOR.middleware) {
+        if (!name)
+            throw new Error("Middleware name is required.");
+        ops = await middlewareGenerator.plan(ctx, { name, force: options.force, global: options.global });
+    }
+    else if (kind === GENERATOR.openapi) {
+        if (!options.specPath)
+            throw new Error("OpenAPI spec path is required.");
+        ops = await openapiGenerator.plan(ctx, {
+            specPath: options.specPath,
+            force: options.force,
+            strict: options.strict,
+            only: options.only,
+        });
+    }
+    else {
+        if (!name)
+            throw new Error("Resource name is required.");
+        ops = await resourceGenerator.plan(ctx, {
+            name,
+            crud: options.crud,
+            singular: options.singular,
+            tests: options.tests,
+            force: options.force,
+        });
+    }
+    await commitPlan(ctx.root, ops, {
+        dryRun: options.dryRun,
+        force: options.force,
+        json: options.json,
+        showDiff: options.diff,
+    });
+    if (!options.dryRun && !options.json) {
+        if (kind === GENERATOR.openapi) {
+            console.log(`Generated from OpenAPI "${options.specPath}"`);
+        }
+        else {
+            console.log(`Generated ${kind} "${name}"`);
+        }
+    }
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAsB,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAuC,EACvC,IAAwB,EACxB,OAYC;IAED,MAAM,GAAG,GAAG,oBAAoB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAEhD,IAAI,GAAG,CAAC;IACR,IAAI,IAAI,KAAK,SAAS,CAAC,UAAU,EAAE,CAAC;QAClC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC3D,GAAG,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpG,CAAC;SAAM,IAAI,IAAI,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACzE,GAAG,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE;YACrC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACzD,GAAG,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,GAAG,EAAE;YACtC,IAAI;YACJ,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE;QAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,IAAI;KACvB,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,IAAI,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,2BAA2B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC9D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,KAAK,IAAI,GAAG,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/commands/help.d.ts

@@ -0,0 +1,6 @@
+export declare function resolveHelpGuidePath(): string;
+export declare function runHelp(options: {
+    json?: boolean;
+    color?: boolean;
+}): number;
+//# 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":"AAYA,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C;AA8BD,wBAAgB,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAY5E"}

package/dist/commands/help.js

@@ -0,0 +1,60 @@
+import { readFileSync, existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { CLI_NAME, EXIT_OK } from "../core/constants.js";
+import { ChiselError, ErrorCode } from "../core/errors.js";
+const ESC = "\x1b";
+const bold = (s) => `${ESC}[1m${s}${ESC}[0m`;
+const dim = (s) => `${ESC}[2m${s}${ESC}[0m`;
+const cyan = (s) => `${ESC}[36m${s}${ESC}[0m`;
+const green = (s) => `${ESC}[32m${s}${ESC}[0m`;
+export function resolveHelpGuidePath() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const packaged = join(here, "..", "help", "guide.txt");
+    if (existsSync(packaged)) {
+        return packaged;
+    }
+    const dev = join(here, "..", "..", "help", "guide.txt");
+    if (existsSync(dev)) {
+        return dev;
+    }
+    throw new ChiselError(ErrorCode.NOT_FOUND, "Help guide missing. Run npm run build.");
+}
+function paintGuide(raw, color) {
+    if (!color) {
+        return raw;
+    }
+    return raw
+        .split("\n")
+        .map((line) => {
+        if (line.includes("┌") || line.includes("└") || line.includes("│")) {
+            return cyan(line);
+        }
+        if (/^  [A-Z][A-Z0-9 ]+$/.test(line)) {
+            return bold(cyan(line.trimEnd()));
+        }
+        if (/^  ─/.test(line)) {
+            return dim(line);
+        }
+        if (line.startsWith(`    ${CLI_NAME} `)) {
+            return `    ${green(CLI_NAME)}${line.slice(`    ${CLI_NAME}`.length)}`;
+        }
+        if (line.startsWith(`      ${CLI_NAME} `)) {
+            return `      ${green(CLI_NAME)}${line.slice(`      ${CLI_NAME}`.length)}`;
+        }
+        return line;
+    })
+        .join("\n");
+}
+export function runHelp(options) {
+    const path = resolveHelpGuidePath();
+    const text = readFileSync(path, "utf8");
+    const useColor = options.color !== false && process.stdout.isTTY;
+    if (options.json) {
+        console.log(JSON.stringify({ ok: true, guide: text.trim() }, null, 2));
+        return EXIT_OK;
+    }
+    console.log(paintGuide(text, useColor).trimEnd());
+    return EXIT_OK;
+}
+//# 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":"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"}

package/dist/commands/init.d.ts

@@ -0,0 +1,7 @@
+export declare function runInit(cwd: string, options: {
+    force?: boolean;
+    dryRun?: boolean;
+    json?: boolean;
+    diff?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7E,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/commands/init.js

@@ -0,0 +1,24 @@
+import { commitPlan } from "../core/plan.js";
+import { projectGenerator } from "../generators/project.js";
+import { CONFIG_VERSION, DEFAULT_APP_ENTRY, DEFAULT_SRC_DIR } from "../core/constants.js";
+export async function runInit(cwd, options) {
+    const ctx = {
+        root: cwd,
+        config: { version: CONFIG_VERSION, srcDir: DEFAULT_SRC_DIR, appEntry: DEFAULT_APP_ENTRY },
+        appEntryPath: "",
+    };
+    const ops = await projectGenerator.plan(ctx, {
+        targetRoot: cwd,
+        force: options.force,
+    });
+    await commitPlan(cwd, ops, {
+        dryRun: options.dryRun,
+        force: options.force,
+        json: options.json,
+        showDiff: options.diff,
+    });
+    if (!options.dryRun && !options.json) {
+        console.log("Project initialized. Run npm install && npm run dev");
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE1F,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAW,EACX,OAA8E;IAE9E,MAAM,GAAG,GAAG;QACV,IAAI,EAAE,GAAG;QACT,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,iBAAiB,EAAE;QACzF,YAAY,EAAE,EAAE;KACjB,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE;QAC3C,UAAU,EAAE,GAAG;QACf,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IACH,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE;QACzB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,IAAI;KACvB,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACrE,CAAC;AACH,CAAC"}

package/dist/commands/upgrade.d.ts

@@ -0,0 +1,5 @@
+export declare function runUpgrade(cwd: string, options: {
+    dryRun?: boolean;
+    json?: boolean;
+}): Promise<number>;
+//# sourceMappingURL=upgrade.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAMA,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC5G"}