@fluojs/cli 1.0.6 → 2.0.1

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,5 +1,7 @@
-export { runCli, type CliRuntimeOptions } from './cli.js';
-export { newUsage, runNewCommand, type NewCommandRuntimeOptions } from './commands/new.js';
+export { runCli, type CliRuntimeOptions } from './run-cli.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,UAAU,CAAC;AAC1D,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,3 +1,5 @@
-export { runCli } from './cli.js';
-export { newUsage, runNewCommand } from './commands/new.js';
+export { runCli } from './run-cli.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"}

package/dist/new/scaffold.js

@@ -1050,13 +1050,36 @@ const codec = JSONCodec();
 
 class LazyNatsTransport implements MicroserviceTransport {
   private connection: NatsConnection | undefined;
+  private initializing: Promise<NatsMicroserviceTransport> | undefined;
   private transport: NatsMicroserviceTransport | undefined;
 
   async close() {
-    await this.transport?.close();
-    await this.connection?.close();
-    this.transport = undefined;
-    this.connection = undefined;
+    const transport = this.initializing ? await this.initializing.catch(() => undefined) : this.transport;
+    let closeError: unknown;
+    let closeFailed = false;
+    try {
+      await transport?.close();
+    } catch (error) {
+      closeError = error;
+      closeFailed = true;
+    } finally {
+      try {
+        await this.connection?.close();
+      } catch (error) {
+        if (!closeFailed) {
+          closeError = error;
+          closeFailed = true;
+        }
+      } finally {
+        this.initializing = undefined;
+        this.transport = undefined;
+        this.connection = undefined;
+      }
+    }
+
+    if (closeFailed) {
+      throw closeError;
+    }
   }
 
   async emit(pattern: string, payload: unknown) {
@@ -1076,6 +1099,19 @@ class LazyNatsTransport implements MicroserviceTransport {
       return this.transport;
     }
 
+    this.initializing ??= this.createTransport();
+    try {
+      return await this.initializing;
+    } finally {
+      this.initializing = undefined;
+    }
+  }
+
+  private async createTransport() {
+    if (this.transport) {
+      return this.transport;
+    }
+
     const connection = await connect({
       name: 'fluo-microservice-starter',
       servers,
@@ -1149,18 +1185,24 @@ const responseTopic = process.env.KAFKA_RESPONSE_TOPIC ?? 'fluo.microservices.re
 
 class LazyKafkaTransport implements MicroserviceTransport {
   private consumer: Consumer | undefined;
+  private initializing: Promise<KafkaMicroserviceTransport> | undefined;
   private producer: Producer | undefined;
   private transport: KafkaMicroserviceTransport | undefined;
 
   async close() {
-    await this.transport?.close();
-    await Promise.all([
-      this.consumer?.disconnect().catch(() => undefined),
-      this.producer?.disconnect().catch(() => undefined),
-    ]);
-    this.consumer = undefined;
-    this.producer = undefined;
-    this.transport = undefined;
+    const transport = this.initializing ? await this.initializing.catch(() => undefined) : this.transport;
+    try {
+      await transport?.close();
+    } finally {
+      await Promise.all([
+        this.consumer?.disconnect().catch(() => undefined),
+        this.producer?.disconnect().catch(() => undefined),
+      ]);
+      this.initializing = undefined;
+      this.consumer = undefined;
+      this.producer = undefined;
+      this.transport = undefined;
+    }
   }
 
   async emit(pattern: string, payload: unknown) {
@@ -1180,6 +1222,19 @@ class LazyKafkaTransport implements MicroserviceTransport {
       return this.transport;
     }
 
+    this.initializing ??= this.createTransport();
+    try {
+      return await this.initializing;
+    } finally {
+      this.initializing = undefined;
+    }
+  }
+
+  private async createTransport() {
+    if (this.transport) {
+      return this.transport;
+    }
+
     const kafka = new Kafka({
       brokers,
       clientId,
@@ -1187,13 +1242,24 @@ class LazyKafkaTransport implements MicroserviceTransport {
     });
     const producer = kafka.producer();
     const consumer = kafka.consumer({ groupId: consumerGroup });
-    await Promise.all([producer.connect(), consumer.connect()]);
+    this.producer = producer;
+    this.consumer = consumer;
+    try {
+      await producer.connect();
+      await consumer.connect();
+    } catch (error) {
+      await Promise.all([
+        consumer.disconnect().catch(() => undefined),
+        producer.disconnect().catch(() => undefined),
+      ]);
+      this.consumer = undefined;
+      this.producer = undefined;
+      throw error;
+    }
 
     const handlers = new Map<string, (message: string) => Promise<void> | void>();
     let consumerRunning = false;
 
-    this.producer = producer;
-    this.consumer = consumer;
     this.transport = new KafkaMicroserviceTransport({
       consumer: {
         async subscribe(topic: string, handler: (message: string) => Promise<void> | void) {
@@ -1277,15 +1343,21 @@ const responseQueue = process.env.RABBITMQ_RESPONSE_QUEUE ?? 'fluo.microservices
 class LazyRabbitMqTransport implements MicroserviceTransport {
   private channel: Awaited<ReturnType<Awaited<ReturnType<typeof connect>>['createConfirmChannel']>> | undefined;
   private connection: Awaited<ReturnType<typeof connect>> | undefined;
+  private initializing: Promise<RabbitMqMicroserviceTransport> | undefined;
   private transport: RabbitMqMicroserviceTransport | undefined;
 
   async close() {
-    await this.transport?.close();
-    await this.channel?.close().catch(() => undefined);
-    await this.connection?.close().catch(() => undefined);
-    this.channel = undefined;
-    this.connection = undefined;
-    this.transport = undefined;
+    const transport = this.initializing ? await this.initializing.catch(() => undefined) : this.transport;
+    try {
+      await transport?.close();
+    } finally {
+      await this.channel?.close().catch(() => undefined);
+      await this.connection?.close().catch(() => undefined);
+      this.initializing = undefined;
+      this.channel = undefined;
+      this.connection = undefined;
+      this.transport = undefined;
+    }
   }
 
   async emit(pattern: string, payload: unknown) {
@@ -1305,11 +1377,31 @@ class LazyRabbitMqTransport implements MicroserviceTransport {
       return this.transport;
     }
 
+    this.initializing ??= this.createTransport();
+    try {
+      return await this.initializing;
+    } finally {
+      this.initializing = undefined;
+    }
+  }
+
+  private async createTransport() {
+    if (this.transport) {
+      return this.transport;
+    }
+
     const connection = await connect(url);
-    const channel = await connection.createConfirmChannel();
+    this.connection = connection;
+    let channel: Awaited<ReturnType<typeof connection.createConfirmChannel>>;
+    try {
+      channel = await connection.createConfirmChannel();
+    } catch (error) {
+      await connection.close().catch(() => undefined);
+      this.connection = undefined;
+      throw error;
+    }
     const consumerTags = new Map<string, string>();
 
-    this.connection = connection;
     this.channel = channel;
     this.transport = new RabbitMqMicroserviceTransport({
       consumer: {

package/dist/new/types.d.ts

@@ -53,11 +53,9 @@ export interface BootstrapAnswers extends BootstrapSchema {
 }
 /** Programmatic overrides for `runNewCommand(...)`. */
 export interface NewCommandOptions {
-    dependencySource?: DependencySource;
     force?: boolean;
     initializeGit?: boolean;
     installDependencies?: boolean;
-    repoRoot?: string;
     skipInstall?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/new/types.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,CAAC;AACrD,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,CAAC;AACtE,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAC9E,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAClH,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,GAAG,KAAK,CAAC;AACpH,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAEhD,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,gBAAgB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/new/types.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,CAAC;AACrD,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,CAAC;AACtE,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAC9E,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAClH,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,GAAG,KAAK,CAAC;AACpH,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAEhD,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,gBAAgB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/public-generate.d.ts

@@ -0,0 +1,2 @@
+export { type GeneratePlanAction, type GeneratePlanEntry, type GenerateResult, runGenerateCommand } from './generate-command.js';
+//# sourceMappingURL=public-generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"public-generate.d.ts","sourceRoot":"","sources":["../src/public-generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/public-generate.js

@@ -0,0 +1 @@
+export { runGenerateCommand } from './generate-command.js';

package/dist/public-inspect.d.ts

@@ -0,0 +1,13 @@
+import type { InspectCommandRuntimeOptions } from './commands/inspect.js';
+import { inspectUsage } from './usage.js';
+export type { InspectCommandRuntimeOptions } from './commands/inspect.js';
+export { inspectUsage };
+/**
+ * Runs the inspect command through a lazy implementation import.
+ *
+ * @param argv Command arguments after `inspect`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the inspect command.
+ */
+export declare function runInspectCommand(argv: string[], runtime?: InspectCommandRuntimeOptions): Promise<number>;
+//# sourceMappingURL=public-inspect.d.ts.map

package/dist/public-inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-inspect.d.ts","sourceRoot":"","sources":["../src/public-inspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,MAAM,CAAC,CAGnH"}

package/dist/public-inspect.js

@@ -0,0 +1,16 @@
+import { inspectUsage } from './usage.js';
+export { inspectUsage };
+
+/**
+ * Runs the inspect command through a lazy implementation import.
+ *
+ * @param argv Command arguments after `inspect`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the inspect command.
+ */
+export async function runInspectCommand(argv, runtime = {}) {
+  const {
+    runInspectCommand: runInspectCommandImplementation
+  } = await import('./commands/inspect.js');
+  return runInspectCommandImplementation(argv, runtime);
+}

package/dist/public-new.d.ts

@@ -0,0 +1,13 @@
+import type { NewCommandRuntimeOptions } from './commands/new.js';
+import { newUsage } from './usage.js';
+export type { NewCommandRuntimeOptions } from './commands/new.js';
+export { newUsage };
+/**
+ * Runs the new command through a lazy implementation import.
+ *
+ * @param argv Command arguments after `new` or `create`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the new command.
+ */
+export declare function runNewCommand(argv: string[], runtime?: NewCommandRuntimeOptions): Promise<number>;
+//# sourceMappingURL=public-new.d.ts.map

package/dist/public-new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-new.d.ts","sourceRoot":"","sources":["../src/public-new.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3G"}

package/dist/public-new.js

@@ -0,0 +1,16 @@
+import { newUsage } from './usage.js';
+export { newUsage };
+
+/**
+ * Runs the new command through a lazy implementation import.
+ *
+ * @param argv Command arguments after `new` or `create`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the new command.
+ */
+export async function runNewCommand(argv, runtime = {}) {
+  const {
+    runNewCommand: runNewCommandImplementation
+  } = await import('./commands/new.js');
+  return runNewCommandImplementation(argv, runtime);
+}

package/dist/run-cli.d.ts

@@ -0,0 +1,16 @@
+import type { CliRuntimeOptions } from './cli.js';
+import type { InspectCommandRuntimeOptions } from './commands/inspect.js';
+import type { NewCommandRuntimeOptions } from './commands/new.js';
+export type { CliRuntimeOptions } from './cli.js';
+/**
+ * Runs the top-level CLI command dispatcher through a lazy implementation import.
+ *
+ * This keeps the package root embeddable for tools that only need lightweight helpers while preserving
+ * the same `runCli(...)` behavior as the published `fluo` binary when callers execute it.
+ *
+ * @param argv Argument vector to execute. Defaults to the current process arguments inside the dispatcher.
+ * @param runtime Optional runtime overrides shared by the top-level dispatcher and delegated commands.
+ * @returns `0` when the command completes successfully, otherwise the delegated command exit code.
+ */
+export declare function runCli(argv?: string[], runtime?: CliRuntimeOptions & NewCommandRuntimeOptions & InspectCommandRuntimeOptions): Promise<number>;
+//# sourceMappingURL=run-cli.d.ts.map

package/dist/run-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-cli.d.ts","sourceRoot":"","sources":["../src/run-cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAElE,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElD;;;;;;;;;GASG;AACH,wBAAsB,MAAM,CAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,iBAAiB,GAAG,wBAAwB,GAAG,4BAAiC,GACxF,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/dist/run-cli.js

@@ -0,0 +1,16 @@
+/**
+ * Runs the top-level CLI command dispatcher through a lazy implementation import.
+ *
+ * This keeps the package root embeddable for tools that only need lightweight helpers while preserving
+ * the same `runCli(...)` behavior as the published `fluo` binary when callers execute it.
+ *
+ * @param argv Argument vector to execute. Defaults to the current process arguments inside the dispatcher.
+ * @param runtime Optional runtime overrides shared by the top-level dispatcher and delegated commands.
+ * @returns `0` when the command completes successfully, otherwise the delegated command exit code.
+ */
+export async function runCli(argv, runtime = {}) {
+  const {
+    runCli: runCliImplementation
+  } = await import('./cli.js');
+  return runCliImplementation(argv, runtime);
+}

package/dist/studio/sidecar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/studio/sidecar.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAkPD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC,CAiLnG"}
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/studio/sidecar.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA4UD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC,CAyLnG"}