create-basalt 1.3.0 → 1.4.1

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { spawn } from 'node:child_process';
 import { stdin, stdout } from 'node:process';
-import { createProject, detectPackageManager, runWizard, ttyPrompter, TargetNotEmptyError, WizardCancelledError, } from './index.js';
+import { createProject, detectPackageManager, resolveRunDefaults, runWizard, ttyPrompter, TargetNotEmptyError, WizardCancelledError, } from './index.js';
 const USAGE = `Usage: npm create basalt <name> [options]
 
 Options:
@@ -12,8 +12,12 @@ Options:
   --ui            Scaffold a web/ frontend (React + shadcn + SDK)
   --cli           Scaffold the 'basalt' CLI (code generators + commands)
   --mcp           Expose read-only routes as MCP tools at /mcp
-  --install       Install dependencies after scaffolding
+  --install       Install dependencies (default: yes in an interactive
+                  terminal, skipped in CI/non-TTY; --no-install to opt out)
+  --no-install    Never install dependencies
   --git           Initialize a git repository with a first commit
+                  (same default rule as --install; --no-git to opt out)
+  --no-git        Never initialize a git repository
   --pm=<manager>  Package manager: pnpm | npm | yarn | bun (default: auto-detect)
   -y, --yes       Skip prompts and accept defaults
   -h, --help      Show this help
@@ -28,8 +32,6 @@ function parseArgs(argv) {
         ui: false,
         cli: false,
         mcp: false,
-        install: false,
-        git: false,
         yes: false,
     };
     for (const token of argv) {
@@ -47,8 +49,12 @@ function parseArgs(argv) {
             flags.mcp = true;
         else if (token === '--install')
             flags.install = true;
+        else if (token === '--no-install')
+            flags.install = false;
         else if (token === '--git')
             flags.git = true;
+        else if (token === '--no-git')
+            flags.git = false;
         else if (token === '-y' || token === '--yes')
             flags.yes = true;
         else if (token.startsWith('--dir='))
@@ -131,21 +137,30 @@ try {
     console.log(`\nCreated ${result.options.name} in ${result.dir}\n`);
     for (const file of result.files)
         console.log(`  ${file}`);
-    if (flags.git) {
+    const run_ = resolveRunDefaults({
+        install: flags.install,
+        git: flags.git,
+        isTTY: Boolean(stdin.isTTY),
+        ci: Boolean(process.env['CI']),
+    });
+    if (flags.install === undefined && !run_.interactive) {
+        console.log('\nSkipping dependency install (CI/non-interactive) — pass --install to force it.');
+    }
+    if (run_.git) {
         console.log('\nInitializing git repository…');
         const ok = (await run('git', ['init', '-q'], result.dir)) &&
             (await run('git', ['add', '-A'], result.dir)) &&
             (await run('git', ['commit', '-q', '-m', 'Initial commit from create-basalt'], result.dir));
         console.log(ok ? '  git repository initialized.' : '  (skipped — git unavailable or already a repo)');
     }
-    if (flags.install) {
+    if (run_.install) {
         console.log(`\nInstalling dependencies with ${pm}…`);
         const ok = await run(pm, ['install'], result.dir);
         if (!ok)
             console.log(`  (install failed — run "${pm} install" yourself)`);
     }
     const steps = [`cd ${result.dir}`];
-    if (!flags.install)
+    if (!run_.install)
         steps.push(`${pm} install`);
     steps.push(`${pm} run dev${flags.ui ? '        # API on :3000' : ''}`);
     // `web` is wired as a pnpm workspace member (pnpm-workspace.yaml), so its dev

package/dist/index.d.ts

@@ -28,6 +28,24 @@ export type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
  * `npm_config_user_agent` env var npm/pnpm/yarn/bun all set. Falls back to npm.
  */
 export declare function detectPackageManager(userAgent?: string | undefined): PackageManager;
+/**
+ * Resolve whether to install dependencies / init git when the flag was not
+ * given explicitly (D1, ecosystem review 2026-08): interactive terminals
+ * default to YES — `npm create basalt my-app` should end in a runnable app —
+ * while CI and non-TTY runs default to NO, so automation never gets a
+ * surprise install. An explicit `--install`/`--no-install` (or git flag)
+ * always wins over the environment.
+ */
+export declare function resolveRunDefaults(input: {
+    install?: boolean | undefined;
+    git?: boolean | undefined;
+    isTTY: boolean;
+    ci: boolean;
+}): {
+    install: boolean;
+    git: boolean;
+    interactive: boolean;
+};
 /** Generates a ready-to-run Basalt app. Does not install dependencies. */
 export declare function createProject(input: CreateProjectInput): Promise<CreateProjectResult>;
 export { runWizard, validateProjectName, PRESETS, FEATURES, type WizardResult, type WizardOptions, type FeatureKey } from './wizard.js';

package/dist/index.js

@@ -18,6 +18,22 @@ export function detectPackageManager(userAgent = process.env['npm_config_user_ag
         return name;
     return 'npm';
 }
+/**
+ * Resolve whether to install dependencies / init git when the flag was not
+ * given explicitly (D1, ecosystem review 2026-08): interactive terminals
+ * default to YES — `npm create basalt my-app` should end in a runnable app —
+ * while CI and non-TTY runs default to NO, so automation never gets a
+ * surprise install. An explicit `--install`/`--no-install` (or git flag)
+ * always wins over the environment.
+ */
+export function resolveRunDefaults(input) {
+    const interactive = input.isTTY && !input.ci;
+    return {
+        interactive,
+        install: input.install ?? interactive,
+        git: input.git ?? interactive,
+    };
+}
 /** Generates a ready-to-run Basalt app. Does not install dependencies. */
 export async function createProject(input) {
     const options = {

package/dist/templates.js

@@ -95,12 +95,15 @@ export function tsconfigJson() {
 }
 export function envTs(options) {
     return `import { defineEnv${options.auth ? ', secret' : ''} } from '@basaltkit/env'
