@fluojs/cli 1.0.6 → 2.0.1

package/dist/studio/sidecar.js

@@ -21,16 +21,60 @@ const DEFAULT_HOST = '127.0.0.1';
 const DEFAULT_HEARTBEAT_MS = 15_000;
 const MAX_EVENT_REPLAY = 1_000;
 const MAX_REQUEST_BYTES = 1_048_576;
+const BODY_LIKE_PAYLOAD_FIELDS = new Set(['body', 'headers', 'payload', 'rawBody', 'requestBody', 'responseBody']);
 const require = createRequire(import.meta.url);
 function isRecord(value) {
   return typeof value === 'object' && value !== null;
 }
+function findBodyLikePayloadField(value, path = 'payload') {
+  if (Array.isArray(value)) {
+    for (const [index, item] of value.entries()) {
+      const match = findBodyLikePayloadField(item, `${path}[${String(index)}]`);
+      if (match) {
+        return match;
+      }
+    }
+    return undefined;
+  }
+  if (!isRecord(value)) {
+    return undefined;
+  }
+  for (const [key, nestedValue] of Object.entries(value)) {
+    const nestedPath = `${path}.${key}`;
+    if (BODY_LIKE_PAYLOAD_FIELDS.has(key)) {
+      return nestedPath;
+    }
+    const match = findBodyLikePayloadField(nestedValue, nestedPath);
+    if (match) {
+      return match;
+    }
+  }
+  return undefined;
+}
 function isRestartEpochBoundary(incoming) {
   if (incoming.type !== 'restart' || !isRecord(incoming.payload)) {
     return false;
   }
   return incoming.payload.phase === 'scheduled' || incoming.payload.phase === 'starting';
 }
+function resolveRestartEpoch(incoming) {
+  if (!isRestartEpochBoundary(incoming)) {
+    return undefined;
+  }
+  const payload = isRecord(incoming.payload) ? incoming.payload : undefined;
+  const requestedEpoch = payload?.epoch;
+  return typeof requestedEpoch === 'string' && requestedEpoch.length > 0 ? requestedEpoch : createEpoch();
+}
+function createStudioSidecarEnv(options) {
+  return {
+    FLUO_STUDIO: '1',
+    FLUO_STUDIO_APP_ID: options.appId,
+    FLUO_STUDIO_EPOCH: options.epoch,
+    FLUO_STUDIO_RUNTIME: options.runtime,
+    FLUO_STUDIO_TOKEN: options.token,
+    FLUO_STUDIO_URL: options.url
+  };
+}
 function createToken() {
   return randomBytes(24).toString('base64url');
 }
