@fluojs/cli 1.0.6 → 2.0.1

package/dist/commands/new.d.ts

@@ -17,12 +17,6 @@ export interface NewCommandRuntimeOptions extends NewCommandOptions {
     stdout?: CliStream;
     userAgent?: string;
 }
-/**
- * Renders CLI help text for `fluo new`.
- *
- * @returns Stable help output for the scaffolding command.
- */
-export declare function newUsage(): string;
 /**
  * Executes `fluo new` with parsed arguments and scaffold options.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AAOA,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAWnF,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE3E,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAuBF;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA0UD;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CA0BjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,MAAM,CAAC,CA4G3G"}
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../src/commands/new.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,iBAAiB,EAA2B,MAAM,kBAAkB,CAAC;AAWnF,OAAO,KAAK,EAAsC,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAI7F,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAiCF;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,iBAAiB;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiPD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,MAAM,CAAC,CA6G3G"}

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;AAulB/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',
@@ -390,7 +395,7 @@ function projectRuntimeToStudioRuntime(runtime) {
 function projectDisplayName(project) {
   return typeof project.manifest.name === 'string' && project.manifest.name.length > 0 ? project.manifest.name : project.directory.split(/[\\/]/).filter(Boolean).at(-1) ?? 'fluo-app';
 }
-function assertStudioSupport(command, studio, projectRuntime, _devRunner) {
+function assertStudioSupport(command, studio, projectRuntime, devRunner, rawWatch) {
   if (!studio) {
     return;
   }
@@ -400,8 +405,12 @@ function assertStudioSupport(command, studio, projectRuntime, _devRunner) {
   if (projectRuntime !== 'node') {
     throw new Error(`fluo dev --studio currently supports Node dev runner projects only. ${projectRuntime} Studio support remains experimental until a dedicated bridge is implemented and verified.`);
   }
+  if (devRunner !== 'fluo' || rawWatch) {
+    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',
@@ -409,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) {
@@ -619,7 +628,7 @@ export async function runScriptCommand(command, argv, runtime = {}) {
     throw new Error('--runner is only supported for fluo dev. Use -- to forward --runner to the child command.');
   }
   const devRunner = command === 'dev' ? resolveDevRunnerPreference(parsed, env, projectRuntime) : 'fluo';
-  assertStudioSupport(command, parsed.studio, projectRuntime, devRunner);
+  assertStudioSupport(command, parsed.studio, projectRuntime, devRunner, rawWatch);
   const runnerSteps = buildProjectRunner(command, projectRuntime, parsed.passThrough, {
     devRunner,
     rawWatch
@@ -632,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;AA2LF;;;;;;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,CAiP7F"}
+{"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

@@ -1,5 +1,5 @@
 import { spawn } from 'node:child_process';
-import { createHash } from 'node:crypto';
+import { createHash, randomUUID } from 'node:crypto';
 import { existsSync, readdirSync, readFileSync, statSync, watch } from 'node:fs';
 import { basename, dirname, join, relative, sep } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -16,6 +16,7 @@ const DEFAULT_IGNORES = ['.cache', '.fluo', '.git', '.turbo', 'coverage', 'dist'
 const WATCH_FILES = ['.env', 'package.json', 'tsconfig.json', 'tsconfig.build.json'];
 const SHOW_NODE_RESTART_NOTICE_ENV = 'FLUO_DEV_SHOW_RESTART_NOTICE';
 const CLEAR_SCREEN = '\u001B[2J\u001B[3J\u001B[H';
+const STUDIO_EPOCH_ENV = 'FLUO_STUDIO_EPOCH';
 function isEnabledEnvironmentFlag(value) {
   return value === '1' || value === 'true' || value === 'yes';
 }
@@ -41,6 +42,34 @@ function resolveStudioIngestEndpoint(env) {
     return undefined;
   }
 }
+function hasStudioDevtoolsConfig(env) {
+  return isEnabledEnvironmentFlag(env.FLUO_STUDIO) && Boolean(env.FLUO_STUDIO_TOKEN);
+}
+function createStudioEpoch() {
+  return randomUUID();
+}
+function ensureStudioEpoch(env) {
+  if (!hasStudioDevtoolsConfig(env)) {
+    return undefined;
+  }
+  env[STUDIO_EPOCH_ENV] ??= createStudioEpoch();
+  return env[STUDIO_EPOCH_ENV];
+}
+function advanceStudioEpoch(env) {
+  if (!hasStudioDevtoolsConfig(env)) {
+    return undefined;
+  }
+  const epoch = createStudioEpoch();
+  env[STUDIO_EPOCH_ENV] = epoch;
+  return epoch;
+}
+function withStudioEpoch(env, payload) {
+  const epoch = ensureStudioEpoch(env);
+  return epoch ? {
+    ...payload,
+    epoch
+  } : payload;
+}
 function publishStudioLifecycleEvent(env, runtime, type, payload) {
   const endpoint = resolveStudioIngestEndpoint(env);
   if (!endpoint || typeof globalThis.fetch !== 'function') {
@@ -48,7 +77,7 @@ function publishStudioLifecycleEvent(env, runtime, type, payload) {
   }
   void globalThis.fetch(endpoint, {
     body: JSON.stringify({
-      payload,
+      payload: withStudioEpoch(env, payload),
       source: {
         appId: env.FLUO_STUDIO_APP_ID ?? basename(process.cwd()),
         runtime: studioRuntimeName(runtime)
@@ -71,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('*')) {
@@ -264,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);
@@ -278,6 +311,7 @@ export async function runNodeRestartRunner(options) {
   let restarting = false;
   let stopping = false;
   const startChild = (resolveExitCode, cleanup) => {
+    ensureStudioEpoch(env);
     const appCommand = buildAppCommand(runnerRuntime, env, appArgs);
     publishStudioLifecycleEvent(env, runnerRuntime, 'restart', {
       phase: 'starting',
@@ -328,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;
@@ -341,6 +375,7 @@ export async function runNodeRestartRunner(options) {
       if (env[SHOW_NODE_RESTART_NOTICE_ENV] === '1') {
         stdout.write(`[fluo] restarting after content change: ${relative(projectDirectory, restartPaths[restartPaths.length - 1] ?? projectDirectory)}\n`);
       }
+      advanceStudioEpoch(env);
       publishStudioLifecycleEvent(env, runnerRuntime, 'restart', {
         phase: 'scheduled',
         reason: `content changed: ${relative(projectDirectory, restartPaths[restartPaths.length - 1] ?? projectDirectory)}`
@@ -414,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"}