create-nx-archweave 0.1.0 → 0.2.0

package/dist/cli/plugins.js

@@ -1,74 +0,0 @@
-import { AI_HOST_CHOICES, PLUGIN_CHOICES } from "./types.js";
-const hostLabel = (host) => AI_HOST_CHOICES.find((choice) => choice.id === host)?.label ?? host;
-/** `--plugins` against the picked hosts: an unknown id or a plugin of a host not picked is
- * an error. bin.ts runs it before any question when both flags were passed. */
-export function resolvePluginFlag(ids, aiHosts) {
-    const plugins = [];
-    for (const id of ids) {
-        const plugin = PLUGIN_CHOICES.find((choice) => choice.id === id);
-        if (!plugin)
-            return { error: `Unknown plugin "${id}" in --plugins. Supported: ${PLUGIN_CHOICES.map((choice) => choice.id).join(', ')}.` };
-        if (!aiHosts.includes(plugin.host)) {
-            return {
-                error: `--plugins=${id} installs into ${hostLabel(plugin.host)}, which is not among the AI hosts (${aiHosts.join(', ')}) — ` +
-                    `add ${plugin.host} to --ai-hosts or drop the plugin.`,
-            };
-        }
-        plugins.push(plugin);
-    }
-    return { plugins };
-}
-/** `1`, `1,2`, `ponytail` or a mix, among `offered`; empty means none. Undefined for
- * anything else — the question is asked again. */
-export function parsePluginAnswer(answer, offered) {
-    const tokens = answer.split(/[\s,]+/).filter((token) => token.length > 0);
-    const picked = [];
-    for (const token of tokens) {
-        const byNumber = /^\d+$/.test(token) ? offered[Number(token) - 1] : undefined;
-        const plugin = byNumber ?? offered.find((choice) => choice.id === token.toLowerCase());
-        if (!plugin)
-            return undefined;
-        if (!picked.includes(plugin))
-            picked.push(plugin);
-    }
-    return picked;
-}
-export function pluginQuestion(host, offered) {
-    return [
-        `? Plugins for ${hostLabel(host)} — install now, into this workspace (project scope)?`,
-        ...offered.map((plugin, index) => `  ${index + 1}) ${plugin.label} — ${plugin.description} (${plugin.license})`),
-        'Choose, e.g. 1 — Enter to skip []: ',
-    ].join('\n');
-}
-/**
- * The optional plugins, asked last. A flag always wins; it
- * may only name plugins of a picked host. Without a terminal and without the flag: none.
- * Asked once per picked host that has catalog plugins and whose CLI was found — installing
- * runs that CLI, so a host this machine lacks gets a one-line "later" hint instead.
- */
-export async function choosePlugins(input, ask, log) {
-    if (input.flag !== undefined)
-        return resolvePluginFlag(input.flag, input.aiHosts);
-    if (!input.interactive)
-        return { plugins: [] };
-    const plugins = [];
-    for (const host of input.aiHosts) {
-        const offered = PLUGIN_CHOICES.filter((plugin) => plugin.host === host);
-        if (offered.length === 0)
-            continue;
-        if (input.installedHosts !== undefined && input.installedHosts[host] === undefined) {
-            log(`${hostLabel(host)} was not found, so its plugins (${offered.map((plugin) => plugin.id).join(', ')}) are not offered. ` +
-                `Once it is installed, inside the workspace: ${input.nxG} @clearlydev/nx-archweave:install-integration --tool=<plugin> --apply`);
-            continue;
-        }
-        const question = pluginQuestion(host, offered);
-        for (;;) {
-            const picked = parsePluginAnswer(await ask(question), offered);
-            if (picked) {
-                plugins.push(...picked);
-                break;
-            }
-        }
-    }
-    return { plugins };
-}

package/dist/cli/preflight.js

@@ -1,7 +0,0 @@
-/** The major version of a `<manager> --version`-style string, or undefined when it does
- * not start with one. The compatibility rule that uses it lives in package-manager.ts
- * (one gate for flag, launcher and question). */
-export function parseMajor(version) {
-    const match = /^\s*v?(\d+)\./.exec(version ?? '');
-    return match ? Number(match[1]) : undefined;
-}