@@ -42,20 +86,53 @@ function createDefaultAppId() {
 }
 function readBody(request) {
   return new Promise((resolve, reject) => {
+    let settled = false;
     let body = '';
     request.setEncoding('utf8');
-    request.on('data', chunk => {
+    const settle = (action, value) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      request.off('data', onData);
+      request.off('end', onEnd);
+      request.off('error', onError);
+      request.off('close', onClose);
+      if (action === 'resolve') {
+        resolve(value);
+      } else {
+        reject(value);
+      }
+    };
+    const onData = chunk => {
       body += chunk;
       if (body.length > MAX_REQUEST_BYTES) {
-        reject(new Error('Studio event payload is too large.'));
+        settle('reject', new Error('Studio event payload is too large.'));
         request.destroy();
       }
-    });
-    request.on('end', () => resolve(body));
-    request.on('error', reject);
+    };
+    const onEnd = () => settle('resolve', body);
+    const onError = error => settle('reject', error);
+    // A client that closes the socket after sending only a partial request body
+    // may never emit `end` or `error`. Bind `close` to body-reader cancellation
+    // so the sidecar cannot hang on a malformed local client indefinitely.
+    const onClose = () => {
+      if (body.length === 0) {
+        settle('reject', new Error('Studio sidecar request closed before any body was received.'));
+        return;
+      }
+      settle('reject', new Error('Studio sidecar request closed before the full body was received.'));
+    };
+    request.on('data', onData);
+    request.on('end', onEnd);
+    request.on('error', onError);
+    request.on('close', onClose);
   });
 }
 function writeJson(response, statusCode, payload) {
+  if (response.writableEnded) {
+    return;
+  }
   response.writeHead(statusCode, {
     'cache-control': 'no-store',
     'content-type': 'application/json; charset=utf-8'
@@ -222,8 +299,9 @@ export async function startStudioSidecar(options = {}) {
   let sequence = 0;
   const startedAt = performance.now();
   const publish = incoming => {
-    if (isRestartEpochBoundary(incoming)) {
-      epoch = createEpoch();
+    const restartEpoch = resolveRestartEpoch(incoming);
+    if (restartEpoch) {
+      epoch = restartEpoch;
     }
     sequence += 1;
     const source = isRecord(incoming.source) ? incoming.source : undefined;
@@ -316,6 +394,13 @@ export async function startStudioSidecar(options = {}) {
           });
           return;
         }
+        const bodyLikeField = findBodyLikePayloadField(parsed.payload);
+        if (bodyLikeField) {
+          writeJson(response, 400, {
+            error: `Studio runtime event payload must not include body-like field ${bodyLikeField}.`
+          });
+          return;
+        }
         const event = publish(parsed);
         writeJson(response, 202, {
           accepted: true,
@@ -333,6 +418,19 @@ export async function startStudioSidecar(options = {}) {
       error: 'Unknown Studio sidecar route.'
     });
   });
+  await new Promise((resolve, reject) => {
+    server.once('error', reject);
+    server.listen(options.port ?? 0, host, () => {
+      server.off('error', reject);
+      resolve();
+    });
+  });
+  const address = server.address();
+  if (!address || typeof address === 'string') {
+    await closeServer(server, clients, undefined);
+    throw new Error('Failed to resolve Studio sidecar address.');
+  }
+  const url = `http://${host}:${String(address.port)}`;
   const heartbeat = options.heartbeatMs === 0 ? undefined : setInterval(() => {
     publish({
       payload: {
@@ -346,31 +444,19 @@ export async function startStudioSidecar(options = {}) {
     });
   }, options.heartbeatMs ?? DEFAULT_HEARTBEAT_MS);
   heartbeat?.unref();
-  await new Promise((resolve, reject) => {
-    server.once('error', reject);
-    server.listen(options.port ?? 0, host, () => {
-      server.off('error', reject);
-      resolve();
-    });
-  });
-  const address = server.address();
-  if (!address || typeof address === 'string') {
-    await closeServer(server, clients, heartbeat);
-    throw new Error('Failed to resolve Studio sidecar address.');
-  }
-  const url = `http://${host}:${String(address.port)}`;
   return {
     appId,
     get epoch() {
       return epoch;
     },
-    env: {
-      FLUO_STUDIO: '1',
-      FLUO_STUDIO_APP_ID: appId,
-      FLUO_STUDIO_EPOCH: epoch,
-      FLUO_STUDIO_RUNTIME: runtime,
-      FLUO_STUDIO_TOKEN: token,
-      FLUO_STUDIO_URL: url
+    get env() {
+      return createStudioSidecarEnv({
+        appId,
+        epoch,
+        runtime,
+        token,
+        url
+      });
     },
     host,
     port: address.port,

package/dist/types.d.ts

@@ -4,9 +4,14 @@ export type { GenerateOptions, GeneratedFile } from './generator-types.js';
 export type GeneratorKind = ManifestGeneratorKind;
 /**
  * Minimal registration metadata used by tests and helper utilities that reason about module wiring.
+ *
+ * @remarks Middleware registrations target the module `middleware` array; controllers and providers
+ * target their matching module metadata arrays.
  */
 export interface ModuleRegistration {
+    /** Class name inserted into the target module metadata array. */
     className: string;
-    kind: 'controller' | 'provider';
+    /** Module metadata kind used by the generated class. */
+    kind: 'controller' | 'provider' | 'middleware';
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEvF,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE3E,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC;CACjC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEvF,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE3E,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,YAAY,CAAC;CAChD"}

package/dist/update-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAOA,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAcF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IACE,MAAM,EAAE,UAAU,CAAC;CACpB,GACD;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1E,cAAc,CAAC,EAAE,CAAC,cAAc,EAAE,oBAAoB,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1G,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAycD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAcnG;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmEjI"}
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAQA,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAcF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IACE,MAAM,EAAE,UAAU,CAAC;CACpB,GACD;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1E,cAAc,CAAC,EAAE,CAAC,cAAc,EAAE,oBAAoB,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1G,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAieD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,CAcnG;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAmEjI"}

package/dist/update-check.js

@@ -35,6 +35,20 @@ const UPDATE_PACKAGE_MANAGERS = new Set(['bun', 'npm', 'pnpm', 'yarn']);
 function isRecord(value) {
   return typeof value === 'object' && value !== null;
 }
+function isReadableStream(value) {
+  if (!value || !isRecord(value)) {
+    return false;
+  }
+  const candidate = value;
+  return typeof candidate.on === 'function' && typeof candidate.pause === 'function' && typeof candidate.resume === 'function';
+}
+function isWritableStream(value) {
+  if (!value || !isRecord(value)) {
+    return false;
+  }
+  const candidate = value;
+  return typeof candidate.write === 'function' && typeof candidate.on === 'function' && typeof candidate.once === 'function' && typeof candidate.emit === 'function' && typeof candidate.removeListener === 'function';
+}
 function isTruthyEnvValue(value) {
   if (!value) {
     return false;
@@ -325,11 +339,11 @@ function resolveInstallCommand(packageName, latestVersion, packageManager) {
     display: `npm install -g ${packageSpecifier}`
   };
 }
-async function defaultPromptConfirm(message, defaultValue) {
+async function defaultPromptConfirm(message, defaultValue, io = {}) {
   const promptSuffix = defaultValue ? 'Y/n' : 'y/N';
   const readline = createInterface({
-    input: process.stdin,
-    output: process.stdout
+    input: isReadableStream(io.stdin) ? io.stdin : process.stdin,
+    output: isWritableStream(io.stdout) ? io.stdout : process.stdout
   });
   try {
     const answer = (await readline.question(`${message} (${promptSuffix}) `)).trim().toLowerCase();
@@ -439,7 +453,10 @@ export async function runCliUpdateCheck(argv, options = {}) {
   }
   stderr.write(`A newer ${packageName} version is available: ${currentVersion} -> ${latestVersion}.\n`);
   const prompt = options.prompt ?? {
-    confirm: defaultPromptConfirm
+    confirm: (message, defaultValue) => defaultPromptConfirm(message, defaultValue, {
+      stdin: options.stdin,
+      stdout
+    })
   };
   const shouldInstall = await prompt.confirm(`Install ${packageName}@${latestVersion} now and restart this command?`, false);
   if (!shouldInstall) {

package/dist/usage.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Renders CLI help text for `fluo new` without importing the scaffold implementation.
+ *
+ * @returns Stable help output for the scaffolding command.
+ */
+export declare function newUsage(): string;
+/**
+ * Returns the usage information string for the inspect command without importing runtime inspection logic.
+ *
+ * @returns Formatted help text including usage and options.
+ */
+export declare function inspectUsage(): string;
+//# sourceMappingURL=usage.d.ts.map

package/dist/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAiIA;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CA0BjC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAarC"}

package/dist/usage.js

@@ -0,0 +1,131 @@
+import { renderAliasList, renderHelpTable } from './help.js';
+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 INSPECT_OPTION_HELP = [{
+  aliases: [],
+  description: 'Emit the runtime platform snapshot/diagnostics payload as JSON (default when no output mode is selected).',
+  option: '--json'
+}, {
+  aliases: [],
+  description: 'Emit a Mermaid graph through the optional @fluojs/studio rendering contract.',
+  option: '--mermaid'
+}, {
+  aliases: [],
+  description: 'Include bootstrap timing diagnostics next to JSON inspect output.',
+  option: '--timing'
+}, {
+  aliases: [],
+  description: 'Emit a CI-friendly JSON report with summary, snapshot, diagnostics, and timing.',
+  option: '--report'
+}, {
+  aliases: [],
+  description: 'Write the selected inspect payload to a file instead of stdout.',
+  option: '--output <path>'
+}, {
+  aliases: [],
+  description: 'Select the exported module symbol name (default: AppModule).',
+  option: '--export <name>'
+}, {
+  aliases: ['-h'],
+  description: 'Show help for the inspect command.',
+  option: '--help'
+}];
+
+/**
+ * Renders CLI help text for `fluo new` without importing the scaffold implementation.
+ *
+ * @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');
+}
+
+/**
+ * Returns the usage information string for the inspect command without importing runtime inspection logic.
+ *
+ * @returns Formatted help text including usage and options.
+ */
+export function inspectUsage() {
+  return ['Usage: fluo inspect <module-path> [options]', '', 'Options', renderHelpTable(INSPECT_OPTION_HELP, [{
+    header: 'Option',
+    render: entry => entry.option
+  }, {
+    header: 'Aliases',
+    render: entry => renderAliasList(entry.aliases)
+  }, {
+    header: 'Description',
+    render: entry => entry.description
+  }]), '', 'Docs: https://github.com/fluojs/fluo/tree/main/docs/getting-started/quick-start.md'].join('\n');
+}

package/package.json

@@ -9,7 +9,7 @@
     "migration",
     "diagnostics"
   ],
-  "version": "1.0.6",
+  "version": "2.0.1",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -44,10 +44,10 @@
     "ejs": "^3.1.10",
     "tsx": "^4.20.4",
     "typescript": "^6.0.2",
-    "@fluojs/runtime": "^1.1.5"
+    "@fluojs/runtime": "^2.0.1"
   },
   "peerDependencies": {
-    "@fluojs/studio": "^1.0.5"
+    "@fluojs/studio": "^1.0.8"
   },
   "peerDependenciesMeta": {
     "@fluojs/studio": {