@fluojs/cli 1.1.0 → 2.0.1

package/dist/commands/new.js

@@ -1,12 +1,12 @@
 import { resolve } from 'node:path';
-import { spinner as clackSpinner, log as clackLog } from '@clack/prompts';
-import { renderAliasList, renderHelpTable } from '../help.js';
-import { isCliPromptCancelledError } from '../prompt-cancel.js';
+import { log as clackLog, spinner as clackSpinner } from '@clack/prompts';
 import { installDependencies } from '../new/install.js';
 import { collectBootstrapAnswers } from '../new/prompt.js';
 import { resolveBootstrapPlan } from '../new/resolver.js';
 import { scaffoldBootstrapApp } from '../new/scaffold.js';
 import { SUPPORTED_BOOTSTRAP_PLATFORMS, SUPPORTED_BOOTSTRAP_RUNTIMES, SUPPORTED_BOOTSTRAP_SHAPES, SUPPORTED_BOOTSTRAP_TOOLING_PRESETS, SUPPORTED_BOOTSTRAP_TOPOLOGY_MODES, SUPPORTED_BOOTSTRAP_TRANSPORTS } from '../new/starter-profiles.js';
+import { isCliPromptCancelledError } from '../prompt-cancel.js';
+import { newUsage } from '../usage.js';
 function shouldUseInteractiveShell(runtime) {
   return runtime.prompt === undefined && runtime.stdout === undefined && runtime.stderr === undefined && (runtime.interactive ?? true) && Boolean(runtime.stdin?.isTTY ?? process.stdin.isTTY);
 }
