refactor(create-gen-app): move CLI to create-gen-app-test package

Remove CLI entry point from create-gen-app package to make it a pure
library API. The CLI implementation and tests are now housed in the
create-gen-app-test package for integration testing purposes.

Changes:
- Remove src/cli.ts and __tests__/cli.test.ts from create-gen-app
- Remove bin field and minimist dependencies from create-gen-app/package.json
- Update README.md to clarify that the published package is API-only
- Port CLI code to create-gen-app-test/src/cli.ts
- Add CLI tests to create-gen-app-test/src/__tests__/cli.test.ts
- Add minimist and inquirerer dependencies to create-gen-app-test
- Update CLI imports to use create-gen-app library APIs

This separation ensures create-gen-app remains focused on its core
template generation functionality while maintaining CLI testing capabilities
in the dedicated test harness package.

Author: sdqede

packages/create-gen-app-test/package.json

@@ -30,10 +30,13 @@
   },
   "dependencies": {
     "appstash": "workspace:*",
-    "create-gen-app": "workspace:*"
+    "create-gen-app": "workspace:*",
+    "inquirerer": "workspace:*",
+    "minimist": "^1.2.8"
   },
   "devDependencies": {
+    "@types/minimist": "^1.2.5",
     "makage": "0.1.5"
   },
   "keywords": []
-}
+}

…ges/create-gen-app/__tests__/cli.test.ts …e-gen-app-test/src/__tests__/cli.test.tspackages/create-gen-app/__tests__/cli.test.ts renamed to packages/create-gen-app-test/src/__tests__/cli.test.ts packages/create-gen-app/__tests__/cli.test.ts renamed to packages/create-gen-app-test/src/__tests__/cli.test.ts

@@ -1,19 +1,19 @@
 import * as fs from "fs";
 import * as path from "path";
 
-import { runCli } from "../src/cli";
+import { runCli } from "../cli";
 import {
   TEST_BRANCH,
   TEST_REPO,
   TEST_TEMPLATE,
   buildAnswers,
   cleanupWorkspace,
   createTempWorkspace,
-} from "../test-utils/integration-helpers";
+} from "../../../create-gen-app/test-utils/integration-helpers";
 
 jest.setTimeout(180_000);
 
