anhedral 0.4.1 → 0.4.2

package/dist/bin.js

@@ -1,11 +1,19 @@
 #!/usr/bin/env node
 import { createInterface } from 'node:readline/promises';
 import { argv, stdin, stdout } from 'node:process';
-import { buildAddOptions, buildOptions, buildOptionsForRoot, parseCli, parseNewProjectRequest, parseUiAddOptions, USAGE } from './cli.js';
+import { APP_MODULES, FEATURE_MODULES, buildAddOptions, buildOptions, buildOptionsForRoot, parseCli, parseNewProjectRequest, parseUiAddOptions, USAGE, } from './cli.js';
 import { doctorProject, scaffoldAddModules, scaffoldProject, scaffoldUiComponents, scaffoldUpgradeProject } from './scaffold.js';
-import { DEFAULT_PROMPT_APP_MODULES, DEFAULT_PROMPT_FEATURE_MODULES, hasUiSelection, parsePromptModules, shouldPromptForInitModules, } from './prompts.js';
+import { DEFAULT_PROMPT_APP_MODULES, DEFAULT_PROMPT_FEATURE_MODULES, hasUiSelection, parsePromptConfirmation, parsePromptModuleSelection, shouldPromptForInitModules, } from './prompts.js';
 import { GENERATOR_VERSION } from './version.js';
 import { PostCommitError } from './transaction.js';