package/dist/cli/prompts.js

@@ -1,150 +0,0 @@
-import { AI_HOST_CHOICES, BACKEND_VALUES, DEFAULT_AI_HOSTS, FRONTEND_VALUES, LOCALE_VALUES, PRESET_VALUES, REVIEW_PROVIDER_CHOICES, } from "./types.js";
-async function askChoice(ask, question, choices) {
-    for (;;) {
-        const answer = (await ask(question)).trim();
-        if (choices.includes(answer))
-            return answer;
-    }
-}
-function parseYesNo(answer) {
-    return /^y(es)?$/i.test(answer.trim());
-}
-/** `1,3`, `1 3`, `codex,cursor` or a mix; empty means the default. Undefined for anything
- * that is not a listed number or id — the question is asked again. */
-export function parseAiHostAnswer(answer) {
-    const tokens = answer.split(/[\s,]+/).filter((token) => token.length > 0);
-    if (tokens.length === 0)
-        return [...DEFAULT_AI_HOSTS];
-    const picked = [];
-    for (const token of tokens) {
-        const byNumber = /^\d+$/.test(token) ? AI_HOST_CHOICES[Number(token) - 1] : undefined;
-        const host = byNumber ?? AI_HOST_CHOICES.find((choice) => choice.id === token.toLowerCase());
-        if (!host)
-            return undefined;
-        if (!picked.includes(host.id))
-            picked.push(host.id);
-    }
-    return picked;
-}
-/** `installed 2.1.300` / `not found`, or nothing when the hosts were not probed. */
-export function hostStatus(host, installed) {
-    if (installed === undefined)
-        return '';
-    const version = installed[host];
-    if (version === undefined)
-        return 'not found';
-    return version.length > 0 ? `installed ${version}` : 'installed';
-}
-export function aiHostsQuestion(installed) {
-    const width = Math.max(...AI_HOST_CHOICES.map((host) => host.label.length)) + 2;
-    return [
-        '? AI coding tools you use (choose one or more)',
-        ...AI_HOST_CHOICES.map((host, index) => {
-            const status = hostStatus(host.id, installed);
-            return `  ${index + 1}) ${status ? host.label.padEnd(width) + status : host.label}`;
-        }),
-        `Choose, e.g. 1,3 [1]: `,
-    ].join('\n');
-}
-async function askAiHosts(ask, installed) {
-    const question = aiHostsQuestion(installed);
-    for (;;) {
-        const picked = parseAiHostAnswer(await ask(question));
-        if (picked)
-            return picked;
-    }
-}
-/**
- * Only asks about whatever `input` doesn't already have (flags always win; only the
- * gaps become interactive questions):
- *  - preset: asked if missing.
- *  - frontend: asked if missing, for every preset; `none` makes a backend-only workspace,
- *    so a backend is then required (and `none` is not offered when the backend is none).
- *  - backend: asked if missing, for every preset — the stack choice is never
- *    minimized away.
- *  - locale: quick-start forces 'en' with NO question (keep later questions minimal);
- *    solo/team ask if missing.
- *  - aiHosts: asked if missing, for every preset, as a numbered multi-select;
- *    never without a terminal (the default host then).
- *  - review: asked with a single yes/no ONLY when the resolved preset is quick-start
- *    (the opt-in preset, which asks a single install-or-not question) AND no
- *    --review/--no-review flag was given.
- *    solo/team never ask — an explicit flag still overrides their preset default,
- *    but absent one, `review` stays undefined for the init generator to default.
- *
- * NOTE: "quick-start is the only preset that asks about review" is this CLI's own rule,
- * but it mirrors what
- * `packages/template-engine/src/presets/preset-config.ts` encodes (quick-start is
- * opt-in, solo/team default review on) without importing it — the CLI must not
- * depend on template-engine. Like `types.ts`'s enum copies,
- * this is a deliberate hand-synced literal: if a preset's review default ever
- * changes there, update this question gate to match.
- */
-export async function collectMissingInputs(input, ask) {
-    const preset = input.preset ?? (await askChoice(ask, `Preset (${PRESET_VALUES.join('/')}): `, PRESET_VALUES));
-    // none/none would build nothing: whichever is asked second leaves `none` out when the
-    // other is already none (both passed as flags is refused by parse-args).
-    const frontendChoices = input.backend === 'none' ? FRONTEND_VALUES.filter((value) => value !== 'none') : FRONTEND_VALUES;
-    const frontend = input.frontend ?? (await askChoice(ask, `Frontend (${frontendChoices.join('/')}): `, frontendChoices));
-    const backendChoices = frontend === 'none' ? BACKEND_VALUES.filter((value) => value !== 'none') : BACKEND_VALUES;
-    const backend = input.backend ?? (await askChoice(ask, `Backend (${backendChoices.join('/')}): `, backendChoices));
-    const locale = preset === 'quick-start'
-        ? input.locale ?? 'en'
-        : input.locale ?? (await askChoice(ask, `Locale (${LOCALE_VALUES.join('/')}): `, LOCALE_VALUES));
-    // Asked for every preset: the hosts decide which files the workspace gets.
-    const aiHosts = input.aiHosts ?? (input.interactive ? await askAiHosts(ask, input.installedHosts) : [...DEFAULT_AI_HOSTS]);
-    let review = input.review;
-    if (review === undefined && preset === 'quick-start') {
-        const answer = await ask('Enable AI PR review? (y/N): ');
-        review = parseYesNo(answer);
-    }
-    // The provider is asked only when review will be on: an explicit yes, or solo/team's own
-    // default (the same hand-synced rule as the question above). Enter keeps init's default.
-    let reviewProvider = input.reviewProvider;
-    if (reviewProvider === undefined && reviewWillBeOn(preset, review) && input.interactive) {
-        reviewProvider = await askReviewProvider(ask, aiHosts[0]);
-    }
-    return { preset, frontend, backend, locale, aiHosts, review, reviewProvider };
-}
-/** Whether init will set up AI PR review: an explicit --review / --no-review, else every preset
- * but quick-start (hand-synced with template-engine's preset defaults, like the question). */
-export function reviewWillBeOn(preset, review) {
-    return review ?? preset !== 'quick-start';
-}
-/** `--review-provider` with review off is refused rather than dropped without a word. Undefined
- * when there is nothing to refuse (no flag, or review on). */
-export function reviewProviderConflict(preset, review, reviewProvider) {
-    if (reviewProvider === undefined)
-        return undefined;
-    if (review === false)
-        return '--review-provider needs AI PR review on, but --no-review was passed (or review was declined): drop one of them.';
-    if (preset === undefined || reviewWillBeOn(preset, review))
-        return undefined;
-    return '--review-provider needs AI PR review on, and the quick-start preset leaves it off: add --review, or drop --review-provider.';
-}
-export function reviewProviderQuestion(firstHost) {
-    const host = AI_HOST_CHOICES.find((choice) => choice.id === firstHost);
-    const defaultIndex = REVIEW_PROVIDER_CHOICES.findIndex((provider) => provider.id === host?.reviewProvider);
-    return [
-        '? AI PR review provider',
-        ...REVIEW_PROVIDER_CHOICES.map((provider, index) => `  ${index + 1}) ${provider.label}${index === defaultIndex ? `  (default — ${host?.label})` : ''}`),
-        `Choose 1-${REVIEW_PROVIDER_CHOICES.length} [${defaultIndex + 1}]: `,
-    ].join('\n');
-}
-/** A number or an id; empty → undefined (init's default). Anything else is asked again. */
-export function parseReviewProviderAnswer(answer) {
-    const token = answer.trim().toLowerCase();
-    if (token === '')
-        return undefined;
-    const byNumber = /^\d+$/.test(token) ? REVIEW_PROVIDER_CHOICES[Number(token) - 1] : undefined;
-    const provider = byNumber ?? REVIEW_PROVIDER_CHOICES.find((choice) => choice.id === token);
-    return provider ? provider.id : null;
-}
-async function askReviewProvider(ask, firstHost) {
-    const question = reviewProviderQuestion(firstHost);
-    for (;;) {
-        const picked = parseReviewProviderAnswer(await ask(question));
-        if (picked !== null)
-            return picked;
-    }
-}

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/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;
-}