@lunora/cli 1.0.0-alpha.3 → 1.0.0-alpha.31

package/dist/packem_chunks/handler13.mjs

@@ -1,65 +1,131 @@
-import { existsSync, rmSync } from 'node:fs';
-import { join } from 'node:path';
-import { writeLinkedProject, LINKED_PROJECT_FILE } from '@lunora/config';
-import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
-import { r as readWranglerName } from '../packem_shared/wrangler-name-cy4yhm9j.mjs';
+import { r as resolveAdminBaseUrl } from '../packem_shared/admin-url-4UzT-CI4.mjs';
+import { d as defineHandler } from '../packem_shared/command-D3lB_4Az.mjs';
+import { a as resolveProductionWorkerUrl } from '../packem_shared/resolve-target-qbsJ_5sF.mjs';
 
-const isValidWorkerUrl = (value) => {
-  try {
-    const { protocol } = new URL(value);
-    return protocol === "http:" || protocol === "https:";
-  } catch {
-    return false;
-  }
+const GET_FUNCTION_STATS_OP = "__lunora_admin__:getFunctionStats";
+const DEFAULT_LIMIT = 10;
+const TRAILING_SLASH = /\/$/u;
+const toInsightRow = (stat, rate) => {
+  return {
+    calls: stat.calls,
+    conflicts: stat.conflicts ?? 0,
+    errors: stat.errors,
+    lastErrorMessage: stat.lastErrorMessage,
+    maxDurationMs: stat.maxDurationMs,
+    meanDurationMs: stat.calls === 0 ? 0 : stat.totalDurationMs / stat.calls,
+    path: stat.path,
+    rate
+  };
+};
+const buildInsightsReport = (functions, limit) => {
+  const writeContention = functions.filter((stat) => (stat.conflicts ?? 0) > 0).map((stat) => toInsightRow(stat, stat.calls === 0 ? 0 : (stat.conflicts ?? 0) / stat.calls)).toSorted((a, b) => b.rate - a.rate || b.conflicts - a.conflicts).slice(0, limit);
+  const errorHotspots = functions.filter((stat) => stat.errors > 0).map((stat) => toInsightRow(stat, stat.calls === 0 ? 0 : stat.errors / stat.calls)).toSorted((a, b) => b.rate - a.rate || b.errors - a.errors).slice(0, limit);
+  const latencyOutliers = functions.map((stat) => toInsightRow(stat, 0)).toSorted((a, b) => b.maxDurationMs - a.maxDurationMs).slice(0, limit);
+  return { errorHotspots, latencyOutliers, totalFunctions: functions.length, writeContention };
 };
-const runLinkRemove = (cwd, logger) => {
-  const path = join(cwd, LINKED_PROJECT_FILE);
-  if (!existsSync(path)) {
-    logger.warn(`link: no ${LINKED_PROJECT_FILE} to remove`);
-    return { code: 0 };
+const percent = (rate) => `${(rate * 100).toFixed(1)}%`;
+const formatMs = (ms) => ms < 1e3 ? `${Math.round(ms).toString()}ms` : `${(ms / 1e3).toFixed(2)}s`;
+const formatSection = (heading, rows, emptyNote, renderRow) => [
+  heading,
+  ...rows.length === 0 ? [`  ${emptyNote}`] : rows.map((row) => `  ${renderRow(row)}`)
+];
+const formatInsightsReport = (report) => {
+  const errorTail = (row) => row.lastErrorMessage ? ` — ${row.lastErrorMessage}` : "";
+  return [
+    `Insights over ${report.totalFunctions.toString()} function${report.totalFunctions === 1 ? "" : "s"}`,
+    "",
+    ...formatSection(
+      "Write-conflict hot-spots (OCC contention — candidates for sharding):",
+      report.writeContention,
+      "none — no write conflicts observed",
+      (row) => `${row.path}  ${row.conflicts.toString()}/${row.calls.toString()} calls (${percent(row.rate)})`
+    ),
+    "",
+    ...formatSection(
+      "Error hot-spots:",
+      report.errorHotspots,
+      "none — no errors observed",
+      (row) => `${row.path}  ${row.errors.toString()}/${row.calls.toString()} calls (${percent(row.rate)})${errorTail(row)}`
+    ),
+    "",
+    ...formatSection(
+      "Latency outliers (slowest single call):",
+      report.latencyOutliers,
+      "none — no functions have run",
+      (row) => `${row.path}  max ${formatMs(row.maxDurationMs)}, mean ${formatMs(row.meanDurationMs)} over ${row.calls.toString()} calls`
+    )
+  ].join("\n");
+};
+const resolveLimit = (raw) => {
+  if (raw === void 0 || !Number.isFinite(raw) || raw <= 0) {
+    return DEFAULT_LIMIT;
   }
-  rmSync(path);
-  logger.success(`link: removed ${LINKED_PROJECT_FILE}`);
-  return { code: 0 };
+  return Math.floor(raw);
 };
-const runLinkCommand = (options) => {
-  const cwd = options.cwd ?? process.cwd();
-  const { logger } = options;
-  if (options.remove) {
-    return runLinkRemove(cwd, logger);
+const runInsightsCommand = async (options) => {
+  if (options.prod && options.url === void 0) {
+    options.logger.error("--prod requires an explicit --url (refusing to report from the implicit localhost worker)");
+    return { code: 1 };
   }
-  if (options.url === void 0 || options.url === "") {
-    logger.error("link requires a deployed Worker URL. Usage: lunora link --url <https://your-worker>");
+  const token = options.token ?? process.env.LUNORA_ADMIN_TOKEN;
+  if (!token) {
+    options.logger.error("admin token required — pass --token or set LUNORA_ADMIN_TOKEN");
     return { code: 1 };
   }
-  if (!isValidWorkerUrl(options.url)) {
-    logger.error(`link: invalid --url "${options.url}" — expected an http(s) URL`);
+  const baseUrl = resolveAdminBaseUrl(options.url, options.logger);
+  if (baseUrl === void 0) {
     return { code: 1 };
   }
-  const now = options.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
-  const link = {
-    env: options.env,
-    linkedAt: now(),
-    workerName: options.name ?? readWranglerName(cwd),
-    workerUrl: options.url
-  };
-  const path = writeLinkedProject(cwd, link);
-  logger.success(`link: ${link.workerName ?? "(unnamed worker)"} -> ${options.url}`);
-  logger.info(`link: wrote ${path}`);
-  if (link.env !== void 0) {
-    logger.info(`link: environment "${link.env}"`);
+  const requestUrl = `${baseUrl.replace(TRAILING_SLASH, "")}/_lunora/rpc`;
+  const fetchImpl = globalThis.fetch;
+  if (typeof fetchImpl !== "function") {
+    throw new TypeError("no fetch implementation available — pass fetchImpl or run on Node >= 18");
+  }
+  const payload = { args: {}, functionPath: GET_FUNCTION_STATS_OP };
+  if (options.shard !== void 0) {
+    payload.shardKey = options.shard;
+  }
+  options.logger.info(`POST ${requestUrl} -> insights`);
+  const response = await fetchImpl(requestUrl, {
+    body: JSON.stringify(payload),
+    headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
+    method: "POST"
+  });
+  const text = await response.text();
+  if (!response.ok) {
+    options.logger.error(`insights failed: HTTP ${String(response.status)}: ${text}`);
+    return { code: 1 };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    options.logger.error(`insights failed: worker returned non-JSON: ${text}`);
+    return { code: 1 };
+  }
+  const result = parsed.result ?? parsed;
+  const { functions } = result;
+  if (!Array.isArray(functions)) {
+    options.logger.error("insights failed: response carried no `functions` array");
+    return { code: 1 };
   }
-  return { code: 0, link };
+  const report = buildInsightsReport(functions, resolveLimit(options.limit));
+  options.logger.info(options.json ? JSON.stringify(report, void 0, 2) : formatInsightsReport(report));
+  return { code: 0, report };
 };
-const execute = defineHandler(
-  ({ cwd, logger, options }) => runLinkCommand({
-    cwd,
-    env: options.env,
+const execute = defineHandler(({ cwd, logger, options }) => {
+  const limit = options.limit === void 0 ? void 0 : Number.parseInt(options.limit, 10);
+  return runInsightsCommand({
+    json: options.json,
+    limit,
     logger,
-    name: options.name,
-    remove: options.remove === true,
-    url: options.url
-  })
-);
+    prod: options.prod,
+    shard: options.shard,
+    token: options.token,
+    // Fall back to the `.lunora/project.json` link when `--prod` is set, so a
+    // linked checkout doesn't need --url repeated for prod insights.
+    url: resolveProductionWorkerUrl({ cwd, prod: options.prod === true, url: options.url })
+  });
+});
 
-export { execute, runLinkCommand };
+export { buildInsightsReport, execute, formatInsightsReport, runInsightsCommand };

package/dist/packem_chunks/handler14.mjs

@@ -1,58 +1,65 @@
-import { readLinkedProject } from '@lunora/config';
-import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
-import { defaultSpawner } from '../packem_shared/defaultSpawner-DxI3mebw.mjs';
+import { existsSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { writeLinkedProject, LINKED_PROJECT_FILE } from '@lunora/config';
+import { d as defineHandler } from '../packem_shared/command-D3lB_4Az.mjs';
+import { r as readWranglerName } from '../packem_shared/wrangler-name-cy4yhm9j.mjs';
 
-const LOG_FORMATS = /* @__PURE__ */ new Set(["json", "pretty"]);
-const runLogsCommand = async (options) => {
-  const cwd = options.cwd ?? process.cwd();
-  if (options.format !== void 0 && !LOG_FORMATS.has(options.format)) {
-    options.logger.error(`logs: unknown --format "${options.format}" — expected pretty | json`);
-    return { code: 1, descriptor: void 0, error: "invalid format" };
-  }
-  const args = ["exec", "wrangler", "tail"];
-  if (options.worker !== void 0) {
-    args.push(options.worker);
-  }
-  const env = options.env ?? readLinkedProject(cwd)?.env;
-  if (env !== void 0) {
-    args.push("--env", env);
+const isValidWorkerUrl = (value) => {
+  try {
+    const { protocol } = new URL(value);
+    return protocol === "http:" || protocol === "https:";
+  } catch {
+    return false;
   }
-  if (options.format !== void 0) {
-    args.push("--format", options.format);
+};
+const runLinkRemove = (cwd, logger) => {
+  const path = join(cwd, LINKED_PROJECT_FILE);
+  if (!existsSync(path)) {
+    logger.warn(`link: no ${LINKED_PROJECT_FILE} to remove`);
+    return { code: 0 };
   }
-  if (options.status !== void 0) {
-    args.push("--status", options.status);
+  rmSync(path);
+  logger.success(`link: removed ${LINKED_PROJECT_FILE}`);
+  return { code: 0 };
+};
+const runLinkCommand = (options) => {
+  const cwd = options.cwd ?? process.cwd();
+  const { logger } = options;
+  if (options.remove) {
+    return runLinkRemove(cwd, logger);
   }
-  if (options.search !== void 0) {
-    args.push("--search", options.search);
+  if (options.url === void 0 || options.url === "") {
+    logger.error("link requires a deployed Worker URL. Usage: lunora link --url <https://your-worker>");
+    return { code: 1 };
   }
-  if (options.temporary) {
-    args.push("--temporary");
+  if (!isValidWorkerUrl(options.url)) {
+    logger.error(`link: invalid --url "${options.url}" — expected an http(s) URL`);
+    return { code: 1 };
   }
-  const descriptor = {
-    args,
-    command: "pnpm",
-    cwd
-  };
-  options.logger.info(`tailing logs via ${descriptor.command} ${descriptor.args.join(" ")}`);
-  const spawner = options.spawner ?? defaultSpawner;
-  const result = await spawner(descriptor);
-  return {
-    code: result.code,
-    descriptor
+  const now = options.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
+  const link = {
+    env: options.env,
+    linkedAt: now(),
+    workerName: options.name ?? readWranglerName(cwd),
+    workerUrl: options.url
   };
+  const path = writeLinkedProject(cwd, link);
+  logger.success(`link: ${link.workerName ?? "(unnamed worker)"} -> ${options.url}`);
+  logger.info(`link: wrote ${path}`);
+  if (link.env !== void 0) {
+    logger.info(`link: environment "${link.env}"`);
+  }
+  return { code: 0, link };
 };
 const execute = defineHandler(
-  ({ argument, cwd, logger, options }) => runLogsCommand({
+  ({ cwd, logger, options }) => runLinkCommand({
     cwd,
     env: options.env,
-    format: options.format,
     logger,
-    search: options.search,
-    status: options.status,
-    temporary: options.temporary === true,
-    worker: argument[0]
+    name: options.name,
+    remove: options.remove === true,
+    url: options.url
   })
 );
 
-export { execute, runLogsCommand };
+export { execute, runLinkCommand };

package/dist/packem_chunks/handler15.mjs

@@ -1,79 +1,58 @@
-import { runCodegen } from '@lunora/codegen';
-import { validateWranglerProject, inferLunoraBindings, reconcileWranglerBindings } from '@lunora/config';
-import { p as parseApiSpec } from '../packem_shared/api-spec-CtA6ilu4.mjs';
-import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
-import { r as runSchemaDriftGate } from '../packem_shared/schema-drift-gate-BtBt0as0.mjs';
+import { readLinkedProject } from '@lunora/config';
+import { d as defineHandler } from '../packem_shared/command-D3lB_4Az.mjs';
+import { defaultSpawner } from '../packem_shared/createRecordingSpawner-DxI3mebw.mjs';
 
-const provisionBindings = async (cwd, logger) => {
-  try {
-    const inferred = await inferLunoraBindings({ projectRoot: cwd });
-    const reconciled = reconcileWranglerBindings(cwd, inferred);
-    if (reconciled.changed) {
-      logger.success(`provisioned bindings: ${reconciled.added.join(", ")} → ${reconciled.wranglerPath ?? "wrangler.jsonc"}`);
-    }
-    for (const warning of reconciled.warnings) {
-      logger.warn(warning);
-    }
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    logger.warn(`binding inference skipped: ${message}`);
-  }
-};
-const runPrepareCommand = async (options) => {
+const LOG_FORMATS = /* @__PURE__ */ new Set(["json", "pretty"]);
+const runLogsCommand = async (options) => {
   const cwd = options.cwd ?? process.cwd();
-  options.logger.info("running codegen");
-  let codegen;
-  try {
-    codegen = runCodegen({ apiSpec: options.apiSpec, projectRoot: cwd });
-    options.logger.success("codegen complete");
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    options.logger.error(`codegen failed: ${message}`);
-    return {
-      code: 1,
-      error: `codegen failed: ${message}`,
-      validation: { problems: [], wranglerPath: void 0 }
-    };
+  if (options.format !== void 0 && !LOG_FORMATS.has(options.format)) {
+    options.logger.error(`logs: unknown --format "${options.format}" — expected pretty | json`);
+    return { code: 1, descriptor: void 0, error: "invalid format" };
+  }
+  const args = ["exec", "wrangler", "tail"];
+  if (options.worker !== void 0) {
+    args.push(options.worker);
+  }
+  const env = options.env ?? readLinkedProject(cwd)?.env;
+  if (env !== void 0) {
+    args.push("--env", env);
+  }
+  if (options.format !== void 0) {
+    args.push("--format", options.format);
+  }
+  if (options.status !== void 0) {
+    args.push("--status", options.status);
   }
-  const gate = runSchemaDriftGate({
-    allowDrift: options.allowSchemaDrift === true,
-    codegen,
-    logger: options.logger,
-    updateBaseline: options.updateSchemaBaseline === true
-  });
-  if (gate.blocked) {
-    return {
-      code: 1,
-      error: "schema drift gate blocked prepare",
-      schemaDrift: { blocked: true, reason: gate.reason },
-      validation: { problems: [], wranglerPath: void 0 }
-    };
+  if (options.search !== void 0) {
+    args.push("--search", options.search);
   }
-  await provisionBindings(cwd, options.logger);
-  const validation = validateWranglerProject({ projectRoot: cwd });
-  if (validation.problems.length > 0) {
-    options.logger.error("wrangler.jsonc validation failed:");
-    for (const problem of validation.problems) {
-      options.logger.error(`  - ${problem}`);
-    }
-    return {
-      code: 1,
-      error: "wrangler validation failed",
-      validation
-    };
+  if (options.temporary) {
+    args.push("--temporary");
   }
-  gate.rebless?.();
-  options.logger.success("project is ready to deploy");
-  return { code: 0, validation };
+  const descriptor = {
+    args,
+    command: "pnpm",
+    cwd
+  };
+  options.logger.info(`tailing logs via ${descriptor.command} ${descriptor.args.join(" ")}`);
+  const spawner = options.spawner ?? defaultSpawner;
+  const result = await spawner(descriptor);
+  return {
+    code: result.code,
+    descriptor
+  };
 };
 const execute = defineHandler(
-  ({ cwd, logger, options }) => runPrepareCommand({
-    allowSchemaDrift: options.allowSchemaDrift === true,
-    apiSpec: parseApiSpec(options.apiSpec),
+  ({ argument, cwd, logger, options }) => runLogsCommand({
     cwd,
+    env: options.env,
+    format: options.format,
     logger,
-    updateSchemaBaseline: options.updateSchemaBaseline === true
+    search: options.search,
+    status: options.status,
+    temporary: options.temporary === true,
+    worker: argument[0]
   })
 );
 
-export { execute, runPrepareCommand };
+export { execute, runLogsCommand };

package/dist/packem_chunks/handler16.mjs

@@ -1,43 +1,80 @@
-import { d as defineHandler } from '../packem_shared/command-BDXcJCCJ.mjs';
-import { r as runAddCommand, b as runRegistryViewCommand, a as runBuildIndexCommand } from '../packem_shared/commands-DIQ3nf0C.mjs';
+import { runCodegen } from '@lunora/codegen';
+import { validateWranglerProject, inferLunoraBindings, reconcileWranglerBindings } from '@lunora/config';
+import { p as parseApiSpec } from '../packem_shared/api-spec-CtA6ilu4.mjs';
+import { r as renderCodegenFailure } from '../packem_shared/codegen-error-DJG-ghs_.mjs';
+import { d as defineHandler } from '../packem_shared/command-D3lB_4Az.mjs';
+import { r as runSchemaDriftGate } from '../packem_shared/schema-drift-gate-BtBt0as0.mjs';
 
-const execute = defineHandler(({ argument, cwd, logger, options }) => {
-  const subcommand = argument[0];
-  const names = argument.slice(1);
-  if (subcommand === "add") {
-    return runAddCommand({
-      allowUnsafeSource: options.allowUnsafeSource === true,
-      cwd,
-      diff: options.diff === true,
-      dryRun: options.dryRun === true,
-      from: options.from,
-      json: options.json === true,
-      logger,
-      names,
-      overwrite: options.overwrite === true,
-      ref: options.ref,
-      source: options.source,
-      yes: options.yes === true
-    });
+const provisionBindings = async (cwd, logger) => {
+  try {
+    const inferred = await inferLunoraBindings({ projectRoot: cwd });
+    const reconciled = reconcileWranglerBindings(cwd, inferred);
+    if (reconciled.changed) {
+      logger.success(`provisioned bindings: ${reconciled.added.join(", ")} → ${reconciled.wranglerPath ?? "wrangler.jsonc"}`);
+    }
+    for (const warning of reconciled.warnings) {
+      logger.warn(warning);
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    logger.warn(`binding inference skipped: ${message}`);
   }
-  if (subcommand === "list") {
-    return runAddCommand({ cwd, from: options.from, json: options.json === true, list: true, logger, names: [], ref: options.ref, source: options.source });
+};
+const runPrepareCommand = async (options) => {
+  const cwd = options.cwd ?? process.cwd();
+  options.logger.info("running codegen");
+  let codegen;
+  try {
+    codegen = runCodegen({ apiSpec: options.apiSpec, projectRoot: cwd });
+    options.logger.success("codegen complete");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    options.logger.error(renderCodegenFailure(error));
+    return {
+      code: 1,
+      error: `codegen failed: ${message}`,
+      validation: { problems: [], wranglerPath: void 0 }
+    };
   }
-  if (subcommand === "view") {
-    return runRegistryViewCommand({
-      allowUnsafeSource: options.allowUnsafeSource === true,
-      from: options.from,
-      logger,
-      names,
-      ref: options.ref,
-      source: options.source
-    });
+  const gate = runSchemaDriftGate({
+    allowDrift: options.allowSchemaDrift === true,
+    codegen,
+    logger: options.logger,
+    updateBaseline: options.updateSchemaBaseline === true
+  });
+  if (gate.blocked) {
+    return {
+      code: 1,
+      error: "schema drift gate blocked prepare",
+      schemaDrift: { blocked: true, reason: gate.reason },
+      validation: { problems: [], wranglerPath: void 0 }
+    };
   }
-  if (subcommand === "build") {
-    return runBuildIndexCommand({ check: options.check === true, from: options.from, logger, out: options.out });
+  await provisionBindings(cwd, options.logger);
+  const validation = validateWranglerProject({ projectRoot: cwd });
+  if (validation.problems.length > 0) {
+    options.logger.error("wrangler.jsonc validation failed:");
+    for (const problem of validation.problems) {
+      options.logger.error(`  - ${problem}`);
+    }
+    return {
+      code: 1,
+      error: "wrangler validation failed",
+      validation
+    };
   }
-  logger.error("registry: unknown subcommand. Usage: lunora registry <add|list|view|build> [names…]");
-  return { code: 1 };
-});
+  gate.rebless?.();
+  options.logger.success("project is ready to deploy");
+  return { code: 0, validation };
+};
+const execute = defineHandler(
+  ({ cwd, logger, options }) => runPrepareCommand({
+    allowSchemaDrift: options.allowSchemaDrift === true,
+    apiSpec: parseApiSpec(options.apiSpec),
+    cwd,
+    logger,
+    updateSchemaBaseline: options.updateSchemaBaseline === true
+  })
+);
 
-export { execute };
+export { execute, runPrepareCommand };