@tanstack/cli 0.64.6 → 0.66.0

package/dist/cli.js

@@ -1,10 +1,10 @@
 import fs from 'node:fs';
-import { resolve } from 'node:path';
+import { relative, resolve } from 'node:path';
 import { Command, InvalidArgumentError, Option } from 'commander';
 import { cancel, confirm, intro, isCancel, log } from '@clack/prompts';
 import chalk from 'chalk';
 import semver from 'semver';
-import { SUPPORTED_PACKAGE_MANAGERS, addToApp, compileAddOn, compileStarter, createApp, devAddOn, getAllAddOns, getFrameworkByName, getFrameworks, initAddOn, initStarter, } from '@tanstack/create';
+import { SUPPORTED_PACKAGE_MANAGERS, addToApp, compileAddOn, compileStarter, createApp, devAddOn, getAllAddOns, getFrameworkByName, getFrameworks, initAddOn, initStarter, isDemoFilePath, } from '@tanstack/create';
 import { LIBRARY_GROUPS, fetchDocContent, fetchLibraries, fetchPartners, searchTanStackDocs, } from './discovery.js';
 import { getTelemetryStatus, setTelemetryEnabled, } from './telemetry-config.js';
 import { createTelemetryClient } from './telemetry.js';
@@ -114,6 +114,7 @@ function getCreateTelemetryProperties(projectName, options) {
         framework: options.framework ? sanitizeId(options.framework) : undefined,
         git: options.git,
         install: options.install !== false,
+        intent: options.intent !== false,
         interactive: !!options.interactive,
         json: !!options.json,
         non_interactive: !!options.nonInteractive || !!options.yes,
@@ -139,6 +140,7 @@ function getResolvedCreateTelemetryProperties(finalOptions, cliOptions) {
         framework: sanitizeId(finalOptions.framework.id),
         git: finalOptions.git,
         install: finalOptions.install !== false,
+        intent: finalOptions.intent,
         package_manager: finalOptions.packageManager,
         router_only: !!cliOptions.routerOnly,
         toolchain: toolchain ? sanitizeId(toolchain.id) : undefined,
@@ -173,6 +175,144 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
             process.exit(0);
         }
     }
