nestia 14.0.0 → 14.0.2

package/README.md

@@ -60,7 +60,7 @@ Check out the document in the [website](https://nestia.io/docs/):
 ### 🏠 Home
   - [Introduction](https://nestia.io/docs/)
   - [Setup](https://nestia.io/docs/setup/)
-  - [Pure TypeScript](https://nestia.io/docs/pure)
+  - [Pure TypeScript](https://nestia.io/docs/core/TypedBody/)
 
 ### 📖 Features
   - Core Library

package/bin/NestiaProjectTemplate.d.ts

@@ -1,22 +1,93 @@
+/**
+ * Scaffolds a project from a template repository for `nestia start` and `nestia
+ * template`.
+ *
+ * The flow clones the repository, installs, builds, optionally tests, and then
+ * deletes the repository-only files. Command and file-system operations go
+ * through an injected `IContext`, so unit tests need no network or package
+ * manager. Logging and the corepack prompt environment flag remain process
+ * effects.
+ *
+ * @evidence contracts/common.md#principled-implementation The scaffold is the fixed sequence clone, install, build, optional test, cleanup, each step one explicit-argument command; the package manager is chosen by probing `pnpm` and then `corepack` because the template repositories are pnpm monorepos whose `catalog:` protocol npm cannot resolve.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace owns the flow: clone is the sequence, IContext is the injected command/file-system boundary, and private parse, getPackageManager and commandOf each answer one question; NestiaStarter and NestiaTemplate bind a title, URL and test flag.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Both templates run the identical flow parameterized by props, with no repository-name branches; the only ambient write is the documented corepack variable `COREPACK_ENABLE_DOWNLOAD_PROMPT`, set in the corepack branch to keep the prompt from blocking a scripted run.
+ * @evidence contracts/common.md#meaningful-documentation The namespace prose states what the flow does, its ordering, and why side effects are injected; the nested types and `clone` carry their own documentation.
+ * @evidence contracts/portability.md#os-neutral-implementation The only platform difference is how a program is launched. `git` runs directly through `execFileSync` with an argument array, while `pnpm` and `corepack`, which Windows installs as `.cmd` shims that Node refuses to start without a shell, run through `cmd.exe /d /s /c` with their fixed arguments on Windows and directly elsewhere. The repository and the destination are never part of a shell command line. The destination is a path relative to the current directory, its existence is the filesystem's own answer, and the directory change and the removal use Node's native calls. Remaining assumptions: `git` and a package manager are on `PATH`, and on a case-insensitive volume a destination spelled in another case than an existing directory is refused while a case-sensitive volume would accept it.
+ */
 export declare namespace NestiaProjectTemplate {
     /**
      * Side effects performed while scaffolding a template project.
      *
      * Injected so that the scaffolding flow can be unit tested without touching
      * the network, the file system, or a real package manager.
+     *
+     * @evidence contracts/common.md#principled-implementation The interface represents command execution/probing, directory changes, existence checks and removal as function members, so a fake can record those operations and production can delegate them to child_process and fs. Logging and the corepack prompt flag are separate process effects documented by the namespace.
+     * @evidence contracts/common.md#clear-and-simple-design Five members, one per distinct effect, with no default behavior in the type; the real implementation is the private `CONTEXT` constant, which keeps the interface a pure seam.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The seam exists because the flow performs process and file-system effects, not to serve a particular test: the production `CONTEXT` implements every member with the real operation.
+     * @evidence contracts/common.md#meaningful-documentation The type documentation says the effects are injected for offline testing, and each member states its contract in one sentence.
+     * @evidence contracts/portability.md#os-neutral-implementation The interface names the effects whose platform spelling lives in the production context: launching a program with an argument vector, silent probing of an executable, changing the working directory, testing existence and removing a tree.
      */
     interface IContext {
-        /** Runs an executable with explicit arguments, inheriting stdio. */
+        /**
+         * Runs an executable with explicit arguments, inheriting stdio.
+         *
+         * @evidence contracts/common.md#principled-implementation An executable and an argument array, never a command string, mirror `execFileSync` semantics, so the flow never depends on shell quoting; inherited stdio lets the user see the clone and install output.
+         * @evidence contracts/common.md#clear-and-simple-design One member for commands whose output the user must see and whose failure must stop the flow, separate from the silent `probe`.
+         * @evidence contracts/common.md#prohibited-implementation-shortcuts The production implementation runs the requested command; no command is skipped or rewritten based on the repository or destination.
+         * @evidence contracts/common.md#meaningful-documentation The comment states the argument representation and that stdio is inherited.
+         * @evidence contracts/portability.md#os-neutral-implementation The executable and its arguments are separate values, so no quoting rule of any shell is part of the contract, and standard streams are inherited so the platform's terminal shows the program's output.
+         */
         execute: (executable: string, args: readonly string[]) => void;
-        /** Silently checks whether an executable accepts the supplied arguments. */
+        /**
+         * Silently checks whether an executable accepts the supplied arguments.
+         *
+         * @evidence contracts/common.md#principled-implementation A probe runs the executable with the given arguments and reports success as a boolean, which is enough to decide whether `pnpm --version` or `corepack --version` is available without interpreting output.
+         * @evidence contracts/common.md#clear-and-simple-design Separate from `execute` because a probe is silent and its failure is an answer rather than an error.
+         * @evidence contracts/common.md#prohibited-implementation-shortcuts Availability is decided by actually invoking the tool; no PATH scan is guessed and no tool name is assumed present.
+         * @evidence contracts/common.md#meaningful-documentation The comment states that the check is silent and returns whether the executable accepted the arguments.
+         * @evidence contracts/portability.md#os-neutral-implementation A program that cannot be started, as a missing executable on any platform, and one that exits non-zero both answer `false`, because the production context catches the failure of `execFileSync` instead of distinguishing platform error codes.
+         */
         probe: (executable: string, args: readonly string[]) => boolean;
-        /** Changes the working directory. */
+        /**
+         * Changes the working directory.
+         *
+         * @evidence contracts/common.md#principled-implementation The flow must run install and build inside the cloned directory, and changing the working directory of the process is the one operation that redirects every later relative command.
+         * @evidence contracts/common.md#clear-and-simple-design A single-purpose member so a fake can record the directory the flow entered.
+         * @evidence contracts/common.md#prohibited-implementation-shortcuts The production implementation calls `process.chdir` on the requested path, with no fallback directory.
+         * @evidence contracts/common.md#meaningful-documentation The comment names the effect, a working-directory change.
+         * @evidence contracts/portability.md#os-neutral-implementation `process.chdir` changes the working directory of the whole process, so the flow supports one scaffold per process at a time.
+         */
         chdir: (directory: string) => void;
-        /** Checks whether a path exists. */
+        /**
+         * Checks whether a path exists.
+         *
+         * @evidence contracts/common.md#principled-implementation Refusing to scaffold into an existing directory needs one boolean existence check for the destination path.
+         * @evidence contracts/common.md#clear-and-simple-design One question with one boolean answer, kept apart from removal.
+         * @evidence contracts/common.md#prohibited-implementation-shortcuts The production implementation asks the file system directly, with no cached listing.
+         * @evidence contracts/common.md#meaningful-documentation The comment states that it checks whether a path exists.
+         * @evidence contracts/portability.md#os-neutral-implementation Node's `existsSync` lets the volume decide the case policy and the links, and nothing is canonicalized.
+         */
         exists: (path: string) => boolean;
-        /** Removes a path recursively, ignoring missing entries. */
+        /**
+         * Removes a path recursively, ignoring missing entries.
+         *
+         * @evidence contracts/common.md#principled-implementation Deleting the repository-only files (`.git`, `.github/dependabot.yml`) after scaffolding is a recursive removal that must succeed when the entry is already absent.
+         * @evidence contracts/common.md#clear-and-simple-design One effect, isolated so a fake can record which paths the flow removed.
+         * @evidence contracts/common.md#prohibited-implementation-shortcuts The production implementation uses `fs.rmSync` with `recursive` and `force`, which is the supported way to make a missing path a no-op, not a swallowed error handler.
+         * @evidence contracts/common.md#meaningful-documentation The comment states that removal is recursive and ignores missing entries.
+         * @evidence contracts/portability.md#os-neutral-implementation `fs.rmSync` with `recursive` and `force` also removes the read-only files a clone leaves in `.git` on Windows, and a missing entry is not an error on any platform.
+         */
         remove: (path: string) => void;
     }
+    /**
+     * Per-template constants that parameterize the shared scaffolding flow.
+     *
+     * @evidence contracts/common.md#principled-implementation The three fields are the only differences between the starter and the template kits: what to announce, where to clone from, and whether to run the tests.
+     * @evidence contracts/common.md#clear-and-simple-design A flat record of per-template constants with no behavior.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Template-specific values live in data passed to one flow, which avoids branching on a template name inside the flow.
+     * @evidence contracts/common.md#meaningful-documentation Each field documents its role, including that the repository is overridable through `--repository <url>`.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation The record holds a banner, a URL string and a flag, which are ordinary options and not a path or process representation; the repository is passed to git as one argument.
+     */
     interface IProps {
         /** Banner title printed before cloning. */
         title: string;
@@ -25,5 +96,20 @@ export declare namespace NestiaProjectTemplate {
         /** Whether to run the test suite after building. */
         test: boolean;
     }
+    /**
+     * Creates the `nestia start` or `nestia template` command for one template.
+     *
+     * The returned function takes a halter that terminates the process, an
+     * optional context, and the command-line arguments after the sub-command. It
+     * halts when the destination is missing or already exists, when the
+     * destination or the repository starts with a dash, when `--repository` has
+     * no value, or when neither pnpm nor corepack is available.
+     *
+     * @evidence contracts/common.md#principled-implementation Currying separates the per-template props from the halter and context injected at the call site. Argument and destination validation precede cloning, and a destination or repository that starts with a dash is refused because git would read it as an option; package-manager availability is checked after entering the clone, so an unavailable manager leaves that clone in place without installing or building it. Ordered execute calls implement the documented scaffold sequence.
+     * @evidence contracts/common.md#clear-and-simple-design One curried function keeps the sequence readable in one place, delegating parsing, package-manager selection, and command shaping to private helpers rather than to options.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The flow contains no fixture or repository names, and the injected context is the production seam: the default `CONTEXT` performs the real clone, install, build, and cleanup.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the halting conditions and the injected parameters, and section comments inside the body mark the phases.
+     * @evidence contracts/portability.md#os-neutral-implementation Every program invocation is one `execute` call with an argument vector, and the pnpm or corepack choice is made by probing, not by an operating-system name. A destination or repository starting with a dash is refused, since git would read it as an option and the vector has no separator.
+     */
     const clone: (props: IProps) => (halter: (msg?: string) => never, context?: IContext) => (argv: string[]) => Promise<void>;
 }

package/bin/NestiaProjectTemplate.js

@@ -15,13 +15,46 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NestiaProjectTemplate = void 0;
 const child_process_1 = __importDefault(require("child_process"));
 const fs_1 = __importDefault(require("fs"));
+/**
+ * Scaffolds a project from a template repository for `nestia start` and `nestia
+ * template`.
+ *
+ * The flow clones the repository, installs, builds, optionally tests, and then
+ * deletes the repository-only files. Command and file-system operations go
+ * through an injected `IContext`, so unit tests need no network or package
+ * manager. Logging and the corepack prompt environment flag remain process
+ * effects.
+ *
+ * @evidence contracts/common.md#principled-implementation The scaffold is the fixed sequence clone, install, build, optional test, cleanup, each step one explicit-argument command; the package manager is chosen by probing `pnpm` and then `corepack` because the template repositories are pnpm monorepos whose `catalog:` protocol npm cannot resolve.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace owns the flow: clone is the sequence, IContext is the injected command/file-system boundary, and private parse, getPackageManager and commandOf each answer one question; NestiaStarter and NestiaTemplate bind a title, URL and test flag.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Both templates run the identical flow parameterized by props, with no repository-name branches; the only ambient write is the documented corepack variable `COREPACK_ENABLE_DOWNLOAD_PROMPT`, set in the corepack branch to keep the prompt from blocking a scripted run.
+ * @evidence contracts/common.md#meaningful-documentation The namespace prose states what the flow does, its ordering, and why side effects are injected; the nested types and `clone` carry their own documentation.
+ * @evidence contracts/portability.md#os-neutral-implementation The only platform difference is how a program is launched. `git` runs directly through `execFileSync` with an argument array, while `pnpm` and `corepack`, which Windows installs as `.cmd` shims that Node refuses to start without a shell, run through `cmd.exe /d /s /c` with their fixed arguments on Windows and directly elsewhere. The repository and the destination are never part of a shell command line. The destination is a path relative to the current directory, its existence is the filesystem's own answer, and the directory change and the removal use Node's native calls. Remaining assumptions: `git` and a package manager are on `PATH`, and on a case-insensitive volume a destination spelled in another case than an existing directory is refused while a case-sensitive volume would accept it.
+ */
 var NestiaProjectTemplate;
 (function (NestiaProjectTemplate) {
+    /**
+     * Creates the `nestia start` or `nestia template` command for one template.
+     *
+     * The returned function takes a halter that terminates the process, an
+     * optional context, and the command-line arguments after the sub-command. It
+     * halts when the destination is missing or already exists, when the
+     * destination or the repository starts with a dash, when `--repository` has
+     * no value, or when neither pnpm nor corepack is available.
+     *
+     * @evidence contracts/common.md#principled-implementation Currying separates the per-template props from the halter and context injected at the call site. Argument and destination validation precede cloning, and a destination or repository that starts with a dash is refused because git would read it as an option; package-manager availability is checked after entering the clone, so an unavailable manager leaves that clone in place without installing or building it. Ordered execute calls implement the documented scaffold sequence.
+     * @evidence contracts/common.md#clear-and-simple-design One curried function keeps the sequence readable in one place, delegating parsing, package-manager selection, and command shaping to private helpers rather than to options.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The flow contains no fixture or repository names, and the injected context is the production seam: the default `CONTEXT` performs the real clone, install, build, and cleanup.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the halting conditions and the injected parameters, and section comments inside the body mark the phases.
+     * @evidence contracts/portability.md#os-neutral-implementation Every program invocation is one `execute` call with an argument vector, and the pnpm or corepack choice is made by probing, not by an operating-system name. A destination or repository starting with a dash is refused, since git would read it as an option and the vector has no separator.
+     */
     NestiaProjectTemplate.clone = (props) => (halter, context = CONTEXT) => (argv) => __awaiter(this, void 0, void 0, function* () {
         // VALIDATION
         const { dest, repository } = parse(argv, halter);
         if (dest === undefined)
             halter();
+        else if (dest.startsWith("-") || (repository === null || repository === void 0 ? void 0 : repository.startsWith("-")) === true)
+            halter("The destination and the repository must not start with a dash, which git would read as an option.");
         else if (context.exists(dest) === true)
             halter("The target directory already exists.");
         console.log("-----------------------------------------");
@@ -77,8 +110,9 @@ var NestiaProjectTemplate;
             "",
             "  npm install --global pnpm",
             "",
-            "or activate it through corepack (bundled with Node.js):",
+            "or install and activate corepack:",
             "",
+            "  npm install --global corepack",
             "  corepack enable",
         ].join("\n"));
     }

package/bin/NestiaProjectTemplate.js.map

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

package/bin/NestiaStarter.d.ts

@@ -1,4 +1,14 @@
 import { NestiaProjectTemplate } from "./NestiaProjectTemplate.js";
+/**
+ * The `nestia start` command: clones the Nestia starter kit, builds it, and
+ * runs its tests.
+ *
+ * @evidence contracts/common.md#principled-implementation It binds the starter kit's title and repository and enables the test step, which is all that distinguishes it from the template command, so its behavior is exactly the shared flow's.
+ * @evidence contracts/common.md#clear-and-simple-design A one-member namespace whose only job is naming the bound command that `index.ts` imports lazily.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The values are contract constants (the published starter repository URL), not special cases of any consumer.
+ * @evidence contracts/common.md#meaningful-documentation The comment names the command and what it does; the shared flow documents the details.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation This namespace supplies a title, repository URL and test flag to the shared scaffolder; it does not launch processes or interpret native paths.
+ */
 export declare namespace NestiaStarter {
     const clone: (halter: (msg?: string) => never, context?: NestiaProjectTemplate.IContext) => (argv: string[]) => Promise<void>;
 }

package/bin/NestiaStarter.js

@@ -2,6 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NestiaStarter = void 0;
 const NestiaProjectTemplate_js_1 = require("./NestiaProjectTemplate.js");
+/**
+ * The `nestia start` command: clones the Nestia starter kit, builds it, and
+ * runs its tests.
+ *
+ * @evidence contracts/common.md#principled-implementation It binds the starter kit's title and repository and enables the test step, which is all that distinguishes it from the template command, so its behavior is exactly the shared flow's.
+ * @evidence contracts/common.md#clear-and-simple-design A one-member namespace whose only job is naming the bound command that `index.ts` imports lazily.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The values are contract constants (the published starter repository URL), not special cases of any consumer.
+ * @evidence contracts/common.md#meaningful-documentation The comment names the command and what it does; the shared flow documents the details.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation This namespace supplies a title, repository URL and test flag to the shared scaffolder; it does not launch processes or interpret native paths.
+ */
 var NestiaStarter;
 (function (NestiaStarter) {
     NestiaStarter.clone = NestiaProjectTemplate_js_1.NestiaProjectTemplate.clone({

package/bin/NestiaStarter.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaStarter.js","sourceRoot":"","sources":["../src/NestiaStarter.ts"],"names":[],"mappings":";;;AAAA,yEAAmE;AAEnE,IAAiB,aAAa,CAM7B;AAND,WAAiB,aAAa;IACf,mBAAK,GAAG,gDAAqB,CAAC,KAAK,CAAC;QAC/C,KAAK,EAAE,oBAAoB;QAC3B,UAAU,EAAE,yCAAyC;QACrD,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;AACL,CAAC,EANgB,aAAa,aAAb,aAAa,GAAb,aAAa,QAM7B"}
+{"version":3,"file":"NestiaStarter.js","sourceRoot":"","sources":["../src/NestiaStarter.ts"],"names":[],"mappings":";;;AAAA,yEAAmE;AAEnE;;;;;;;;;GASG;AACH,IAAiB,aAAa,CAM7B;AAND,WAAiB,aAAa;IACf,mBAAK,GAAG,gDAAqB,CAAC,KAAK,CAAC;QAC/C,KAAK,EAAE,oBAAoB;QAC3B,UAAU,EAAE,yCAAyC;QACrD,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;AACL,CAAC,EANgB,aAAa,aAAb,aAAa,GAAb,aAAa,QAM7B"}

package/bin/NestiaTemplate.d.ts

@@ -1,4 +1,14 @@
 import { NestiaProjectTemplate } from "./NestiaProjectTemplate.js";
+/**
+ * The `nestia template` command: clones the backend template kit and builds it
+ * without running its tests.
+ *
+ * @evidence contracts/common.md#principled-implementation It binds the template kit's title and repository with the test step disabled, so its behavior is exactly the shared flow's with that one difference.
+ * @evidence contracts/common.md#clear-and-simple-design A one-member namespace whose only job is naming the bound command that `index.ts` imports lazily.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The values are contract constants (the published template repository URL), not special cases of any consumer.
+ * @evidence contracts/common.md#meaningful-documentation The comment names the command and its difference from the starter; the shared flow documents the details.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation This namespace supplies a title, repository URL and test flag to the shared scaffolder; it does not launch processes or interpret native paths.
+ */
 export declare namespace NestiaTemplate {
     const clone: (halter: (msg?: string) => never, context?: NestiaProjectTemplate.IContext) => (argv: string[]) => Promise<void>;
 }

package/bin/NestiaTemplate.js

@@ -2,6 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NestiaTemplate = void 0;
 const NestiaProjectTemplate_js_1 = require("./NestiaProjectTemplate.js");
+/**
+ * The `nestia template` command: clones the backend template kit and builds it
+ * without running its tests.
+ *
+ * @evidence contracts/common.md#principled-implementation It binds the template kit's title and repository with the test step disabled, so its behavior is exactly the shared flow's with that one difference.
+ * @evidence contracts/common.md#clear-and-simple-design A one-member namespace whose only job is naming the bound command that `index.ts` imports lazily.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The values are contract constants (the published template repository URL), not special cases of any consumer.
+ * @evidence contracts/common.md#meaningful-documentation The comment names the command and its difference from the starter; the shared flow documents the details.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation This namespace supplies a title, repository URL and test flag to the shared scaffolder; it does not launch processes or interpret native paths.
+ */
 var NestiaTemplate;
 (function (NestiaTemplate) {
     NestiaTemplate.clone = NestiaProjectTemplate_js_1.NestiaProjectTemplate.clone({

package/bin/NestiaTemplate.js.map

@@ -1 +1 @@
-{"version":3,"file":"NestiaTemplate.js","sourceRoot":"","sources":["../src/NestiaTemplate.ts"],"names":[],"mappings":";;;AAAA,yEAAmE;AAEnE,IAAiB,cAAc,CAM9B;AAND,WAAiB,cAAc;IAChB,oBAAK,GAAG,gDAAqB,CAAC,KAAK,CAAC;QAC/C,KAAK,EAAE,qBAAqB;QAC5B,UAAU,EAAE,oCAAoC;QAChD,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;AACL,CAAC,EANgB,cAAc,aAAd,cAAc,GAAd,cAAc,QAM9B"}
+{"version":3,"file":"NestiaTemplate.js","sourceRoot":"","sources":["../src/NestiaTemplate.ts"],"names":[],"mappings":";;;AAAA,yEAAmE;AAEnE;;;;;;;;;GASG;AACH,IAAiB,cAAc,CAM9B;AAND,WAAiB,cAAc;IAChB,oBAAK,GAAG,gDAAqB,CAAC,KAAK,CAAC;QAC/C,KAAK,EAAE,qBAAqB;QAC5B,UAAU,EAAE,oCAAoC;QAChD,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;AACL,CAAC,EANgB,cAAc,aAAd,cAAc,GAAd,cAAc,QAM9B"}

package/bin/index.d.ts

@@ -1,4 +1,15 @@
 #!/usr/bin/env node
-declare const USAGE = "Wrong command has been detected. Use like below:\n\nnpx nestia [command] [options?]\n\n  1. npx nestia start <directory> [--repository <url>]\n  2. npx nestia template <directory> [--repository <url>]\n  3. npx nestia dependencies\n  4. npx nestia init\n  5. npx nestia sdk\n  6. npx nestia swagger [--watch]\n  7. npx nestia e2e\n  8. npx nestia all\n";
-declare function halt(desc: string): never;
-declare function main(): Promise<void>;
+/**
+ * Dispatches the command in the current process arguments.
+ *
+ * Scaffold commands load only their engine. Generator commands require the
+ * installed SDK executable, which reads the unchanged process arguments itself.
+ * Missing SDK installation and unsupported commands terminate with guidance.
+ *
+ * @evidence contracts/common.md#principled-implementation The command discriminant chooses the corresponding scaffold or the SDK executable; slicing arguments after the subcommand preserves the scaffolder's option values, while importing the SDK retains its process-argument contract.
+ * @evidence contracts/common.md#clear-and-simple-design One dispatcher owns command selection and SDK installation guidance. The scaffold engines own their lifecycle, and the SDK executable owns generator behavior.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The recognized names are the documented CLI commands, and require.resolve checks the installed SDK instead of guessing a workspace location or replacing its implementation.
+ * @evidence contracts/common.md#meaningful-documentation The comment identifies lazy dispatch, the SDK argument ownership and terminal failures; USAGE lists the supported invocations.
+ * @evidence contracts/portability.md#os-neutral-implementation Node module resolution locates the SDK through its package address on the current installation; relative module imports locate scaffold engines. The dispatcher launches no subprocess and leaves native executable handling to those engines.
+ */
+export declare function main(): Promise<void>;

package/bin/index.js

@@ -42,6 +42,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
 const USAGE = `Wrong command has been detected. Use like below:
 
 npx nestia [command] [options?]
@@ -59,6 +61,19 @@ function halt(desc) {
     console.error(desc);
     process.exit(-1);
 }
+/**
+ * Dispatches the command in the current process arguments.
+ *
+ * Scaffold commands load only their engine. Generator commands require the
+ * installed SDK executable, which reads the unchanged process arguments itself.
+ * Missing SDK installation and unsupported commands terminate with guidance.
+ *
+ * @evidence contracts/common.md#principled-implementation The command discriminant chooses the corresponding scaffold or the SDK executable; slicing arguments after the subcommand preserves the scaffolder's option values, while importing the SDK retains its process-argument contract.
+ * @evidence contracts/common.md#clear-and-simple-design One dispatcher owns command selection and SDK installation guidance. The scaffold engines own their lifecycle, and the SDK executable owns generator behavior.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The recognized names are the documented CLI commands, and require.resolve checks the installed SDK instead of guessing a workspace location or replacing its implementation.
+ * @evidence contracts/common.md#meaningful-documentation The comment identifies lazy dispatch, the SDK argument ownership and terminal failures; USAGE lists the supported invocations.
+ * @evidence contracts/portability.md#os-neutral-implementation Node module resolution locates the SDK through its package address on the current installation; relative module imports locate scaffold engines. The dispatcher launches no subprocess and leaves native executable handling to those engines.
+ */
 function main() {
     return __awaiter(this, void 0, void 0, function* () {
         const type = process.argv[2];

package/bin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,MAAM,KAAK,GAAG;;;;;;;;;;;;CAYb,CAAC;AAEF,SAAS,IAAI,CAAC,IAAY;IACxB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED,SAAe,IAAI;;QACjB,MAAM,IAAI,GAAuB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,IAAI,GAAa,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE7C,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,MAAM,CACJ,wDAAa,oBAAoB,GAAC,CACnC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,CACJ,wDAAa,qBAAqB,GAAC,CACpC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;aAAM,IACL,IAAI,KAAK,cAAc;YACvB,IAAI,KAAK,MAAM;YACf,IAAI,KAAK,KAAK;YACd,IAAI,KAAK,SAAS;YAClB,IAAI,KAAK,KAAK;YACd,IAAI,KAAK,KAAK,EACd,CAAC;YACD,MAAM,QAAQ,GAAW,gCAAgC,CAAC;YAC1D,IAAI,CAAC;gBACH,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;uBAAO,CAAC;gBACP,IAAI,CACF;oBACE,qCAAqC;oBACrC,0BAA0B;oBAC1B,4BAA4B;oBAC5B,wDAAwD;oBACxD,mBAAmB;iBACpB,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;YACJ,CAAC;YACD,yBAAa,QAAQ,uCAAC,CAAC;QACzB,CAAC;;YAAM,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;CAAA;AACD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,MAAM,KAAK,GAAG;;;;;;;;;;;;CAYb,CAAC;AAEF,SAAS,IAAI,CAAC,IAAY;IACxB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH;;QACE,MAAM,IAAI,GAAuB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,IAAI,GAAa,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAE7C,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,MAAM,CACJ,wDAAa,oBAAoB,GAAC,CACnC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC;aAAM,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,CACJ,wDAAa,qBAAqB,GAAC,CACpC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC;aAAM,IACL,IAAI,KAAK,cAAc;YACvB,IAAI,KAAK,MAAM;YACf,IAAI,KAAK,KAAK;YACd,IAAI,KAAK,SAAS;YAClB,IAAI,KAAK,KAAK;YACd,IAAI,KAAK,KAAK,EACd,CAAC;YACD,MAAM,QAAQ,GAAW,gCAAgC,CAAC;YAC1D,IAAI,CAAC;gBACH,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;uBAAO,CAAC;gBACP,IAAI,CACF;oBACE,qCAAqC;oBACrC,0BAA0B;oBAC1B,4BAA4B;oBAC5B,wDAAwD;oBACxD,mBAAmB;iBACpB,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;YACJ,CAAC;YACD,yBAAa,QAAQ,uCAAC,CAAC;QACzB,CAAC;;YAAM,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;CAAA;AACD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nestia",
-  "version": "14.0.0",
+  "version": "14.0.2",
   "description": "Nestia CLI tool",
   "main": "bin/index.js",
   "bin": {
@@ -35,8 +35,8 @@
   "devDependencies": {
     "@types/node": "^25.3.3",
     "rimraf": "^6.1.3",
-    "@nestia/core": "^14.0.0",
-    "@nestia/sdk": "^14.0.0"
+    "@nestia/core": "^14.0.2",
+    "@nestia/sdk": "^14.0.2"
   },
   "files": [
     "bin",
@@ -50,7 +50,8 @@
   },
   "scripts": {
     "build": "rimraf bin && ttsc",
-    "dev": "rimraf bin && ttsc --watch"
+    "dev": "rimraf bin && ttsc --watch",
+    "evidence": "evidence"
   },
   "types": "bin/index.d.ts"
 }

package/src/NestiaProjectTemplate.ts

@@ -1,35 +1,127 @@
 import cp from "child_process";
 import fs from "fs";
 
+/**
+ * Scaffolds a project from a template repository for `nestia start` and `nestia
+ * template`.
+ *
+ * The flow clones the repository, installs, builds, optionally tests, and then
+ * deletes the repository-only files. Command and file-system operations go
+ * through an injected `IContext`, so unit tests need no network or package
+ * manager. Logging and the corepack prompt environment flag remain process
+ * effects.
+ *
+ * @evidence contracts/common.md#principled-implementation The scaffold is the fixed sequence clone, install, build, optional test, cleanup, each step one explicit-argument command; the package manager is chosen by probing `pnpm` and then `corepack` because the template repositories are pnpm monorepos whose `catalog:` protocol npm cannot resolve.
+ * @evidence contracts/common.md#clear-and-simple-design One namespace owns the flow: clone is the sequence, IContext is the injected command/file-system boundary, and private parse, getPackageManager and commandOf each answer one question; NestiaStarter and NestiaTemplate bind a title, URL and test flag.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Both templates run the identical flow parameterized by props, with no repository-name branches; the only ambient write is the documented corepack variable `COREPACK_ENABLE_DOWNLOAD_PROMPT`, set in the corepack branch to keep the prompt from blocking a scripted run.
+ * @evidence contracts/common.md#meaningful-documentation The namespace prose states what the flow does, its ordering, and why side effects are injected; the nested types and `clone` carry their own documentation.
+ * @evidence contracts/portability.md#os-neutral-implementation The only platform difference is how a program is launched. `git` runs directly through `execFileSync` with an argument array, while `pnpm` and `corepack`, which Windows installs as `.cmd` shims that Node refuses to start without a shell, run through `cmd.exe /d /s /c` with their fixed arguments on Windows and directly elsewhere. The repository and the destination are never part of a shell command line. The destination is a path relative to the current directory, its existence is the filesystem's own answer, and the directory change and the removal use Node's native calls. Remaining assumptions: `git` and a package manager are on `PATH`, and on a case-insensitive volume a destination spelled in another case than an existing directory is refused while a case-sensitive volume would accept it.
+ */
 export namespace NestiaProjectTemplate {
   /**
    * Side effects performed while scaffolding a template project.
    *
    * Injected so that the scaffolding flow can be unit tested without touching
    * the network, the file system, or a real package manager.
+   *
+   * @evidence contracts/common.md#principled-implementation The interface represents command execution/probing, directory changes, existence checks and removal as function members, so a fake can record those operations and production can delegate them to child_process and fs. Logging and the corepack prompt flag are separate process effects documented by the namespace.
+   * @evidence contracts/common.md#clear-and-simple-design Five members, one per distinct effect, with no default behavior in the type; the real implementation is the private `CONTEXT` constant, which keeps the interface a pure seam.
+   * @evidence contracts/common.md#prohibited-implementation-shortcuts The seam exists because the flow performs process and file-system effects, not to serve a particular test: the production `CONTEXT` implements every member with the real operation.
+   * @evidence contracts/common.md#meaningful-documentation The type documentation says the effects are injected for offline testing, and each member states its contract in one sentence.
+   * @evidence contracts/portability.md#os-neutral-implementation The interface names the effects whose platform spelling lives in the production context: launching a program with an argument vector, silent probing of an executable, changing the working directory, testing existence and removing a tree.
    */
   export interface IContext {
-    /** Runs an executable with explicit arguments, inheriting stdio. */
+    /**
+     * Runs an executable with explicit arguments, inheriting stdio.
+     *
+     * @evidence contracts/common.md#principled-implementation An executable and an argument array, never a command string, mirror `execFileSync` semantics, so the flow never depends on shell quoting; inherited stdio lets the user see the clone and install output.
+     * @evidence contracts/common.md#clear-and-simple-design One member for commands whose output the user must see and whose failure must stop the flow, separate from the silent `probe`.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The production implementation runs the requested command; no command is skipped or rewritten based on the repository or destination.
+     * @evidence contracts/common.md#meaningful-documentation The comment states the argument representation and that stdio is inherited.
+     * @evidence contracts/portability.md#os-neutral-implementation The executable and its arguments are separate values, so no quoting rule of any shell is part of the contract, and standard streams are inherited so the platform's terminal shows the program's output.
+     */
     execute: (executable: string, args: readonly string[]) => void;
-    /** Silently checks whether an executable accepts the supplied arguments. */
+
+    /**
+     * Silently checks whether an executable accepts the supplied arguments.
+     *
+     * @evidence contracts/common.md#principled-implementation A probe runs the executable with the given arguments and reports success as a boolean, which is enough to decide whether `pnpm --version` or `corepack --version` is available without interpreting output.
+     * @evidence contracts/common.md#clear-and-simple-design Separate from `execute` because a probe is silent and its failure is an answer rather than an error.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts Availability is decided by actually invoking the tool; no PATH scan is guessed and no tool name is assumed present.
+     * @evidence contracts/common.md#meaningful-documentation The comment states that the check is silent and returns whether the executable accepted the arguments.
+     * @evidence contracts/portability.md#os-neutral-implementation A program that cannot be started, as a missing executable on any platform, and one that exits non-zero both answer `false`, because the production context catches the failure of `execFileSync` instead of distinguishing platform error codes.
+     */
     probe: (executable: string, args: readonly string[]) => boolean;
-    /** Changes the working directory. */
+
+    /**
+     * Changes the working directory.
+     *
+     * @evidence contracts/common.md#principled-implementation The flow must run install and build inside the cloned directory, and changing the working directory of the process is the one operation that redirects every later relative command.
+     * @evidence contracts/common.md#clear-and-simple-design A single-purpose member so a fake can record the directory the flow entered.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The production implementation calls `process.chdir` on the requested path, with no fallback directory.
+     * @evidence contracts/common.md#meaningful-documentation The comment names the effect, a working-directory change.
+     * @evidence contracts/portability.md#os-neutral-implementation `process.chdir` changes the working directory of the whole process, so the flow supports one scaffold per process at a time.
+     */
     chdir: (directory: string) => void;
-    /** Checks whether a path exists. */
+
+    /**
+     * Checks whether a path exists.
+     *
+     * @evidence contracts/common.md#principled-implementation Refusing to scaffold into an existing directory needs one boolean existence check for the destination path.
+     * @evidence contracts/common.md#clear-and-simple-design One question with one boolean answer, kept apart from removal.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The production implementation asks the file system directly, with no cached listing.
+     * @evidence contracts/common.md#meaningful-documentation The comment states that it checks whether a path exists.
+     * @evidence contracts/portability.md#os-neutral-implementation Node's `existsSync` lets the volume decide the case policy and the links, and nothing is canonicalized.
+     */
     exists: (path: string) => boolean;
-    /** Removes a path recursively, ignoring missing entries. */
+
+    /**
+     * Removes a path recursively, ignoring missing entries.
+     *
+     * @evidence contracts/common.md#principled-implementation Deleting the repository-only files (`.git`, `.github/dependabot.yml`) after scaffolding is a recursive removal that must succeed when the entry is already absent.
+     * @evidence contracts/common.md#clear-and-simple-design One effect, isolated so a fake can record which paths the flow removed.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The production implementation uses `fs.rmSync` with `recursive` and `force`, which is the supported way to make a missing path a no-op, not a swallowed error handler.
+     * @evidence contracts/common.md#meaningful-documentation The comment states that removal is recursive and ignores missing entries.
+     * @evidence contracts/portability.md#os-neutral-implementation `fs.rmSync` with `recursive` and `force` also removes the read-only files a clone leaves in `.git` on Windows, and a missing entry is not an error on any platform.
+     */
     remove: (path: string) => void;
   }
 
+  /**
+   * Per-template constants that parameterize the shared scaffolding flow.
+   *
+   * @evidence contracts/common.md#principled-implementation The three fields are the only differences between the starter and the template kits: what to announce, where to clone from, and whether to run the tests.
+   * @evidence contracts/common.md#clear-and-simple-design A flat record of per-template constants with no behavior.
+   * @evidence contracts/common.md#prohibited-implementation-shortcuts Template-specific values live in data passed to one flow, which avoids branching on a template name inside the flow.
+   * @evidence contracts/common.md#meaningful-documentation Each field documents its role, including that the repository is overridable through `--repository <url>`.
+   * @evidenceExclude contracts/portability.md#os-neutral-implementation The record holds a banner, a URL string and a flag, which are ordinary options and not a path or process representation; the repository is passed to git as one argument.
+   */
   export interface IProps {
     /** Banner title printed before cloning. */
     title: string;
+
     /** Default repository URL, overridable through `--repository <url>`. */
     repository: string;
+
     /** Whether to run the test suite after building. */
     test: boolean;
   }
 
+  /**
+   * Creates the `nestia start` or `nestia template` command for one template.
+   *
+   * The returned function takes a halter that terminates the process, an
+   * optional context, and the command-line arguments after the sub-command. It
+   * halts when the destination is missing or already exists, when the
+   * destination or the repository starts with a dash, when `--repository` has
+   * no value, or when neither pnpm nor corepack is available.
+   *
+   * @evidence contracts/common.md#principled-implementation Currying separates the per-template props from the halter and context injected at the call site. Argument and destination validation precede cloning, and a destination or repository that starts with a dash is refused because git would read it as an option; package-manager availability is checked after entering the clone, so an unavailable manager leaves that clone in place without installing or building it. Ordered execute calls implement the documented scaffold sequence.
+   * @evidence contracts/common.md#clear-and-simple-design One curried function keeps the sequence readable in one place, delegating parsing, package-manager selection, and command shaping to private helpers rather than to options.
+   * @evidence contracts/common.md#prohibited-implementation-shortcuts The flow contains no fixture or repository names, and the injected context is the production seam: the default `CONTEXT` performs the real clone, install, build, and cleanup.
+   * @evidence contracts/common.md#meaningful-documentation The comment states the halting conditions and the injected parameters, and section comments inside the body mark the phases.
+   * @evidence contracts/portability.md#os-neutral-implementation Every program invocation is one `execute` call with an argument vector, and the pnpm or corepack choice is made by probing, not by an operating-system name. A destination or repository starting with a dash is refused, since git would read it as an option and the vector has no separator.
+   */
   export const clone =
     (props: IProps) =>
     (halter: (msg?: string) => never, context: IContext = CONTEXT) =>
@@ -37,6 +129,10 @@ export namespace NestiaProjectTemplate {
       // VALIDATION
       const { dest, repository } = parse(argv, halter);
       if (dest === undefined) halter();
+      else if (dest.startsWith("-") || repository?.startsWith("-") === true)
+        halter(
+          "The destination and the repository must not start with a dash, which git would read as an option.",
+        );
       else if (context.exists(dest) === true)
         halter("The target directory already exists.");
 
@@ -114,8 +210,9 @@ export namespace NestiaProjectTemplate {
         "",
         "  npm install --global pnpm",
         "",
-        "or activate it through corepack (bundled with Node.js):",
+        "or install and activate corepack:",
         "",
+        "  npm install --global corepack",
         "  corepack enable",
       ].join("\n"),
     );

package/src/NestiaStarter.ts

@@ -1,5 +1,15 @@
 import { NestiaProjectTemplate } from "./NestiaProjectTemplate.js";
 
+/**
+ * The `nestia start` command: clones the Nestia starter kit, builds it, and
+ * runs its tests.
+ *
+ * @evidence contracts/common.md#principled-implementation It binds the starter kit's title and repository and enables the test step, which is all that distinguishes it from the template command, so its behavior is exactly the shared flow's.
+ * @evidence contracts/common.md#clear-and-simple-design A one-member namespace whose only job is naming the bound command that `index.ts` imports lazily.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The values are contract constants (the published starter repository URL), not special cases of any consumer.
+ * @evidence contracts/common.md#meaningful-documentation The comment names the command and what it does; the shared flow documents the details.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation This namespace supplies a title, repository URL and test flag to the shared scaffolder; it does not launch processes or interpret native paths.
+ */
 export namespace NestiaStarter {
   export const clone = NestiaProjectTemplate.clone({
     title: "Nestia Starter Kit",

package/src/NestiaTemplate.ts

@@ -1,5 +1,15 @@
 import { NestiaProjectTemplate } from "./NestiaProjectTemplate.js";
 
+/**
+ * The `nestia template` command: clones the backend template kit and builds it
+ * without running its tests.
+ *
+ * @evidence contracts/common.md#principled-implementation It binds the template kit's title and repository with the test step disabled, so its behavior is exactly the shared flow's with that one difference.
+ * @evidence contracts/common.md#clear-and-simple-design A one-member namespace whose only job is naming the bound command that `index.ts` imports lazily.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The values are contract constants (the published template repository URL), not special cases of any consumer.
+ * @evidence contracts/common.md#meaningful-documentation The comment names the command and its difference from the starter; the shared flow documents the details.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation This namespace supplies a title, repository URL and test flag to the shared scaffolder; it does not launch processes or interpret native paths.
+ */
 export namespace NestiaTemplate {
   export const clone = NestiaProjectTemplate.clone({
     title: "Nestia Template Kit",

package/src/index.ts

@@ -18,7 +18,20 @@ function halt(desc: string): never {
   process.exit(-1);
 }
 
-async function main(): Promise<void> {
+/**
+ * Dispatches the command in the current process arguments.
+ *
+ * Scaffold commands load only their engine. Generator commands require the
+ * installed SDK executable, which reads the unchanged process arguments itself.
+ * Missing SDK installation and unsupported commands terminate with guidance.
+ *
+ * @evidence contracts/common.md#principled-implementation The command discriminant chooses the corresponding scaffold or the SDK executable; slicing arguments after the subcommand preserves the scaffolder's option values, while importing the SDK retains its process-argument contract.
+ * @evidence contracts/common.md#clear-and-simple-design One dispatcher owns command selection and SDK installation guidance. The scaffold engines own their lifecycle, and the SDK executable owns generator behavior.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The recognized names are the documented CLI commands, and require.resolve checks the installed SDK instead of guessing a workspace location or replacing its implementation.
+ * @evidence contracts/common.md#meaningful-documentation The comment identifies lazy dispatch, the SDK argument ownership and terminal failures; USAGE lists the supported invocations.
+ * @evidence contracts/portability.md#os-neutral-implementation Node module resolution locates the SDK through its package address on the current installation; relative module imports locate scaffold engines. The dispatcher launches no subprocess and leaves native executable handling to those engines.
+ */
+export async function main(): Promise<void> {
   const type: string | undefined = process.argv[2];
   const argv: string[] = process.argv.slice(3);