+import { resolveModules } from './architecture/modules.js';
+import { UI_TARGETS } from './ui.js';
+const COMMANDS = ['new', 'init', 'add', 'ui', 'upgrade', 'doctor'];
+const COMMAND_SET = new Set(COMMANDS);
+const UI_TARGET_SET = new Set(UI_TARGETS);
+function isCommand(value) {
+    return COMMAND_SET.has(value);
+}
 function writeCliError(error, code, json) {
     const message = error instanceof Error ? error.message : String(error);
     if (json)
@@ -13,52 +21,42 @@ function writeCliError(error, code, json) {
     else
         console.error('Error:', message);
 }
-function splitAddArgs(args) {
-    const moduleNames = [];
-    const flagArgs = [];
-    for (let index = 0; index < args.length; index += 1) {
-        const arg = args[index];
-        if (arg === '--toolchain') {
-            flagArgs.push(arg);
-            if (args[index + 1] != null) {
-                flagArgs.push(args[index + 1]);
-                index += 1;
-            }
-            continue;
-        }
-        if (arg.startsWith('--')) {
-            flagArgs.push(arg);
-            continue;
-        }
-        moduleNames.push(arg);
-    }
-    return { moduleNames, flagArgs };
-}
 async function promptForInitModules(args) {
     if (!shouldPromptForInitModules(args, stdin.isTTY === true))
         return args;
     const rl = createInterface({ input: stdin, output: stdout });
     try {
-        console.log('Select app surfaces: web, mobile, api, desktop, extension');
-        const appAnswer = await rl.question('App surfaces [all]: ');
-        console.log('Select backend features: db, auth, billing, storage, native-subscriptions, electron-updater');
-        const featureAnswer = await rl.question('Backend features [all]: ');
+        console.log('Select app surfaces: web, mobile, api, desktop, extension (or "all"/"none")');
+        const appAnswer = await rl.question(`App surfaces [${DEFAULT_PROMPT_APP_MODULES.join(', ')}]: `);
+        console.log('Select capabilities: db, auth, billing, storage, native-subscriptions, electron-updater (or "all"/"none")');
+        const featureAnswer = await rl.question('Capabilities [none]: ');
         const selected = [
-            ...parsePromptModules(appAnswer, DEFAULT_PROMPT_APP_MODULES),
-            ...parsePromptModules(featureAnswer, DEFAULT_PROMPT_FEATURE_MODULES),
+            ...parsePromptModuleSelection(appAnswer, DEFAULT_PROMPT_APP_MODULES, APP_MODULES),
+            ...parsePromptModuleSelection(featureAnswer, DEFAULT_PROMPT_FEATURE_MODULES, FEATURE_MODULES),
         ];
+        if (selected.length === 0)
+            throw new Error('Select at least one app surface or capability.');
+        const resolution = resolveModules(selected);
         const result = [...args, ...selected.map((moduleName) => `--${moduleName}`)];
-        const hasUiClient = selected.some((moduleName) => ['web', 'mobile', 'desktop', 'extension'].includes(moduleName));
+        const hasUiClient = resolution.resolvedModules.some((moduleName) => UI_TARGET_SET.has(moduleName));
         if (hasUiClient && !hasUiSelection(args)) {
             console.log('Optionally add starter UI components to each selected client.');
             const componentAnswer = await rl.question('Starter components [none]: ');
             if (componentAnswer.trim())
                 result.push(`--ui=${componentAnswer}`);
         }
-        if (selected.includes('mobile') && !args.some((arg) => arg.startsWith('--native-styling'))) {
+        if (resolution.resolvedModules.includes('mobile') && !args.some((arg) => arg.startsWith('--native-styling'))) {
             const stylingAnswer = (await rl.question('Expo styling [nativewind]: ')).trim();
             result.push(`--native-styling=${stylingAnswer || 'nativewind'}`);
         }
+        console.log(`Requested: ${resolution.requestedModules.join(', ')}`);
+        if (resolution.dependencyAddedModules.length > 0) {
+            console.log(`Added by dependencies: ${resolution.dependencyAddedModules.join(', ')}`);
+        }
+        console.log(`Resolved stack: ${resolution.resolvedModules.join(', ')}`);
+        const confirmation = await rl.question('Generate this stack? [Y/n]: ');
+        if (!parsePromptConfirmation(confirmation))
+            throw new Error('Generation cancelled.');
         return result;
     }
     finally {
@@ -89,7 +87,7 @@ async function main() {
             console.log(USAGE);
         return;
     }
-    if (!['new', 'init', 'add', 'ui', 'upgrade', 'doctor'].includes(command)) {
+    if (!isCommand(command)) {
         if (json)
             writeCliError(new Error(`Unknown command: ${command}`), 'UNKNOWN_COMMAND', true);
         else {
@@ -108,60 +106,91 @@ async function main() {
     }
     let phase = 'arguments';
     try {
-        if (command === 'new') {
-            const request = parseNewProjectRequest(rawArgs);
-            const promptedArgs = await promptForInitModules([...request.moduleArgs]);
-            const options = buildOptionsForRoot(parseCli(promptedArgs), request.directory);
-            phase = 'execute';
-            await scaffoldProject(options);
-            if (!options.json && !options.dryRun) {
-                console.log(`\nCreated ${options.rootDirectory}\nNext: cd ${options.rootDirectory}\nThen follow README.md to configure the selected providers and start the app.`);
+        switch (command) {
+            case 'new': {
+                const request = parseNewProjectRequest(rawArgs);
+                const promptedArgs = await promptForInitModules([...request.moduleArgs]);
+                const parsed = parseCli(promptedArgs);
+                const options = {
+                    ...buildOptionsForRoot(parsed, request.directory),
+                    initializeGit: parsed.initializeGit ?? true,
+                };
+                phase = 'execute';
+                await scaffoldProject(options);
+                if (!options.json && !options.dryRun) {
+                    console.log(`\nCreated ${options.rootDirectory}\n\nNext:`);
+                    console.log(`  cd ${options.rootDirectory}`);
+                    if (options.skipInstall)
+                        console.log('  pnpm install');
+                    console.log('  pnpm first-run');
+                    console.log('  pnpm ready');
+                    console.log('\nThen follow README.md for verification, development, and deployment.');
+                }
+                break;
             }
-        }
-        else if (command === 'doctor') {
-            const unknown = rawArgs.filter((arg) => !['--json', '--verbose'].includes(arg));
-            if (unknown.length)
-                throw new Error(`Unknown doctor option: ${unknown[0]}`);
-            phase = 'execute';
-            const report = doctorProject();
-            if (json)
-                console.log(JSON.stringify(report, null, 2));
-            else {
-                console.log(report.ok ? 'Anhedral project is healthy.' : 'Anhedral project has drift.');
-                for (const issue of report.issues)
-                    console.log(`  ${issue.severity}: ${issue.path}: ${issue.message}`);
+            case 'doctor': {
+                const unknown = rawArgs.filter((arg) => !['--json', '--verbose'].includes(arg));
+                if (unknown.length)
+                    throw new Error(`Unknown doctor option: ${unknown[0]}`);
+                phase = 'execute';
+                const report = doctorProject();
+                if (json)
+                    console.log(JSON.stringify(report, null, 2));
+                else {
+                    console.log(report.ok ? 'Anhedral project is healthy.' : 'Anhedral project has drift.');
+                    console.log(`  project: ${report.project.displayName} (${report.project.name})`);
+                    console.log(`  modules: ${report.modules.join(', ')}`);
+                    console.log(`  toolchain: ${report.toolchain}`);
+                    console.log(`  ownership: ${report.ownership.user} user, ${report.ownership.mergeable} mergeable, `
+                        + `${report.ownership.managed} managed`);
+                    for (const issue of report.issues)
+                        console.log(`  ${issue.severity}: ${issue.path}: ${issue.message}`);
+                    if (report.recommendedActions.length > 0) {
+                        console.log('\nNext actions:');
+                        for (const action of report.recommendedActions)
+                            console.log(`  - ${action}`);
+                    }
+                }
+                if (!report.ok)
+                    process.exitCode = 1;
+                break;
+            }
+            case 'add': {
+                const options = buildAddOptions([], parseCli(rawArgs));
+                phase = 'execute';
+                await scaffoldAddModules(options);
+                break;
+            }
+            case 'ui': {
+                if (rawArgs[0] !== 'add')
+                    throw new Error('Unknown UI command. Use: anhedral ui add <component...>');
+                const options = parseUiAddOptions(rawArgs.slice(1));
+                phase = 'execute';
+                await scaffoldUiComponents(options);
+                break;
+            }
+            case 'upgrade': {
+                const unknown = rawArgs.filter((arg) => !['--skip-install', '--dry-run', '--json', '--verbose'].includes(arg));
+                if (unknown.length)
+                    throw new Error(`Unknown upgrade option: ${unknown[0]}`);
+                phase = 'execute';
+                await scaffoldUpgradeProject({
+                    skipInstall: rawArgs.includes('--skip-install'),
+                    dryRun: rawArgs.includes('--dry-run'),
+                    json,
+                });
+                break;
+            }
+            case 'init': {
+                const parsed = parseCli(await promptForInitModules(rawArgs));
+                const options = {
+                    ...buildOptions(parsed),
+                    initializeGit: parsed.initializeGit ?? false,
+                };
+                phase = 'execute';
+                await scaffoldProject(options);
+                break;
             }
-            if (!report.ok)
-                process.exitCode = 1;
-        }
-        else if (command === 'add') {
-            const { moduleNames, flagArgs } = splitAddArgs(rawArgs);
-            const options = buildAddOptions(moduleNames, parseCli(flagArgs));
-            phase = 'execute';
-            await scaffoldAddModules(options);
-        }
-        else if (command === 'ui') {
-            if (rawArgs[0] !== 'add')
-                throw new Error('Unknown UI command. Use: anhedral ui add <component...>');
-            const options = parseUiAddOptions(rawArgs.slice(1));
-            phase = 'execute';
-            await scaffoldUiComponents(options);
-        }
-        else if (command === 'upgrade') {
-            const unknown = rawArgs.filter((arg) => !['--skip-install', '--dry-run', '--json', '--verbose'].includes(arg));
-            if (unknown.length)
-                throw new Error(`Unknown upgrade option: ${unknown[0]}`);
-            phase = 'execute';
-            await scaffoldUpgradeProject({
-                skipInstall: rawArgs.includes('--skip-install'),
-                dryRun: rawArgs.includes('--dry-run'),
-                json,
-            });
-        }
-        else {
-            const options = buildOptions(parseCli(await promptForInitModules(rawArgs)));
-            phase = 'execute';
-            await scaffoldProject(options);
         }
     }
     catch (error) {

package/dist/cli.d.ts

@@ -1,28 +1,28 @@
 import type { AddOptions, InitOptions } from './scaffold.js';
+import { APP_MODULES, FEATURE_MODULES, type AppModule, type FeatureModule, type ModuleId } from './architecture/modules.js';
 import { type NativeStylingLibrary } from './ui.js';
 import type { UiAddOptions } from './scaffold.js';
-export declare const USAGE = "\nanhedral new <directory> [modules...] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral init [modules...] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral add <module...> [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral ui add <component...> [--target <client>] [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral upgrade [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral doctor [--json] [--verbose]\nanhedral --version\n\nCommands:\n  anhedral new my-app\n    Generate the complete TypeScript stack in a new directory. With no module flags, every module is included.\n  anhedral new my-app --web --api --db --auth\n    Generate a web app, Fastify API, shared database package, and auth wiring.\n  anhedral init --web --api --db --auth\n    Generate the same readable workspace in the current empty directory.\n  anhedral add mobile extension\n    Add missing modules to an existing Anhedral project.\n  anhedral ui add button dialog --target mobile\n    Add React Native Reusables components to Expo. DOM clients use shadcn/ui.\n  anhedral upgrade\n    Transactionally upgrade a supported older Anhedral project before adding modules.\n";
+export declare const USAGE = "\nanhedral new <directory> [modules...|--all] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--no-git] [--dry-run] [--json] [--verbose]\nanhedral init [modules...|--all] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--git] [--dry-run] [--json] [--verbose]\nanhedral add <module...|--all> [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral ui add <component...> [--target <client>] [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral upgrade [--skip-install] [--dry-run] [--json] [--verbose]\nanhedral doctor [--json] [--verbose]\nanhedral --version\n\nCommands:\n  anhedral new my-app\n    Interactively choose a focused stack in a terminal. In noninteractive use, pass module flags; no flags explicitly means the complete stack.\n  anhedral new my-app --web --api --db --auth\n    Generate a web app, Fastify API, shared database package, and auth wiring.\n  anhedral init --web --api --db --auth\n    Generate the same readable workspace in the current empty directory.\n  anhedral add mobile extension\n    Add missing modules to an existing Anhedral project.\n  anhedral ui add button dialog --target mobile\n    Add React Native Reusables components to Expo. DOM clients use shadcn/ui.\n  anhedral upgrade\n    Transactionally upgrade a supported older Anhedral project before adding modules.\n\nApp surfaces:\n  web                    Next.js App Router application\n  mobile                 Expo Router application for iOS, Android, and web\n  api                    Fastify HTTP API\n  desktop                Electron desktop application\n  extension              WXT browser extension\n\nCapabilities:\n  db                     Neon Postgres + Drizzle\n  auth                   Clerk; adds api + db\n  billing                RevenueCat + Stripe + Ably; adds auth\n  storage                Private Cloudflare R2; adds auth\n  native-subscriptions   Native RevenueCat client; adds mobile + billing\n  electron-updater       Private Electron update channel; adds desktop\n\nBehavior:\n  --all explicitly selects every app surface and capability.\n  new initializes Git when Git is available; use --no-git to opt out.\n  init preserves the current directory's repository state; use --git to initialize Git.\n  --dry-run never writes the destination. --json emits stable machine-readable plans.\n  Expo selections require Node ^22.13.0 or ^24.3.0. Other stacks support Node ^20.19.0 or newer supported releases.\n";
 export type NewProjectRequest = {
     readonly directory: string;
     readonly moduleArgs: readonly string[];
 };
 export declare function parseNewProjectRequest(args: readonly string[]): NewProjectRequest;
-export declare const APP_MODULES: readonly ["web", "mobile", "api", "desktop", "extension"];
-export declare const FEATURE_MODULES: readonly ["db", "auth", "billing", "storage", "native-subscriptions", "electron-updater"];
-export type AppModule = (typeof APP_MODULES)[number];
-export type FeatureModule = (typeof FEATURE_MODULES)[number];
-export type SupportedModule = AppModule | FeatureModule;
+export { APP_MODULES, FEATURE_MODULES };
+export type { AppModule, FeatureModule };
+export type SupportedModule = ModuleId;
 export type ParsedFlags = {
     toolchain?: string;
     skipInstall?: boolean;
     dryRun?: boolean;
     json?: boolean;
     verbose?: boolean;
+    initializeGit?: boolean;
     uiComponents: string[];
     nativeStyling?: NativeStylingLibrary;
     modules: Set<SupportedModule>;
 };
-export declare function parseCli(args: string[]): ParsedFlags;
+export declare function parseCli(args: readonly string[]): ParsedFlags;
 export declare function normalizeModuleName(raw: string): SupportedModule | null;
 export declare function deriveProjectName(cwd: string): string;
 export declare function deriveDisplayName(cwd: string): string;

package/dist/cli.js

@@ -1,13 +1,13 @@
 import path from 'node:path';
 import { env } from 'node:process';
 import { TOOLCHAIN_CHANNELS, resolveToolchainChannel } from './toolchain.js';
-import { resolveModules } from './architecture/modules.js';
+import { APP_MODULES, FEATURE_MODULES, isModuleId, resolveModules, } from './architecture/modules.js';
 import { packageNameFromText } from './render.js';
 import { isNativeStylingLibrary, isUiTarget, parseUiComponentList, } from './ui.js';
 export const USAGE = `
-anhedral new <directory> [modules...] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--dry-run] [--json] [--verbose]
-anhedral init [modules...] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--dry-run] [--json] [--verbose]
-anhedral add <module...> [--skip-install] [--dry-run] [--json] [--verbose]
+anhedral new <directory> [modules...|--all] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--no-git] [--dry-run] [--json] [--verbose]
+anhedral init [modules...|--all] [--ui <components>] [--native-styling <nativewind|uniwind>] [--toolchain <latest|stable>] [--skip-install] [--git] [--dry-run] [--json] [--verbose]
+anhedral add <module...|--all> [--skip-install] [--dry-run] [--json] [--verbose]
 anhedral ui add <component...> [--target <client>] [--skip-install] [--dry-run] [--json] [--verbose]
 anhedral upgrade [--skip-install] [--dry-run] [--json] [--verbose]
 anhedral doctor [--json] [--verbose]
@@ -15,7 +15,7 @@ anhedral --version
 
 Commands:
   anhedral new my-app
-    Generate the complete TypeScript stack in a new directory. With no module flags, every module is included.
+    Interactively choose a focused stack in a terminal. In noninteractive use, pass module flags; no flags explicitly means the complete stack.
   anhedral new my-app --web --api --db --auth
     Generate a web app, Fastify API, shared database package, and auth wiring.
   anhedral init --web --api --db --auth
@@ -26,6 +26,28 @@ Commands:
     Add React Native Reusables components to Expo. DOM clients use shadcn/ui.
   anhedral upgrade
     Transactionally upgrade a supported older Anhedral project before adding modules.
+
+App surfaces:
+  web                    Next.js App Router application
+  mobile                 Expo Router application for iOS, Android, and web
+  api                    Fastify HTTP API
+  desktop                Electron desktop application
+  extension              WXT browser extension
+
+Capabilities:
+  db                     Neon Postgres + Drizzle
+  auth                   Clerk; adds api + db
+  billing                RevenueCat + Stripe + Ably; adds auth
+  storage                Private Cloudflare R2; adds auth
+  native-subscriptions   Native RevenueCat client; adds mobile + billing
+  electron-updater       Private Electron update channel; adds desktop
+
+Behavior:
+  --all explicitly selects every app surface and capability.
+  new initializes Git when Git is available; use --no-git to opt out.
+  init preserves the current directory's repository state; use --git to initialize Git.
+  --dry-run never writes the destination. --json emits stable machine-readable plans.
+  Expo selections require Node ^22.13.0 or ^24.3.0. Other stacks support Node ^20.19.0 or newer supported releases.
 `;
 export function parseNewProjectRequest(args) {
     const [directory, ...moduleArgs] = args;
@@ -33,8 +55,13 @@ export function parseNewProjectRequest(args) {
         throw new Error('anhedral new requires a destination directory before module flags');
     return Object.freeze({ directory, moduleArgs: Object.freeze(moduleArgs) });
 }
-export const APP_MODULES = ['web', 'mobile', 'api', 'desktop', 'extension'];
-export const FEATURE_MODULES = ['db', 'auth', 'billing', 'storage', 'native-subscriptions', 'electron-updater'];
+export { APP_MODULES, FEATURE_MODULES };
+function assignOption(option, current, next) {
+    if (current !== undefined && current !== next) {
+        throw new Error(`Conflicting values for ${option}: ${String(current)} and ${String(next)}`);
+    }
+    return next;
+}
 export function parseCli(args) {
     const flags = { modules: new Set(), uiComponents: [] };
     for (let index = 0; index < args.length; index += 1) {
@@ -63,6 +90,19 @@ export function parseCli(args) {
             flags.verbose = true;
             continue;
         }
+        if (token === '--git') {
+            flags.initializeGit = assignOption('--git/--no-git', flags.initializeGit, true);
+            continue;
+        }
+        if (token === '--no-git') {
+            flags.initializeGit = assignOption('--git/--no-git', flags.initializeGit, false);
+            continue;
+        }
+        if (token === '--all') {
+            for (const moduleName of [...APP_MODULES, ...FEATURE_MODULES])
+                flags.modules.add(moduleName);
+            continue;
+        }
         if (token === '--ui') {
             const value = args[index + 1];
             if (!value || value.startsWith('--'))
@@ -79,7 +119,7 @@ export function parseCli(args) {
             const value = args[index + 1];
             if (!isNativeStylingLibrary(value))
                 throw new Error('--native-styling must be nativewind or uniwind');
-            flags.nativeStyling = value;
+            flags.nativeStyling = assignOption('--native-styling', flags.nativeStyling, value);
             index += 1;
             continue;
         }
@@ -87,7 +127,7 @@ export function parseCli(args) {
             const value = token.slice('--native-styling='.length);
             if (!isNativeStylingLibrary(value))
                 throw new Error('--native-styling must be nativewind or uniwind');
-            flags.nativeStyling = value;
+            flags.nativeStyling = assignOption('--native-styling', flags.nativeStyling, value);
             continue;
         }
         if (token === '--toolchain') {
@@ -95,7 +135,7 @@ export function parseCli(args) {
             if (!value || value.startsWith('--')) {
                 throw new Error('Missing value for --toolchain');
             }
-            flags.toolchain = value;
+            flags.toolchain = assignOption('--toolchain', flags.toolchain, value);
             index += 1;
             continue;
         }
@@ -104,7 +144,7 @@ export function parseCli(args) {
             if (!value) {
                 throw new Error('Missing value for --toolchain');
             }
-            flags.toolchain = value;
+            flags.toolchain = assignOption('--toolchain', flags.toolchain, value);
             continue;
         }
         const moduleName = normalizeModuleName(token.slice(2));
@@ -117,11 +157,7 @@ export function parseCli(args) {
     return flags;
 }
 export function normalizeModuleName(raw) {
-    if (APP_MODULES.includes(raw))
-        return raw;
-    if (FEATURE_MODULES.includes(raw))
-        return raw;
-    return null;
+    return isModuleId(raw) ? raw : null;
 }
 export function deriveProjectName(cwd) {
     return packageNameFromText(path.basename(cwd));
@@ -155,6 +191,7 @@ export function buildOptionsForRoot(flags, root) {
         json: flags.json === true,
         toolchainChannel: resolveToolchainChannel(flags.toolchain ?? env.ANHEDRAL_TOOLCHAIN),
         rootDirectory: resolvedRoot,
+        initializeGit: flags.initializeGit,
     };
 }
 export function parseUiAddOptions(args) {
@@ -212,6 +249,15 @@ export function parseUiAddOptions(args) {
     };
 }
 export function buildAddOptions(modules, flags) {
+    if (flags.initializeGit !== undefined) {
+        throw new Error('Git initialization options are only supported by anhedral new and anhedral init');
+    }
+    if (flags.uiComponents.length > 0) {
+        throw new Error('Use anhedral ui add <component...> to add UI components');
+    }
+    if (flags.nativeStyling !== undefined) {
+        throw new Error('--native-styling is only supported while creating a project');
+    }
     const requestedModules = [...modules, ...flags.modules];
     if (requestedModules.length === 0) {
         throw new Error('anhedral add requires at least one module');

package/dist/dependencies.d.ts

@@ -24,6 +24,7 @@ export declare const REALTIME_DEPENDENCIES: DependencyGroup;
 export declare const BACKEND_DEPENDENCIES: DependencyGroup;
 export declare const EXTENSION_DEPENDENCIES: DependencyGroup;
 export declare const FRONTEND_ADDON_DEPENDENCIES: DependencyMap;
+export declare const CLERK_SOLANA_PEER_DEPENDENCIES: DependencyMap;
 export declare const MOBILE_APP_DEPENDENCIES: DependencyGroup;
 export declare const MOBILE_NATIVEWIND_DEPENDENCIES: DependencyGroup;
 export declare const MOBILE_UNIWIND_DEPENDENCIES: DependencyGroup;

package/dist/dependencies.js

@@ -2,7 +2,7 @@ export const PACKAGE_MANAGER = 'pnpm@10.34.5';
 export const NODE_ENGINE = '^20.19.0 || >=22.12.0';
 // Expo SDK 56 targets React Native 0.85, whose supported Node release lines start here.
 export const MOBILE_NODE_ENGINE = '^22.13.0 || ^24.3.0 || >=25';
-const VERIFIED_AT = '2026-07-15';
+const VERIFIED_AT = '2026-07-23';
 export const TOOLCHAIN_DEPENDENCIES = {
     // renovate: datasource=npm depName=shadcn
     shadcn: '4.13.0',
@@ -175,6 +175,14 @@ export const FRONTEND_ADDON_DEPENDENCIES = {
     // renovate: datasource=npm depName=react-native-purchases-ui
     'react-native-purchases-ui': '10.4.2',
 };
+export const CLERK_SOLANA_PEER_DEPENDENCIES = {
+    // Clerk's wallet adapters expect these peers to be explicit when pnpm's
+    // autoInstallPeers setting is disabled.
+    // renovate: datasource=npm depName=@solana/web3.js
+    '@solana/web3.js': '1.98.4',
+    // renovate: datasource=npm depName=bs58
+    bs58: '6.0.0',
+};
 export const MOBILE_APP_DEPENDENCIES = {
     dependencies: {
         '@shared/api-client': 'workspace:*',
@@ -187,7 +195,7 @@ export const MOBILE_APP_DEPENDENCIES = {
         // renovate: datasource=npm depName=expo
         expo: '56.0.16',
         // renovate: datasource=npm depName=expo-constants
-        'expo-constants': '56.0.21',
+        'expo-constants': '56.0.22',
         // renovate: datasource=npm depName=expo-linking
         'expo-linking': '56.0.15',
         // renovate: datasource=npm depName=expo-router
@@ -290,12 +298,7 @@ export const DESKTOP_DEPENDENCIES = {
         // renovate: datasource=npm depName=@clerk/clerk-js
         '@clerk/clerk-js': '6.25.3',
         '@clerk/ui': WEB_APP_DEPENDENCIES.dependencies['@clerk/ui'],
-        // Clerk's browser bundle imports @solana/wallet-adapter-react, whose web3 peer must be explicit when autoInstallPeers is disabled.
-        // renovate: datasource=npm depName=@solana/web3.js
-        '@solana/web3.js': '1.98.4',
-        // Clerk's Solana wallet adapter expects the current bs58 peer alongside web3.js.
-        // renovate: datasource=npm depName=bs58
-        bs58: '6.0.0',
+        ...CLERK_SOLANA_PEER_DEPENDENCIES,
         react: EXTENSION_DEPENDENCIES.dependencies.react,
         'react-dom': EXTENSION_DEPENDENCIES.dependencies['react-dom'],
         clsx: EXTENSION_DEPENDENCIES.dependencies.clsx,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { APP_MODULES, FEATURE_MODULES, USAGE, buildAddOptions, buildOptions, deriveDisplayName, deriveProjectName, normalizeModuleName, parseCli, parseNewProjectRequest, buildOptionsForRoot, parseUiAddOptions, } from './cli.js';
-export type { AppModule, FeatureModule, ParsedFlags, SupportedModule } from './cli.js';
+export { USAGE, buildAddOptions, buildOptions, deriveDisplayName, deriveProjectName, normalizeModuleName, parseCli, parseNewProjectRequest, buildOptionsForRoot, parseUiAddOptions, } from './cli.js';
+export type { ParsedFlags, SupportedModule } from './cli.js';
 export { doctorProject, isSupportedProjectUpgrade, scaffoldAddModules, scaffoldProject, scaffoldUiComponents, scaffoldUpgradeProject, } from './scaffold.js';
 export type { AddOptions, DoctorIssue, DoctorReport, InitOptions, ProjectOptions, UiAddOptions, UpgradeOptions, } from './scaffold.js';
 export * from './architecture/index.js';

package/dist/index.js

@@ -1,4 +1,4 @@
-export { APP_MODULES, FEATURE_MODULES, USAGE, buildAddOptions, buildOptions, deriveDisplayName, deriveProjectName, normalizeModuleName, parseCli, parseNewProjectRequest, buildOptionsForRoot, parseUiAddOptions, } from './cli.js';
+export { USAGE, buildAddOptions, buildOptions, deriveDisplayName, deriveProjectName, normalizeModuleName, parseCli, parseNewProjectRequest, buildOptionsForRoot, parseUiAddOptions, } from './cli.js';
 export { doctorProject, isSupportedProjectUpgrade, scaffoldAddModules, scaffoldProject, scaffoldUiComponents, scaffoldUpgradeProject, } from './scaffold.js';
 export * from './architecture/index.js';
 export { BundledTemplateSource, assertTemplateProvenance, hashTemplateDirectory, materializeTemplates, templateIdsForModules, } from './template-source.js';

package/dist/project.d.ts

@@ -0,0 +1,30 @@
+import type { NativeStylingLibrary } from './ui.js';
+export type AppSelections = {
+    web: boolean;
+    mobile: boolean;
+    api: boolean;
+    desktop: boolean;
+    extension: boolean;
+};
+export type FeatureSelections = {
+    database: boolean;
+    auth: boolean;
+    billing: boolean;
+    storage: boolean;
+    nativeSubscriptions: boolean;
+    electronUpdater: boolean;
+};
+/**
+ * The project shape consumed by every template.
+ *
+ * Keep this independent from the scaffold orchestrator so templates depend on
+ * the project model, not on the command that happens to create it.
+ */
+export interface ProjectOptions {
+    projectName: string;
+    displayName: string;
+    apps: AppSelections;
+    features: FeatureSelections;
+    skipInstall?: boolean;
+    nativeStyling?: NativeStylingLibrary;
+}

package/dist/project.js

@@ -0,0 +1 @@
+export {};

package/dist/prompts.d.ts

@@ -1,5 +1,6 @@
 export declare function shouldPromptForInitModules(args: readonly string[], isTTY: boolean): boolean;
 export declare function hasUiSelection(args: readonly string[]): boolean;
-export declare function parsePromptModules(input: string, fallback: readonly string[]): string[];
-export declare const DEFAULT_PROMPT_APP_MODULES: readonly ["web", "mobile", "api", "desktop", "extension"];
-export declare const DEFAULT_PROMPT_FEATURE_MODULES: readonly ["db", "auth", "billing", "storage", "native-subscriptions", "electron-updater"];
+export declare function parsePromptModuleSelection(input: string, fallback: readonly string[], all: readonly string[]): string[];
+export declare function parsePromptConfirmation(input: string): boolean;
+export declare const DEFAULT_PROMPT_APP_MODULES: readonly ["web"];
+export declare const DEFAULT_PROMPT_FEATURE_MODULES: readonly [];

package/dist/prompts.js

@@ -1,6 +1,6 @@
-import { APP_MODULES, FEATURE_MODULES, normalizeModuleName } from './cli.js';
+import { isModuleId } from './architecture/modules.js';
 function hasModuleSelection(args) {
-    return args.some((arg) => normalizeModuleName(arg.startsWith('--') ? arg.slice(2) : arg) != null);
+    return args.some((arg) => arg === '--all' || isModuleId(arg.startsWith('--') ? arg.slice(2) : arg));
 }
 export function shouldPromptForInitModules(args, isTTY) {
     return isTTY && !args.includes('--json') && !hasModuleSelection(args);
@@ -8,12 +8,34 @@ export function shouldPromptForInitModules(args, isTTY) {
 export function hasUiSelection(args) {
     return args.some((arg) => arg === '--ui' || arg.startsWith('--ui='));
 }
-export function parsePromptModules(input, fallback) {
+export function parsePromptModuleSelection(input, fallback, all) {
     const tokens = input
         .split(/[\s,]+/)
-        .map((entry) => entry.trim())
+        .map((entry) => entry.trim().toLowerCase())
         .filter(Boolean);
-    return tokens.length > 0 ? tokens : [...fallback];
+    const specialTokens = tokens.filter((token) => token === 'all' || token === 'none');
+    if (specialTokens.length > 0 && tokens.length > 1) {
+        throw new Error(`"${specialTokens[0]}" must be used by itself.`);
+    }
+    if (tokens[0] === 'none')
+        return [];
+    if (tokens[0] === 'all')
+        return [...all];
+    const selected = tokens.length > 0 ? tokens : [...fallback];
+    const allowed = new Set(all);
+    const unknown = selected.filter((token) => !allowed.has(token));
+    if (unknown.length > 0) {
+        throw new Error(`Unknown selection: ${unknown.join(', ')}. Choose from: ${all.join(', ')}, all, or none.`);
+    }
+    return [...new Set(selected)];
 }
-export const DEFAULT_PROMPT_APP_MODULES = APP_MODULES;
-export const DEFAULT_PROMPT_FEATURE_MODULES = FEATURE_MODULES;
+export function parsePromptConfirmation(input) {
+    const answer = input.trim().toLowerCase();
+    if (answer === '' || answer === 'y' || answer === 'yes')
+        return true;
+    if (answer === 'n' || answer === 'no')
+        return false;
+    throw new Error('Enter yes or no.');
+}
+export const DEFAULT_PROMPT_APP_MODULES = ['web'];
+export const DEFAULT_PROMPT_FEATURE_MODULES = [];