+    async function confirmCreateOptions(finalOptions) {
+        const lines = [];
+        lines.push(`  Project:         ${finalOptions.projectName}`);
+        lines.push(`  Location:        ${finalOptions.targetDir}`);
+        lines.push(`  Framework:       ${finalOptions.framework.name}`);
+        lines.push(`  Mode:            ${finalOptions.mode}`);
+        lines.push(`  Package manager: ${finalOptions.packageManager}`);
+        if (finalOptions.starter) {
+            lines.push(`  Template:        ${finalOptions.starter.name}`);
+        }
+        const auth = [];
+        const database = [];
+        const orm = [];
+        const deploy = [];
+        const otherAddOns = [];
+        for (const addOn of finalOptions.chosenAddOns) {
+            switch (addOn.category) {
+                case 'auth':
+                    auth.push(addOn.name);
+                    break;
+                case 'database':
+                    database.push(addOn.name);
+                    break;
+                case 'orm':
+                    orm.push(addOn.name);
+                    break;
+                case 'deploy':
+                    deploy.push(addOn.name);
+                    break;
+                default:
+                    otherAddOns.push(addOn.name);
+            }
+        }
+        if (auth.length +
+            database.length +
+            orm.length +
+            deploy.length +
+            otherAddOns.length >
+            0) {
+            lines.push('');
+        }
+        if (auth.length > 0) {
+            lines.push(`  Auth:            ${auth.join(', ')}`);
+        }
+        if (database.length > 0) {
+            lines.push(`  Database:        ${database.join(', ')}`);
+        }
+        if (orm.length > 0) {
+            lines.push(`  ORM:             ${orm.join(', ')}`);
+        }
+        if (deploy.length > 0) {
+            lines.push(`  Deploy:          ${deploy.join(', ')}`);
+        }
+        if (otherAddOns.length > 0) {
+            lines.push(`  Other add-ons:   ${otherAddOns.join(', ')}`);
+        }
+        lines.push('');
+        lines.push(`  Initialize git:  ${finalOptions.git ? 'yes' : 'no'}`);
+        lines.push(`  Install deps:    ${finalOptions.install === false ? 'no' : 'yes'}`);
+        lines.push(`  Agent skills:    ${finalOptions.intent ? 'yes' : 'no'}`);
+        log.info(`About to create:\n\n${lines.join('\n')}`);
+        const conflicts = findExclusiveConflicts(finalOptions.chosenAddOns);
+        if (conflicts.length > 0) {
+            log.warn(`Conflicting selections detected:\n${conflicts
+                .map((c) => `  • ${c.category}: ${c.names.join(', ')}`)
+                .join('\n')}`);
+        }
+        const shouldContinue = await confirm({
+            message: 'Continue with these settings?',
+            initialValue: true,
+        });
+        if (isCancel(shouldContinue) || !shouldContinue) {
+            cancel('Operation cancelled.');
+            process.exit(0);
+        }
+    }
+    const CLEAN_DEMOS_SKIP_DIRS = new Set([
+        'node_modules',
+        '.git',
+        'dist',
+        '.output',
+        '.tanstack',
+        '.nitro',
+        '.wrangler',
+    ]);
+    function findDemoFiles(root) {
+        const results = [];
+        function walk(dir) {
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                const full = resolve(dir, entry.name);
+                if (entry.isDirectory()) {
+                    if (CLEAN_DEMOS_SKIP_DIRS.has(entry.name))
+                        continue;
+                    walk(full);
+                }
+                else if (entry.isFile() && isDemoFilePath(full)) {
+                    results.push(full);
+                }
+            }
+        }
+        walk(root);
+        return results.sort();
+    }
+    function pruneEmptyDemoDirs(root) {
+        const candidates = ['src/routes/demo', 'src/routes/example'];
+        for (const rel of candidates) {
+            const dir = resolve(root, rel);
+            if (!fs.existsSync(dir))
+                continue;
+            try {
+                if (fs.readdirSync(dir).length === 0) {
+                    fs.rmdirSync(dir);
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    function findExclusiveConflicts(addOns) {
+        const buckets = {};
+        for (const addOn of addOns) {
+            for (const exclusive of addOn.exclusive || []) {
+                buckets[exclusive] ?? (buckets[exclusive] = []);
+                buckets[exclusive].push(addOn.name);
+            }
+        }
+        return Object.entries(buckets)
+            .filter(([_, names]) => names.length > 1)
+            .map(([category, names]) => ({ category, names }));
+    }
     const availableFrameworks = getFrameworks().map((f) => f.name);
     function resolveBuiltInDevWatchPath(frameworkId) {
         const candidates = [
@@ -487,6 +627,7 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
                 if (!wantsInteractiveMode && cliOptions.addOns === true) {
                     throw new Error('When running non-interactively, pass explicit add-ons via --add-ons <ids>.');
                 }
+                let cameFromPrompts = false;
                 if (finalOptions) {
                     intro(`Creating a new ${appName} app in ${projectName}...`);
                 }
@@ -503,6 +644,7 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
                             ? getFrameworkByName(defaultFramework)?.id
                             : undefined,
                     });
+                    cameFromPrompts = true;
                 }
                 if (!finalOptions) {
                     throw new Error('No options were provided');
@@ -522,6 +664,9 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
                 else {
                     finalOptions.targetDir = resolve(process.cwd(), finalOptions.projectName);
                 }
+                if (cameFromPrompts) {
+                    await confirmCreateOptions(finalOptions);
+                }
                 await confirmTargetDirectorySafety(finalOptions.targetDir, options.force);
                 await createApp(environment, finalOptions);
             });
@@ -598,6 +743,8 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
             .option('--json', 'output JSON for automation', false)
             .option('--git', 'create a git repository')
             .option('--no-git', 'do not create a git repository')
+            .option('--intent', 'set up TanStack Intent skill mappings for coding agents')
+            .option('--no-intent', 'skip TanStack Intent setup')
             .option('--target-dir <path>', 'the target directory for the application root')
             .option('--add-on-config <config>', 'JSON string with add-on configuration options')
             .option('-f, --force', 'force project creation even if the target directory is not empty', false);
@@ -971,6 +1118,64 @@ Remove your node_modules directory and package lock file and re-install.`);
             process.exit(1);
         }
     });
+    // === CLEAN-DEMOS SUBCOMMAND ===
+    program
+        .command('clean-demos')
+        .description('Remove demo/example files from a scaffolded TanStack project')
+        .argument('[target-dir]', 'project directory (default: current directory)', '.')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
+        .option('-y, --yes', 'skip confirmation prompt', false)
+        .option('--dry-run', 'list files without deleting', false)
+        .action(async (targetDir, cmdOptions) => {
+        try {
+            await runWithTelemetry('clean-demos', {
+                properties: {
+                    yes: cmdOptions.yes,
+                    dry_run: cmdOptions.dryRun,
+                },
+            }, async (telemetry) => {
+                const root = resolve(targetDir);
+                if (!fs.existsSync(root)) {
+                    throw new Error(`Directory not found: ${root}`);
+                }
+                if (!fs.existsSync(resolve(root, '.cta.json'))) {
+                    log.warn(`No .cta.json in ${root} — this may not be a TanStack scaffold. Continuing anyway.`);
+                }
+                const demoFiles = findDemoFiles(root);
+                telemetry.mergeProperties({ result_count: demoFiles.length });
+                if (demoFiles.length === 0) {
+                    log.info('No demo or example files found.');
+                    return;
+                }
+                log.info(`Found ${demoFiles.length} demo/example file(s):\n${demoFiles
+                    .map((f) => `  • ${relative(root, f)}`)
+                    .join('\n')}`);
+                if (cmdOptions.dryRun) {
+                    log.info('(dry run — nothing deleted)');
+                    return;
+                }
+                if (!cmdOptions.yes) {
+                    const ok = await confirm({
+                        message: 'Delete these files?',
+                        initialValue: false,
+                    });
+                    if (isCancel(ok) || !ok) {
+                        cancel('Operation cancelled.');
+                        process.exit(0);
+                    }
+                }
+                for (const file of demoFiles) {
+                    fs.rmSync(file, { force: true });
+                }
+                pruneEmptyDemoDirs(root);
+                log.info(`Deleted ${demoFiles.length} file(s). Run your dev server to regenerate routeTree.gen.ts.`);
+            });
+        }
+        catch (error) {
+            log.error(formatErrorMessage(error));
+            process.exit(1);
+        }
+    });
     const telemetryCommand = program.command('telemetry');
     telemetryCommand
         .command('status')
@@ -1018,6 +1223,8 @@ Remove your node_modules directory and package lock file and re-install.`);
         .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .argument('[add-on...]', 'Name of the add-ons (or add-ons separated by spaces or commas)')
         .option('--forced', 'Force the add-on to be added', false)
+        .option('--intent', 'set up TanStack Intent skill mappings for coding agents')
+        .option('--no-intent', 'skip TanStack Intent setup')
         .action(async (addOns, options) => {
         try {
             await runWithTelemetry('add', {
@@ -1044,6 +1251,7 @@ Remove your node_modules directory and package lock file and re-install.`);
                     if (selectedAddOns.length) {
                         await addToApp(environment, selectedAddOns, resolve(process.cwd()), {
                             forced: options.forced,
+                            intent: options.intent,
                         });
                     }
                     return;
@@ -1055,6 +1263,7 @@ Remove your node_modules directory and package lock file and re-install.`);
                 });
                 await addToApp(environment, parsedAddOns, resolve(process.cwd()), {
                     forced: options.forced,
+                    intent: options.intent,
                 });
             });
         }

