create-nx-archweave 0.1.1 → 0.2.0

package/dist/cli/spawnable-command.js

@@ -1,71 +0,0 @@
-// This file exists in packages/shared and packages/create-nx-archweave (which imports
-// nothing); keep the two identical — the CLI's spec compares them.
-import { statSync } from 'node:fs';
-import { win32 } from 'node:path';
-function isFile(path) {
-    try {
-        return statSync(path).isFile();
-    }
-    catch {
-        return false;
-    }
-}
-const DEFAULT_ENV = { platform: process.platform, env: process.env, isFile };
-/** Windows keeps PATH and PATHEXT under any letter case. */
-function envValue(env, name) {
-    const key = Object.keys(env).find((candidate) => candidate.toUpperCase() === name);
-    return key === undefined ? undefined : env[key];
-}
-/** Where Windows would find `command`: as given when it has a path, else on PATH, trying
- * each PATHEXT extension unless it already has one. Undefined when nothing matches. */
-export function resolveWindowsCommand(command, environment) {
-    const exts = (envValue(environment.env, 'PATHEXT') ?? '.COM;.EXE;.BAT;.CMD').split(';').filter(Boolean);
-    const candidates = (base) => (win32.extname(base) !== '' ? [base] : exts.map((ext) => base + ext));
-    if (win32.isAbsolute(command) || /[\\/]/.test(command)) {
-        return candidates(command).find(environment.isFile);
-    }
-    const dirs = (envValue(environment.env, 'PATH') ?? '').split(';').filter(Boolean);
-    for (const dir of dirs) {
-        const found = candidates(win32.join(dir, command)).find(environment.isFile);
-        if (found !== undefined)
-            return found;
-    }
-    return undefined;
-}
-// cmd.exe's metacharacters, escaped with ^ (the algorithm cross-spawn uses — MIT,
-// https://github.com/moxystudio/node-cross-spawn — after https://qntm.org/cmd).
-const META_CHARS = /([()\][%!^"`<>&|;, *?])/g;
-/** A project-local `node_modules\.bin\*.cmd` shim hands its arguments to cmd.exe a second
- * time, so they are escaped twice (cross-spawn does the same). */
-const BIN_SHIM = /node_modules[\\/]\.bin[\\/][^\\/]+\.cmd$/i;
-/** One argument for `cmd.exe /d /s /c "…"`: quoted for the program's own argv parsing,
- * then every cmd.exe metacharacter escaped (twice for a node_modules\.bin shim). `%VAR%`
- * is not fully protected from expansion — the arguments passed here are the program's own,
- * never user text, as with cross-spawn. */
-export function escapeCmdArgument(arg, doubleEscape = false) {
-    let quoted = arg.replace(/(\\*)"/g, '$1$1\\"');
-    quoted = quoted.replace(/(\\*)$/, '$1$1');
-    const escaped = `"${quoted}"`.replace(META_CHARS, '^$1');
-    return doubleEscape ? escaped.replace(META_CHARS, '^$1') : escaped;
-}
-/**
- * How to spawn `command args` without a shell, on every platform. Node cannot start a
- * Windows `.cmd` / `.bat` shim itself (ENOENT without the extension; EINVAL with it, since
- * the CVE-2024-27980 fix) — and npm, npx, pnpm, yarn and an npm-installed claude are all
- * such shims there. On Windows those run through `cmd.exe /d /s /c` with each argument
- * escaped; everything else (a real .exe, any other platform) is spawned unchanged.
- */
-export function spawnableCommand(command, args, environment = DEFAULT_ENV) {
-    if (environment.platform !== 'win32')
-        return { command, args: [...args] };
-    const resolved = resolveWindowsCommand(command, environment);
-    if (resolved === undefined || !/\.(cmd|bat)$/i.test(resolved))
-        return { command, args: [...args] };
-    const doubleEscape = BIN_SHIM.test(resolved);
-    const line = [resolved.replace(META_CHARS, '^$1'), ...args.map((arg) => escapeCmdArgument(arg, doubleEscape))].join(' ');
-    return {
-        command: envValue(environment.env, 'COMSPEC') ?? 'cmd.exe',
-        args: ['/d', '/s', '/c', `"${line}"`],
-        windowsVerbatimArguments: true,
-    };
-}

package/dist/cli/types.js

@@ -1,53 +0,0 @@
-/**
- * Literal option types shared by the parse/prompt/plan layers.
- *
- * These are intentionally NOT imported from `@nx-archweave/shared` or
- * `@nx-archweave/template-engine`: the CLI stream owns none of that policy (no content
- * or policy knowledge), it only forwards option values — so the literals here are
- * copied from `packages/nx-plugin/src/generators/init/schema.json`'s `preset`,
- * `frontend`, and `locale` enums, not derived from them. If the schema's enum ever
- * changes, this file must be updated to match by hand.
- */
-export const PRESET_VALUES = ['quick-start', 'solo', 'team'];
-export const FRONTEND_VALUES = ['react-vite', 'next', 'none'];
-export const BACKEND_VALUES = ['express', 'nest', 'none'];
-export const LOCALE_VALUES = ['ko', 'en'];
-/** `reviewProvider` is the host's default review provider — a copy of template-engine's
- * AI host table (types.spec.ts keeps it equal), shown as the review question's default. */
-export const AI_HOST_CHOICES = [
-    { id: 'claude-code', label: 'Claude Code', nxAgent: 'claude', reviewProvider: 'claude' },
-    { id: 'codex', label: 'Codex', nxAgent: 'codex', reviewProvider: 'gpt' },
-    { id: 'cursor', label: 'Cursor', nxAgent: 'cursor', reviewProvider: 'cursor' },
-    { id: 'gemini-cli', label: 'Gemini CLI', nxAgent: 'gemini', reviewProvider: 'gemini' },
-];
-/** init's `reviewProvider` enum (types.spec.ts keeps it equal), with display labels. */
-export const REVIEW_PROVIDER_CHOICES = [
-    { id: 'claude', label: 'Claude' },
-    { id: 'gemini', label: 'Gemini' },
-    { id: 'gpt', label: 'GPT' },
-    { id: 'cursor', label: 'Cursor' },
-];
-export const REVIEW_PROVIDER_VALUES = REVIEW_PROVIDER_CHOICES.map((provider) => provider.id);
-export const AI_HOST_VALUES = AI_HOST_CHOICES.map((host) => host.id);
-/** Used when nothing picked a host: a non-interactive run without --ai-hosts, or Enter. */
-export const DEFAULT_AI_HOSTS = ['claude-code'];
-/** The command each host's `--version` probe runs, measured
- * 2026-10-15: claude → "2.1.300 (Claude Code)", codex → "codex-cli 0.162.1", gemini →
- * "0.64.0". Cursor's installer links `cursor-agent` and a generic `agent`; only the
- * unambiguous name is probed, as Cursor's install guides name it. */
-export const AI_HOST_PROBES = {
-    'claude-code': 'claude',
-    codex: 'codex',
-    cursor: 'cursor-agent',
-    'gemini-cli': 'gemini',
-};
-export const PLUGIN_CHOICES = [
-    {
-        id: 'ponytail',
-        label: 'ponytail',
-        description: 'over-engineering review rules and skills — "makes your AI agent think like the laziest senior dev in the room"',
-        license: 'MIT',
-        host: 'claude-code',
-    },
-];
-export const PLUGIN_VALUES = PLUGIN_CHOICES.map((plugin) => plugin.id);

package/dist/cli/workspace-name.js

@@ -1,29 +0,0 @@
-/** npm's limit on a package name, which the workspace name becomes. */
-const MAX_LENGTH = 214;
-const EXAMPLE = 'my-app';
-/**
- * Why `name` can't be a workspace name, or undefined when it can. The name becomes the
- * directory and the root package.json name, and it reaches create-nx-workspace as an
- * argument — on Windows through cmd.exe — so only npm's package-name characters pass:
- * lowercase letters, digits, "-", "_" and ".", not starting with "." or "_".
- */
-export function workspaceNameProblem(name) {
-    if (name.length === 0)
-        return 'it is empty';
-    if (/\s/.test(name))
-        return 'it contains whitespace';
-    if (name.length > MAX_LENGTH)
-        return `it is ${name.length} characters long, and npm allows at most ${MAX_LENGTH}`;
-    if (name.startsWith('.') || name.startsWith('_'))
-        return `it starts with "${name[0]}"`;
-    if (/[A-Z]/.test(name))
-        return 'it contains uppercase letters, and npm package names are lowercase';
-    const others = [...new Set(name.replace(/[a-z0-9._-]/g, ''))];
-    if (others.length > 0) {
-        return `it contains ${others.map((char) => `"${char}"`).join(', ')} — only lowercase letters, digits, "-", "_" and "." are allowed`;
-    }
-    return undefined;
-}
-export function invalidWorkspaceNameMessage(name, problem) {
-    return `Invalid workspace name "${name}": ${problem}. For example: ${EXAMPLE}`;
-}

package/dist/render-usage.js

@@ -1,71 +0,0 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { AI_HOST_CHOICES, PLUGIN_CHOICES } from "./cli/types.js";
-// Keep in sync with packages/nx-plugin/generators.json (same order).
-const AVAILABLE_GENERATORS = [
-    'doctor',
-    'init',
-    'add-integration',
-    'add-review',
-    'add-backend',
-    'add-agent-rules',
-    'add-github-templates',
-    'add-fsd-lite',
-    'page',
-    'widget',
-    'feature',
-    'entity',
-    'shared',
-    'install-integration',
-    'record-integration',
-    'allow-builds',
-];
-/** This package's own version, read from its package.json — the nearest one up from this file
- * that is ours, which holds from source, from the tsc output and from the bundles alike. */
-function ownVersion() {
-    let dir = dirname(fileURLToPath(import.meta.url));
-    for (;;) {
-        const manifest = join(dir, 'package.json');
-        if (existsSync(manifest)) {
-            const pkg = JSON.parse(readFileSync(manifest, 'utf-8'));
-            if (pkg.name === 'create-nx-archweave' && pkg.version)
-                return pkg.version;
-        }
-        const parent = dirname(dir);
-        if (parent === dir)
-            throw new Error('create-nx-archweave: its own package.json was not found');
-        dir = parent;
-    }
-}
-export const CLI_VERSION = ownVersion();
-const PLUGIN_LIST = PLUGIN_CHOICES.map((plugin) => `${plugin.id} (${AI_HOST_CHOICES.find((host) => host.id === plugin.host)?.label ?? plugin.host})`).join(', ');
-export function renderUsage() {
-    return [
-        'Usage: create-nx-archweave <name> [options]',
-        '',
-        'Options:',
-        '  --preset <quick-start|solo|team>   Preset that configures the generated workspace',
-        '  --frontend <react-vite|next|none> Target frontend (none: a backend-only workspace — needs --backend)',
-        '  --backend <express|nest|none>      Backend app, wired with shared-types and enforced boundaries (asked if omitted)',
-        '  --locale <ko|en>                   Generated content language (asked if omitted; quick-start: en)',
-        '  --ai-hosts <list>                  AI coding tools, comma-separated: claude-code, codex, cursor, gemini-cli',
-        '                                     (asked if omitted, showing which are installed; without a terminal: claude-code)',
-        '  --plugins <list|none>              Optional plugins for the picked AI hosts, comma-separated: ' + PLUGIN_LIST,
-        '                                     (asked if omitted, for hosts installed here; without a terminal: none)',
-        '  --review, --no-review              Force AI PR review on/off (quick-start asks y/N; solo/team: on)',
-        '  --review-provider <name>           claude, gemini, gpt or cursor (asked when review is on; default: the first AI tool\'s)',
-        '  --plugin-source <spec>             Override the nx-archweave plugin package/version to install',
-        '  --package-manager <name>           npm, pnpm, yarn or bun (asked if omitted; without a terminal: the one that ran this command, else npm)',
-        '  -h, --help                         Show this help',
-        '  -v, --version                      Show the CLI version',
-        '',
-        'Any required option left unset above is asked interactively.',
-        '',
-        'Available generators (once installed):',
-        `  ${AVAILABLE_GENERATORS.join(', ')}`,
-    ].join('\n');
-}
-export function renderVersion() {
-    return CLI_VERSION;
-}