@@ -20,76 +20,19 @@ function extractDependencyInstallationOutput(error) {
 function isHelpFlag(value) {
   return value === '--help' || value === '-h';
 }
+function readInternalScaffoldOverrides(runtime) {
+  const dependencySource = 'dependencySource' in runtime ? runtime.dependencySource : undefined;
+  const repoRoot = 'repoRoot' in runtime ? runtime.repoRoot : undefined;
+  return {
+    dependencySource: dependencySource === 'local' || dependencySource === 'published' ? dependencySource : undefined,
+    repoRoot: typeof repoRoot === 'string' ? repoRoot : undefined
+  };
+}
 
 /**
  * Runtime dependency overrides for the programmatic `fluo new` entry point.
  */
 
-const NEW_OPTION_HELP = [{
-  aliases: [],
-  description: 'Provide the project name without using the positional argument.',
-  option: '--name <project-name>'
-}, {
-  aliases: [],
-  description: 'Select the scaffold shape explicitly (application for HTTP, microservice for the transport-driven starter path, mixed for the API + microservice starter).',
-  option: '--shape <application|microservice|mixed>'
-}, {
-  aliases: [],
-  description: 'Select the transport path explicitly (http for applications, tcp for the runnable microservice starter, plus shipped microservice starter transports).',
-  option: '--transport <http|tcp|redis-streams|nats|kafka|rabbitmq|mqtt|grpc>'
-}, {
-  aliases: [],
-  description: 'Select the runtime explicitly (node, bun, deno, or cloudflare-workers for application starters; node for microservice and mixed starters).',
-  option: '--runtime <node|bun|deno|cloudflare-workers>'
-}, {
-  aliases: [],
-  description: 'Select the platform adapter explicitly (fastify, express, or nodejs on node; bun/deno/cloudflare-workers on their native runtimes; none for microservices).',
-  option: '--platform <fastify|express|nodejs|bun|deno|cloudflare-workers|none>'
-}, {
-  aliases: [],
-  description: 'Select the starter tooling preset explicitly (currently only standard).',
-  option: '--tooling <standard>'
-}, {
-  aliases: [],
-  description: 'Select the starter topology mode explicitly (currently only single-package).',
-  option: '--topology <single-package>'
-}, {
-  aliases: [],
-  description: 'Choose which package manager installs the starter dependencies.',
-  option: '--package-manager <pnpm|npm|yarn|bun>'
-}, {
-  aliases: [],
-  description: 'Write the new app to a custom target directory (always overrides positional name path).',
-  option: '--target-directory <path>'
-}, {
-  aliases: [],
-  description: 'Overwrite files in a non-empty target directory without prompting.',
-  option: '--force'
-}, {
-  aliases: [],
-  description: 'Install starter dependencies after writing files.',
-  option: '--install'
-}, {
-  aliases: [],
-  description: 'Skip starter dependency installation.',
-  option: '--no-install'
-}, {
-  aliases: [],
-  description: 'Initialize a git repository in the generated starter.',
-  option: '--git'
-}, {
-  aliases: [],
-  description: 'Skip git repository initialization in the generated starter.',
-  option: '--no-git'
-}, {
-  aliases: [],
-  description: 'Print the resolved scaffold plan without writing files, installing dependencies, or initializing git.',
-  option: '--print-plan'
-}, {
-  aliases: ['-h'],
-  description: 'Show help for the new command.',
-  option: '--help'
-}];
 const SUPPORTED_PACKAGE_MANAGERS = new Set(['bun', 'npm', 'pnpm', 'yarn']);
 const SUPPORTED_SHAPES = new Set(SUPPORTED_BOOTSTRAP_SHAPES);
 const SUPPORTED_TRANSPORTS = new Set(SUPPORTED_BOOTSTRAP_TRANSPORTS);
@@ -249,24 +192,6 @@ function renderScaffoldPlanPreview(answers, resolvedTargetDirectory) {
   return ['fluo new scaffold plan', '', `Project name: ${answers.projectName}`, `Target directory: ${answers.targetDirectory}`, `Resolved target: ${resolvedTargetDirectory}`, `Shape: ${answers.shape}`, `Runtime: ${answers.runtime}`, `Platform: ${answers.platform}`, `Transport: ${answers.transport}`, `Tooling preset: ${answers.tooling}`, `Topology: ${answers.topology.mode}${answers.topology.deferred ? ' (deferred)' : ''}`, `Starter recipe: ${bootstrapPlan.profile.id}`, `Emitter: ${bootstrapPlan.emitter.type}`, `Package manager: ${answers.packageManager}`, `Install dependencies: ${answers.installDependencies ? 'yes' : 'no'}`, `Initialize git: ${answers.initializeGit ? 'yes' : 'no'}`, '', 'Dependencies:', `  runtime: ${renderDependencyList(bootstrapPlan.dependencies.dependencies)}`, `  dev: ${renderDependencyList(bootstrapPlan.dependencies.devDependencies)}`, '', 'Side effects: none. Preview mode does not create files, install dependencies, or initialize git.'].join('\n');
 }
 
-/**
- * Renders CLI help text for `fluo new`.
- *
- * @returns Stable help output for the scaffolding command.
- */
-export function newUsage() {
-  return ['Usage: fluo new|create [project-name] [options]', '', 'Options', renderHelpTable(NEW_OPTION_HELP, [{
-    header: 'Option',
-    render: entry => entry.option
-  }, {
-    header: 'Aliases',
-    render: entry => renderAliasList(entry.aliases)
-  }, {
-    header: 'Description',
-    render: entry => entry.description
-  }]), '', 'Next steps:', '  cd <app-name>', '  pnpm dev  # runs fluo dev from the generated package.json script', '', 'Docs: https://github.com/fluojs/fluo/tree/main/docs/getting-started/quick-start.md'].join('\n');
-}
-
 /**
  * Executes `fluo new` with parsed arguments and scaffold options.
  *
@@ -313,13 +238,14 @@ export async function runNewCommand(argv, runtime = {}) {
       stdout.write(`${renderScaffoldPlanPreview(answers, targetDirectory)}\n`);
       return 0;
     }
+    const internalScaffoldOverrides = readInternalScaffoldOverrides(runtime);
     const options = {
       ...answers,
-      dependencySource: runtime.dependencySource,
+      dependencySource: internalScaffoldOverrides.dependencySource,
       force: parsed.force ?? runtime.force,
       initializeGit: answers.initializeGit,
       installDependencies: false,
-      repoRoot: runtime.repoRoot,
+      repoRoot: internalScaffoldOverrides.repoRoot,
       skipInstall: true,
       targetDirectory
     };

package/dist/commands/scripts.d.ts

@@ -1,4 +1,4 @@
-import { startStudioSidecar } from '../studio/sidecar.js';
+import type { startStudioSidecar } from '../studio/sidecar.js';
 type CliStream = {
     isTTY?: boolean;
     write(message: string): unknown;

package/dist/commands/scripts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../src/commands/scripts.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAiD,MAAM,sBAAsB,CAAC;AAGzG,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAMF,KAAK,mBAAmB,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClG,kBAAkB,CAAC,EAAE,OAAO,kBAAkB,CAAC;IAC/C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AAGF,KAAK,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;AA2lB/C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAqB1D;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsFlI"}
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../src/commands/scripts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAuC,MAAM,sBAAsB,CAAC;AAGpG,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAMF,KAAK,mBAAmB,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClG,kBAAkB,CAAC,EAAE,OAAO,kBAAkB,CAAC;IAC/C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AAKF,KAAK,aAAa,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;AAkmB/C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAqB1D;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsFlI"}

package/dist/commands/scripts.js

@@ -3,7 +3,6 @@ import { existsSync, readFileSync } from 'node:fs';
 import { delimiter, dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { createStudioDevtoolsNodeImport } from '../studio/runtime-config.js';
-import { startStudioSidecar } from '../studio/sidecar.js';
 import { SUPPORTED_PACKAGE_MANAGERS } from './package-manager.js';
 const EMPTY_ENV = {};
 const FAILURE_STDOUT_BUFFER_LIMIT = 16_384;
@@ -119,6 +118,12 @@ function defaultSpawnCommand(command, args, options) {
     child.on('close', code => resolveExitCode(code ?? 1));
   });
 }
+async function loadDefaultStudioSidecarFactory() {
+  const {
+    startStudioSidecar: startStudioSidecarImplementation
+  } = await import('../studio/sidecar.js');
+  return startStudioSidecarImplementation;
+}
 function buildNativeNodeWatchStep(passThrough) {
   return {
     command: 'node',
@@ -404,7 +409,8 @@ function assertStudioSupport(command, studio, projectRuntime, devRunner, rawWatc
     throw new Error('fluo dev --studio requires the fluo-owned Node restart runner. Remove --raw-watch and use --runner fluo so Studio lifecycle events stay attached to the CLI restart boundary.');
   }
 }
-function withStudioDryRunEnv(env, project, projectRuntime) {
+function withStudioDryRunEnv(env, project, projectRuntime, studioPort) {
+  const portLabel = studioPort === undefined ? '<auto>' : String(studioPort);
   return {
     ...env,
     FLUO_STUDIO: '1',
@@ -412,7 +418,7 @@ function withStudioDryRunEnv(env, project, projectRuntime) {
     FLUO_STUDIO_EPOCH: '<generated-at-runtime>',
     FLUO_STUDIO_RUNTIME: projectRuntimeToStudioRuntime(projectRuntime),
     FLUO_STUDIO_TOKEN: '<generated-at-runtime>',
-    FLUO_STUDIO_URL: 'http://127.0.0.1:<auto>'
+    FLUO_STUDIO_URL: `http://127.0.0.1:${portLabel}`
   };
 }
 function renderStep(step) {
@@ -635,10 +641,10 @@ export async function runScriptCommand(command, argv, runtime = {}) {
   const verbose = parsed.verbose || isEnabledEnvironmentFlag(env.FLUO_VERBOSE);
   let childEnv = withPipedReporterColorEnv(withProjectLocalBin(withDefaultNodeEnv(env, defaultNodeEnv), project.directory), reporterMode, stdout, stderr);
   if (parsed.studio && parsed.dryRun) {
-    childEnv = withStudioDryRunEnv(childEnv, project, projectRuntime);
+    childEnv = withStudioDryRunEnv(childEnv, project, projectRuntime, parsed.studioPort);
   }
   if (command === 'dev' && parsed.studio && !parsed.dryRun) {
-    const studioSidecarFactory = runtime.startStudioSidecar ?? startStudioSidecar;
+    const studioSidecarFactory = runtime.startStudioSidecar ?? (await loadDefaultStudioSidecarFactory());
     const studioSidecar = await studioSidecarFactory({
       appId: projectDisplayName(project),
       port: parsed.studioPort,

package/dist/dev-runner/node-restart-runner.d.ts

@@ -19,6 +19,11 @@ type RestartSignalTarget = {
 type RestartWatcherFactory = (target: string, optionsOrListener: {
     recursive: boolean;
 } | ((event: string, filename: string | Buffer | null) => void), listener?: (event: string, filename: string | Buffer | null) => void) => FSWatcher;
+type RestartSchedulerHandle = ReturnType<typeof setTimeout> | number;
+type RestartScheduler = {
+    clear(handle: RestartSchedulerHandle): void;
+    set(callback: () => void, delayMs: number): RestartSchedulerHandle;
+};
 type ContentChangeGate = {
     commitBaseline(paths: Iterable<string>): void;
     hasMeaningfulChange(paths: Iterable<string>): boolean;
@@ -33,6 +38,7 @@ export type NodeRestartRunnerOptions = {
     signalTarget?: RestartSignalTarget;
     spawnChild?: RestartChildSpawner;
     stderr?: RestartRunnerStream;
+    restartScheduler?: RestartScheduler;
     stdout?: RestartRunnerStream;
     watchTarget?: RestartWatcherFactory;
 };

package/dist/dev-runner/node-restart-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-restart-runner.d.ts","sourceRoot":"","sources":["../../src/dev-runner/node-restart-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAA0D,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAKjG,KAAK,mBAAmB,GAAG;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,mBAAmB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,KAAK,YAAY,CAAC;AACjJ,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9E,KAAK,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1C,KAAK,mBAAmB,GAAG;IACzB,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IAC1D,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CAC5D,CAAC;AAEF,KAAK,qBAAqB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,KAAK,SAAS,CAAC;AAE1O,KAAK,iBAAiB,GAAG;IACvB,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;CACvD,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACrC,CAAC;AA6NF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,EAAE,cAAc,GAAE,MAAM,EAAoB,GAAG,iBAAiB,CAuB/H;AAkFD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmP7F"}
+{"version":3,"file":"node-restart-runner.d.ts","sourceRoot":"","sources":["../../src/dev-runner/node-restart-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAA0D,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAKjG,KAAK,mBAAmB,GAAG;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,mBAAmB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,KAAK,YAAY,CAAC;AACjJ,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9E,KAAK,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1C,KAAK,mBAAmB,GAAG;IACzB,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IAC1D,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CAC5D,CAAC;AAEF,KAAK,qBAAqB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,KAAK,SAAS,CAAC;AAE1O,KAAK,sBAAsB,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,MAAM,CAAC;AAErE,KAAK,gBAAgB,GAAG;IACtB,KAAK,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC5C,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,sBAAsB,CAAC;CACpE,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;CACvD,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACrC,CAAC;AA6NF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,EAAE,cAAc,GAAE,MAAM,EAAoB,GAAG,iBAAiB,CAuB/H;AAkFD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoP7F"}

package/dist/dev-runner/node-restart-runner.js

@@ -100,7 +100,7 @@ function parseIgnorePatterns(env) {
   return normalizeIgnorePatterns([...DEFAULT_IGNORES, ...configured]);
 }
 function matchesSegmentPattern(segment, pattern) {
-  if (pattern.startsWith('*.')) {
+  if (pattern.startsWith('*')) {
     return segment.endsWith(pattern.slice(1));
   }
   if (pattern.endsWith('*')) {
@@ -293,6 +293,10 @@ export async function runNodeRestartRunner(options) {
   const spawnChild = options.spawnChild ?? spawn;
   const stdout = options.stdout ?? process.stdout;
   const stderr = options.stderr ?? process.stderr;
+  const restartScheduler = options.restartScheduler ?? {
+    clear: clearTimeout,
+    set: setTimeout
+  };
   const watchTarget = options.watchTarget ?? watch;
   const appArgs = options.appArgs ?? [];
   const debounceMs = options.debounceMs ?? Number(env.FLUO_DEV_RELOAD_DEBOUNCE_MS ?? DEFAULT_DEBOUNCE_MS);
@@ -358,10 +362,10 @@ export async function runNodeRestartRunner(options) {
   };
   const scheduleRestart = (filePath, resolveExitCode, cleanup) => {
     pendingRestartPaths.add(filePath);
-    if (restartTimer) {
-      clearTimeout(restartTimer);
+    if (restartTimer !== undefined) {
+      restartScheduler.clear(restartTimer);
     }
-    restartTimer = setTimeout(() => {
+    restartTimer = restartScheduler.set(() => {
       const restartPaths = [...pendingRestartPaths];
       pendingRestartPaths.clear();
       restartTimer = undefined;
@@ -445,8 +449,8 @@ export async function runNodeRestartRunner(options) {
         return;
       }
       cleanedUp = true;
-      if (restartTimer) {
-        clearTimeout(restartTimer);
+      if (restartTimer !== undefined) {
+        restartScheduler.clear(restartTimer);
         restartTimer = undefined;
       }
       pendingRestartPaths.clear();

package/dist/generate-command.d.ts

@@ -0,0 +1,50 @@
+import type { GeneratorManifestEntry } from './generators/manifest.js';
+import type { GenerateOptions, GeneratorKind } from './types.js';
+/** Describes how one generated artifact would interact with the workspace. */
+export type GeneratePlanAction = 'create' | 'module-create' | 'module-unchanged' | 'module-update' | 'overwrite' | 'skip' | 'unchanged';
+/** One path-level action reported by generate dry-run previews and structured results. */
+export type GeneratePlanEntry = {
+    /** Planned action for this path. */
+    action: GeneratePlanAction;
+    /** Absolute path affected by the plan entry. */
+    path: string;
+};
+/**
+ * Structured result returned by {@link runGenerateCommand} for tooling-friendly automation.
+ *
+ * `generatedFiles` only includes files whose on-disk content changed during the command.
+ * `moduleRegistered` reports whether the target schematic participates in automatic module wiring,
+ * even when the target module file was already up to date.
+ */
+export type GenerateResult = {
+    generatedFiles: string[];
+    moduleRegistered: boolean;
+    modulePath: string | undefined;
+    nextStepHint: string;
+    plannedFiles: GeneratePlanEntry[];
+    wiringBehavior: GeneratorManifestEntry['wiringBehavior'];
+};
+/**
+ * Generates one CLI schematic into a source directory and returns structured wiring metadata.
+ *
+ * The command keeps generation idempotent where possible: unchanged files are not rewritten, and
+ * auto-registered schematics reuse an existing module file when it already contains the required import
+ * and registration entry.
+ *
+ * @example
+ * ```ts
+ * const result = runGenerateCommand('service', 'Post', './src');
+ *
+ * console.log(result.wiringBehavior);
+ * console.log(result.nextStepHint);
+ * ```
+ *
+ * @param kind Generator kind to execute.
+ * @param name Resource name supplied by the caller before normalization.
+ * @param baseDirectory Source directory that should receive the generated domain folder.
+ * @param options Optional generation flags that control overwrites, request DTO feature placement, and sibling-aware templates.
+ * @returns Structured file and wiring metadata for the completed generation run.
+ * @throws {Error} When the resource name is invalid, the generator kind is unknown, or the target module source cannot be updated safely.
+ */
+export declare function runGenerateCommand(kind: GeneratorKind, name: string, baseDirectory: string, options?: GenerateOptions): GenerateResult;
+//# sourceMappingURL=generate-command.d.ts.map

package/dist/generate-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-command.d.ts","sourceRoot":"","sources":["../src/generate-command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAkB,MAAM,0BAA0B,CAAC;AAIvF,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAWjE,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,eAAe,GAAG,kBAAkB,GAAG,eAAe,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAExI,0FAA0F;AAC1F,MAAM,MAAM,iBAAiB,GAAG;IAC9B,oCAAoC;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAyIF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,cAAc,EAAE,sBAAsB,CAAC,gBAAgB,CAAC,CAAC;CAC1D,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc,CAgE1I"}

package/dist/generate-command.js

@@ -0,0 +1,214 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join, normalize, relative, resolve, sep } from 'node:path';
+import { findGeneratorDefinition } from './generators/manifest.js';
+import { ensureModuleImport, generateModuleFiles, registerInModule } from './generators/module.js';
+import { toKebabCase, toPascalCase, toPlural } from './generators/utils.js';
+function writeFileIfChanged(filePath, content) {
+  if (existsSync(filePath) && readFileSync(filePath, 'utf8') === content) {
+    return false;
+  }
+  writeFileSync(filePath, content, 'utf8');
+  return true;
+}
+
+/** Describes how one generated artifact would interact with the workspace. */
+
+/** One path-level action reported by generate dry-run previews and structured results. */
+
+function planFileWrite(filePath, content, options) {
+  if (!existsSync(filePath)) {
+    return {
+      action: 'create',
+      path: filePath
+    };
+  }
+  if (!options.force) {
+    return {
+      action: 'skip',
+      path: filePath
+    };
+  }
+  if (readFileSync(filePath, 'utf8') === content) {
+    return {
+      action: 'unchanged',
+      path: filePath
+    };
+  }
+  return {
+    action: 'overwrite',
+    path: filePath
+  };
+}
+function planModuleWrite(modulePath, content) {
+  if (!existsSync(modulePath)) {
+    return {
+      action: 'module-create',
+      path: modulePath
+    };
+  }
+  if (readFileSync(modulePath, 'utf8') === content) {
+    return {
+      action: 'module-unchanged',
+      path: modulePath
+    };
+  }
+  return {
+    action: 'module-update',
+    path: modulePath
+  };
+}
+function createGeneratorOptions(kind, domainDirectory, kebab, options, resolvedBase) {
+  return {
+    ...options,
+    e2eRootModuleImport: options.e2eRootModuleImport ?? (kind === 'e2e' ? resolveE2eRootModuleImport(domainDirectory, resolvedBase) : undefined),
+    hasRepo: options.hasRepo ?? (kind === 'service' ? existsSync(join(domainDirectory, `${kebab}.repo.ts`)) : undefined),
+    hasService: options.hasService ?? (kind === 'controller' ? existsSync(join(domainDirectory, `${kebab}.service.ts`)) : undefined)
+  };
+}
+function toImportSpecifier(path) {
+  const normalized = path.split(sep).join('/');
+  return normalized.startsWith('.') ? normalized : `./${normalized}`;
+}
+function resolveE2eRootModuleImport(domainDirectory, resolvedBase) {
+  return toImportSpecifier(relative(domainDirectory, join(resolvedBase, 'app')));
+}
+function resolveDomainDirectory(kind, resolvedBase, kebab, options) {
+  if (kind === 'e2e') {
+    return basename(resolvedBase) === 'src' ? join(dirname(resolvedBase), 'test') : join(resolvedBase, 'test');
+  }
+  if (kind === 'request-dto' && options.targetFeature !== undefined) {
+    const normalizedFeature = options.targetFeature.trim();
+    const featureKebab = assertValidResourceName(normalizedFeature);
+    const featureDirectory = /^[A-Z]/u.test(normalizedFeature) ? toPlural(featureKebab) : featureKebab;
+    return join(resolvedBase, featureDirectory);
+  }
+  return join(resolvedBase, toPlural(kebab));
+}
+function assertValidResourceName(name) {
+  const kebab = toKebabCase(name);
+  if (name.trim().length === 0) {
+    throw new Error('Invalid resource name: name must not be empty.');
+  }
+  if (kebab !== normalize(kebab) || kebab.includes('/') || kebab.includes('\\') || kebab.includes('..')) {
+    throw new Error(`Invalid resource name "${name}": must not contain path separators or traversal sequences.`);
+  }
+  if (!/^[a-z0-9][a-z0-9-]*$/.test(kebab)) {
+    throw new Error(`Invalid resource name "${name}": use letters, numbers, spaces, underscores, or hyphens only.`);
+  }
+  return kebab;
+}
+function resolveModulePath(domainDirectory, name) {
+  const kebab = toKebabCase(name);
+  return join(domainDirectory, `${kebab}.module.ts`);
+}
+function readOrCreateModuleSource(modulePath, name) {
+  if (existsSync(modulePath)) {
+    return readFileSync(modulePath, 'utf8');
+  }
+  const [moduleFile] = generateModuleFiles(name);
+  if (!moduleFile) {
+    throw new Error(`Unable to generate module file for resource "${name}".`);
+  }
+  return moduleFile.content;
+}
+function buildUpdatedModuleSource(moduleSource, arrayKey, className, importPath) {
+  let source = moduleSource;
+  source = ensureModuleImport(source, className, importPath);
+  source = registerInModule(source, arrayKey, className);
+  return source;
+}
+function prepareModuleUpdate(domainDirectory, normalizedName, kind, classSuffix, arrayKey) {
+  const kebab = toKebabCase(normalizedName);
+  const modulePath = resolveModulePath(domainDirectory, normalizedName);
+  const className = `${toPascalCase(normalizedName)}${classSuffix}`;
+  const importPath = `${kebab}.${kind}`;
+  const moduleSource = readOrCreateModuleSource(modulePath, normalizedName);
+  return {
+    modulePath,
+    source: buildUpdatedModuleSource(moduleSource, arrayKey, className, importPath)
+  };
+}
+
+/**
+ * Structured result returned by {@link runGenerateCommand} for tooling-friendly automation.
+ *
+ * `generatedFiles` only includes files whose on-disk content changed during the command.
+ * `moduleRegistered` reports whether the target schematic participates in automatic module wiring,
+ * even when the target module file was already up to date.
+ */
+
+/**
+ * Generates one CLI schematic into a source directory and returns structured wiring metadata.
+ *
+ * The command keeps generation idempotent where possible: unchanged files are not rewritten, and
+ * auto-registered schematics reuse an existing module file when it already contains the required import
+ * and registration entry.
+ *
+ * @example
+ * ```ts
+ * const result = runGenerateCommand('service', 'Post', './src');
+ *
+ * console.log(result.wiringBehavior);
+ * console.log(result.nextStepHint);
+ * ```
+ *
+ * @param kind Generator kind to execute.
+ * @param name Resource name supplied by the caller before normalization.
+ * @param baseDirectory Source directory that should receive the generated domain folder.
+ * @param options Optional generation flags that control overwrites, request DTO feature placement, and sibling-aware templates.
+ * @returns Structured file and wiring metadata for the completed generation run.
+ * @throws {Error} When the resource name is invalid, the generator kind is unknown, or the target module source cannot be updated safely.
+ */
+export function runGenerateCommand(kind, name, baseDirectory, options = {}) {
+  const normalizedName = name.trim();
+  const kebab = assertValidResourceName(normalizedName);
+  const generator = findGeneratorDefinition(kind);
+  const resolvedBase = resolve(baseDirectory);
+  const domainDirectory = resolveDomainDirectory(kind, resolvedBase, kebab, options);
+  const generatorOptions = createGeneratorOptions(kind, domainDirectory, kebab, options, resolvedBase);
+  const files = generator.factory(normalizedName, generatorOptions);
+  const moduleRegistration = 'moduleRegistration' in generator ? generator.moduleRegistration : undefined;
+  const moduleUpdate = moduleRegistration ? prepareModuleUpdate(domainDirectory, normalizedName, kind, moduleRegistration.classSuffix, moduleRegistration.arrayKey) : undefined;
+  const plannedFiles = files.map(file => planFileWrite(join(domainDirectory, file.path), file.content, options));
+  const modulePlan = moduleUpdate ? planModuleWrite(moduleUpdate.modulePath, moduleUpdate.source) : undefined;
+  if (options.dryRun) {
+    return {
+      generatedFiles: [],
+      moduleRegistered: moduleUpdate !== undefined,
+      modulePath: moduleUpdate?.modulePath,
+      nextStepHint: generator.nextStepHint,
+      plannedFiles: modulePlan ? [...plannedFiles, modulePlan] : plannedFiles,
+      wiringBehavior: generator.wiringBehavior
+    };
+  }
+  mkdirSync(domainDirectory, {
+    recursive: true
+  });
+  const writtenPaths = files.map(file => {
+    const filePath = join(domainDirectory, file.path);
+    if (!options.force && existsSync(filePath)) {
+      return null;
+    }
+    return writeFileIfChanged(filePath, file.content) ? filePath : null;
+  }).filter(filePath => filePath !== null);
+  let moduleRegistered = false;
+  let resolvedModulePath;
+  if (moduleUpdate && writeFileIfChanged(moduleUpdate.modulePath, moduleUpdate.source)) {
+    moduleRegistered = true;
+    resolvedModulePath = moduleUpdate.modulePath;
+    if (!writtenPaths.includes(moduleUpdate.modulePath)) {
+      writtenPaths.push(moduleUpdate.modulePath);
+    }
+  } else if (moduleUpdate) {
+    moduleRegistered = true;
+    resolvedModulePath = moduleUpdate.modulePath;
+  }
+  return {
+    generatedFiles: writtenPaths,
+    moduleRegistered: moduleRegistered,
+    modulePath: resolvedModulePath,
+    nextStepHint: generator.nextStepHint,
+    plannedFiles: modulePlan ? [...plannedFiles, modulePlan] : plannedFiles,
+    wiringBehavior: generator.wiringBehavior
+  };
+}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { runCli, type CliRuntimeOptions } from './run-cli.js';
-export { runGenerateCommand, type GeneratePlanAction, type GeneratePlanEntry, type GenerateResult } from './commands/generate.js';
-export { inspectUsage, runInspectCommand, type InspectCommandRuntimeOptions } from './commands/inspect.js';
-export { newUsage, runNewCommand, type NewCommandRuntimeOptions } from './commands/new.js';
+export { runGenerateCommand, type GeneratePlanAction, type GeneratePlanEntry, type GenerateResult } from './public-generate.js';
+export { inspectUsage, runInspectCommand, type InspectCommandRuntimeOptions } from './public-inspect.js';
+export { newUsage, runNewCommand, type NewCommandRuntimeOptions } from './public-new.js';
 export { CliPromptCancelledError } from './prompt-cancel.js';
 export type { GenerateOptions, GeneratedFile, GeneratorKind, ModuleRegistration } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAClI,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,KAAK,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC3G,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAChI,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,KAAK,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACzG,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 export { runCli } from './run-cli.js';
-export { runGenerateCommand } from './commands/generate.js';
-export { inspectUsage, runInspectCommand } from './commands/inspect.js';
-export { newUsage, runNewCommand } from './commands/new.js';
+export { runGenerateCommand } from './public-generate.js';
+export { inspectUsage, runInspectCommand } from './public-inspect.js';
+export { newUsage, runNewCommand } from './public-new.js';
 export { CliPromptCancelledError } from './prompt-cancel.js';

package/dist/new/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/new/scaffold.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AA8xEnE;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,aAAa,SAAkB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,6BAAuB,CAAC"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../src/new/scaffold.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,YAAY,CAAC;AA03EnE;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,aAAa,SAAkB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,6BAAuB,CAAC"}