package/dist/command-line.js

@@ -381,6 +381,7 @@ export async function normalizeOptions(cliOptions, forcedAddOns, opts) {
             DEFAULT_PACKAGE_MANAGER,
         git: cliOptions.git ?? true,
         install: cliOptions.install,
+        intent: cliOptions.intent ?? true,
         chosenAddOns,
         addOnOptions: {
             ...populateAddOnOptionsDefaults(chosenAddOns),

package/dist/dev-watch.js

@@ -189,6 +189,7 @@ export class DevWatchManager {
                 targetDir: this.tempDir,
                 git: false,
                 install: packageMetadataChanged,
+                intent: false,
             };
             // Show package installation indicator if needed
             if (packageMetadataChanged) {

package/dist/types/types.d.ts

@@ -19,6 +19,7 @@ export interface CliOptions {
     devWatch?: string;
     runDev?: boolean;
     install?: boolean;
+    intent?: boolean;
     addOnConfig?: string;
     force?: boolean;
     routerOnly?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/cli",
-  "version": "0.64.6",
+  "version": "0.66.0",
   "description": "TanStack CLI",
   "type": "module",
   "main": "./dist/index.js",
@@ -44,7 +44,7 @@
     "tempy": "^3.1.0",
     "validate-npm-package-name": "^7.0.0",
     "zod": "^3.24.2",
-    "@tanstack/create": "0.63.9"
+    "@tanstack/create": "0.65.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.2",