-describe("CLI integration (GitHub templates)", () => {
+describe("CLI integration via create-gen-app-test harness", () => {
   it("generates a project using the real repo", async () => {
     const workspace = createTempWorkspace("cli");
     const answers = buildAnswers("cli");
@@ -65,12 +65,15 @@ describe("CLI integration (GitHub templates)", () => {
   });
 
   it("prints version and exits when --version is provided", async () => {
-    const logSpy = jest.spyOn(console, "log").mockImplementation(() => undefined);
+    const logSpy = jest
+      .spyOn(console, "log")
+      .mockImplementation(() => undefined);
 
     await runCli(["--version"]);
 
-    expect(logSpy).toHaveBeenCalledWith(expect.stringMatching(/create-gen-app v/));
+    expect(logSpy).toHaveBeenCalledWith(
+      expect.stringMatching(/create-gen-app v/)
+    );
     logSpy.mockRestore();
   });
 });
-

packages/create-gen-app/src/cli.ts packages/create-gen-app-test/src/cli.tspackages/create-gen-app/src/cli.ts renamed to packages/create-gen-app-test/src/cli.ts

@@ -6,15 +6,15 @@ import * as path from "path";
 import { Inquirerer, ListQuestion } from "inquirerer";
 import minimist, { ParsedArgs } from "minimist";
 
-import { cloneRepo } from "./clone";
-import { createGen } from "./index";
-import packageJson from "../package.json";
+import { cloneRepo, createGen } from "create-gen-app";
+import createGenPackageJson from "create-gen-app/package.json";
 
 const DEFAULT_REPO = "https://github.com/launchql/pgpm-boilerplates.git";
 const DEFAULT_PATH = ".";
 const DEFAULT_OUTPUT_FALLBACK = "create-gen-app-output";
 
-const PACKAGE_VERSION = packageJson.version ?? "0.0.0";
+const PACKAGE_VERSION =
+  (createGenPackageJson as { version?: string }).version ?? "0.0.0";
 
 const RESERVED_ARG_KEYS = new Set([
   "_",
@@ -43,7 +43,9 @@ export interface CliResult {
   template: string;
 }
 
-export async function runCli(rawArgv: string[] = process.argv.slice(2)): Promise<CliResult | void> {
+export async function runCli(
+  rawArgv: string[] = process.argv.slice(2)
+): Promise<CliResult | void> {
   const args = minimist(rawArgv, {
     alias: {
       r: "repo",
@@ -87,8 +89,13 @@ export async function runCli(rawArgv: string[] = process.argv.slice(2)): Promise
     tempDir = await cloneRepo(args.repo, { branch: args.branch });
 
     const selectionRoot = path.join(tempDir, args.path);
-    if (!fs.existsSync(selectionRoot) || !fs.statSync(selectionRoot).isDirectory()) {
-      throw new Error(`Template path "${args.path}" does not exist in ${args.repo}`);
+    if (
+      !fs.existsSync(selectionRoot) ||
+      !fs.statSync(selectionRoot).isDirectory()
+    ) {
+      throw new Error(
+        `Template path "${args.path}" does not exist in ${args.repo}`
+      );
     }
 
     const templates = fs
@@ -134,7 +141,9 @@ export async function runCli(rawArgv: string[] = process.argv.slice(2)): Promise
     ensureOutputDir(outputDir, Boolean(args.force));
 
     const answerOverrides = extractAnswerOverrides(args);
-    const noTty = Boolean(args["no-tty"] ?? (args as Record<string, unknown>).noTty);
+    const noTty = Boolean(
+      args["no-tty"] ?? (args as Record<string, unknown>).noTty
+    );
 
     await createGen({
       templateUrl: args.repo,
@@ -156,11 +165,10 @@ export async function runCli(rawArgv: string[] = process.argv.slice(2)): Promise
 
 function printHelp(): void {
   console.log(`
-create-gen-app CLI
+create-gen-app CLI (test harness)
 
 Usage:
-  create-gen-app [options] [outputDir]
-  cga [options] [outputDir]
+  node cli [options] [outputDir]
 
 Options:
   -r, --repo <url>         Git repository to clone (default: ${DEFAULT_REPO})
@@ -174,7 +182,7 @@ Options:
   -h, --help               Show this help message
 
 You can also pass variable overrides, e.g.:
-  create-gen-app --template module --PROJECT_NAME my-app
+  node cli --template module --PROJECT_NAME my-app
 `);
 }
 
@@ -193,7 +201,9 @@ async function promptForTemplate(templates: string[]): Promise<string> {
   };
 
   try {
-    const answers = (await prompter.prompt({}, [question])) as { template: string };
+    const answers = (await prompter.prompt({}, [question])) as {
+      template: string;
+    };
     return answers.template;
   } finally {
     if (typeof (prompter as any).close === "function") {
@@ -202,8 +212,13 @@ async function promptForTemplate(templates: string[]): Promise<string> {
   }
 }
 
-function resolveOutputDir(outputArg: string | undefined, template?: string): string {
-  const base = outputArg ?? (template ? path.join(process.cwd(), template) : DEFAULT_OUTPUT_FALLBACK);
+function resolveOutputDir(
+  outputArg: string | undefined,
+  template?: string
+): string {
+  const base =
+    outputArg ??
+    (template ? path.join(process.cwd(), template) : DEFAULT_OUTPUT_FALLBACK);
   return path.resolve(base);
 }
 
@@ -238,4 +253,3 @@ if (require.main === module) {
     process.exitCode = 1;
   });
 }
-

packages/create-gen-app/README.md

@@ -16,48 +16,23 @@
   <a href="https://www.npmjs.com/package/create-gen-app"><img height="20" src="https://img.shields.io/github/package-json/v/hyperweb-io/dev-utils?filename=packages%2Fcreate-gen-app%2Fpackage.json"></a>
 </p>
 
-A TypeScript-first CLI/library for cloning template repositories, asking the user for variables, and generating a new project with sensible defaults.
+A TypeScript-first library for cloning template repositories, asking the user for variables, and generating a new project with sensible defaults.
 
 ## Features
 
 - Clone any Git repo (or GitHub `org/repo` shorthand) and optionally select a branch + subdirectory
 - Extract template variables from filenames and file contents using the safer `____variable____` convention
 - Merge auto-discovered variables with `.questions.{json,js}` (questions win, including `ignore` patterns)
-- Interactive prompts powered by `inquirerer`, with CLI flag overrides (`--VAR value`) and non-TTY mode for CI
-- Built-in CLI (`create-gen-app` / `cga`) that discovers templates, prompts once, and writes output safely
+- Interactive prompts powered by `inquirerer`, with flexible override mapping (`argv` support) and non-TTY mode for CI
 - License scaffolding: choose from MIT, Apache-2.0, ISC, GPL-3.0, BSD-3-Clause, Unlicense, or MPL-2.0 and generate a populated `LICENSE`
 
 ## Installation
 
 ```bash
 npm install create-gen-app
-# or for CLI only
-npm install -g create-gen-app
 ```
 
-## CLI Usage
-
-```bash
-# interactively pick a template from launchql/pgpm-boilerplates
-create-gen-app --output ./workspace
-
-# short alias
-cga --template module --branch main --output ./module \
-    --USERFULLNAME "Jane Dev" --USEREMAIL [email protected]
-
-# point to a different repo/branch/path
-cga --repo github:my-org/my-templates --branch release \
-    --path ./templates --template api --output ./api
-```
-
-Key flags:
-
-- `--repo`, `--branch`, `--path` – choose the Git repo, branch/tag, and subdirectory that contains templates
-- `--template` – folder inside `--path` (auto-prompted if omitted)
-- `--output` – destination directory (defaults to `./<template>`); use `--force` to overwrite
-- `--no-tty` – disable interactive prompts (ideal for CI)
-- `--version`, `--help` – standard metadata
-- Any extra `--VAR value` pairs become variable overrides
+> **Note:** The published package is API-only. An internal CLI harness used for integration testing now lives in `packages/create-gen-app-test/`.
 
 ## Library Usage
 
@@ -126,14 +101,14 @@ Or `.questions.js` for dynamic logic. Question names can use `____var____` or pl
 
 - `{{YEAR}}`, `{{AUTHOR}}`, `{{EMAIL_LINE}}`
 
-No code changes are needed; the CLI discovers templates at runtime and will warn if a `.questions` option doesn’t have a matching template.
+No code changes are needed; the generator discovers templates at runtime and will warn if a `.questions` option doesn’t have a matching template.
 
 ## API Overview
 
 - `createGen(options)` – full pipeline (clone → extract → prompt → replace)
 - `cloneRepo(url, { branch })` – clone to a temp dir
 - `extractVariables(dir)` – parse file/folder names + content for variables, load `.questions`
-- `promptUser(extracted, argv, noTty)` – run interactive questions with CLI overrides and alias deduping
+- `promptUser(extracted, argv, noTty)` – run interactive questions with override alias deduping
 - `replaceVariables(templateDir, outputDir, extracted, answers)` – copy files, rename paths, render licenses
 
 See `dev/README.md` for the local development helper script (`pnpm dev`).

packages/create-gen-app/package.json

@@ -3,10 +3,6 @@
   "version": "0.1.7",
   "author": "Dan Lynch <[email protected]>",
   "description": "Clone and customize template repositories with variable replacement",
-  "bin": {
-    "create-gen-app": "./cli.js",
-    "cga": "./cli.js"
-  },
   "main": "index.js",
   "module": "esm/index.js",
   "types": "index.d.ts",
@@ -33,13 +29,11 @@
     "test:watch": "jest --watch"
   },
   "dependencies": {
-    "inquirerer": "workspace:*",
-    "minimist": "^1.2.8"
+    "inquirerer": "workspace:*"
   },
   "devDependencies": {
-    "@types/minimist": "^1.2.5",
     "copyfiles": "^2.4.1",
     "makage": "0.1.5"
   },
   "keywords": []
-}
+}