+import { LOG_LEVELS } from '@basaltkit/logger'
 import { z } from 'zod'
 
 export const env = defineEnv({
   PORT: z.coerce.number().default(3000),
   HOST: z.string().default('0.0.0.0'),
-  LOG_LEVEL: z.string().default('info'),
+  // Typed against the logger's LogLevel union — a free-form string here fails
+  // \`pnpm typecheck\` where loggerPlugin({ level }) consumes it.
+  LOG_LEVEL: z.enum(LOG_LEVELS).default('info'),
   NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),${options.auth
         ? `
   // Signs JWTs and sessions. secret() is fail-closed: required in production
@@ -123,7 +126,7 @@ export function appTs(options) {
         `import { configPlugin } from '@basaltkit/config'`,
         `import { eventsPlugin } from '@basaltkit/events'`,
         `import { fastifyPlugin, securityPlugin } from '@basaltkit/fastify'`,
-        `import { loggerPlugin } from '@basaltkit/logger'`,
+        `import { loggerPlugin, type LogLevel } from '@basaltkit/logger'`,
     ];
     const plugins = [
         `configPlugin({ app: { name: '${options.name}' } })`,
@@ -197,7 +200,7 @@ export function appTs(options) {
 import { appRoutes } from './routes.js'
 
 export interface BuildAppOptions {
-  logLevel?: string
+  logLevel?: LogLevel
   pretty?: boolean${commandsField}
 }
 

package/dist/wizard.js

@@ -70,8 +70,8 @@ export async function runWizard(prompter, options = {}) {
         prompter.note(`  Note: the Web UI is a pnpm workspace — using pnpm instead of ${pm}.`);
         pm = 'pnpm';
     }
-    const install = await prompter.confirm({ message: 'Install dependencies now?', initial: false });
-    const git = await prompter.confirm({ message: 'Initialize a git repository?', initial: false });
+    const install = await prompter.confirm({ message: 'Install dependencies now?', initial: true });
+    const git = await prompter.confirm({ message: 'Initialize a git repository?', initial: true });
     const enabled = FEATURES.filter((f) => featureSet.has(f.value)).map((f) => f.label);
     prompter.note(`\n  Summary\n` +
         `    name      ${name}\n` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-basalt",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "Scaffold a production-shaped Basalt SaaS app: npm create basalt my-saas [--billing] [--ui] [--cli] [--install] [--git]",
   "license": "MIT",
   "type": "module",
@@ -20,6 +20,21 @@
     "@types/node": "^26.3.0",
     "typescript": "^7.0.2",
     "vitest": "^4.1.11",
+    "zod": "^4.0.0",
+    "@basaltkit/auth": "^1.6.3",
+    "@basaltkit/config": "^1.1.1",
+    "@basaltkit/cli": "^1.2.1",
+    "@basaltkit/env": "^1.0.1",
+    "@basaltkit/core": "^1.3.0",
+    "@basaltkit/fastify": "^1.7.0",
+    "@basaltkit/generator": "^1.2.0",
+    "@basaltkit/events": "^1.0.1",
+    "@basaltkit/logger": "^1.2.1",
+    "@basaltkit/mcp": "^1.0.3",
+    "@basaltkit/subscriptions": "^2.7.0",
+    "@basaltkit/tenancy": "^1.4.0",
+    "@basaltkit/prisma": "^1.4.2",
+    "@basaltkit/testing": "^1.1.0",
     "@basaltkit/tsconfig": "^0.24.0"
   },
   "publishConfig": {