@lunora/cli 1.0.0-alpha.9 → 1.0.0-alpha.91

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/cli",
-  "version": "1.0.0-alpha.9",
+  "version": "1.0.0-alpha.91",
   "description": "The Lunora CLI: init, dev, deploy, codegen, run, reset, and migrate commands",
   "keywords": [
     "agent-skills",
@@ -51,22 +51,25 @@
     "access": "public"
   },
   "dependencies": {
-    "@bomb.sh/tab": "0.0.16",
-    "@lunora/codegen": "1.0.0-alpha.3",
-    "@lunora/config": "1.0.0-alpha.4",
-    "@lunora/container": "1.0.0-alpha.1",
-    "@lunora/d1": "1.0.0-alpha.4",
-    "@lunora/seed": "1.0.0-alpha.1",
-    "@visulima/cerebro": "3.0.0-alpha.32",
-    "@visulima/fs": "5.0.0-alpha.32",
-    "@visulima/pail": "4.0.0-alpha.22",
-    "@visulima/path": "3.0.0-alpha.13",
-    "@visulima/spinner": "1.0.0-alpha.4",
-    "@visulima/tui": "1.0.0-alpha.26",
+    "@bomb.sh/tab": "0.0.19",
+    "@lunora/codegen": "1.0.0-alpha.48",
+    "@lunora/config": "1.0.0-alpha.72",
+    "@lunora/container": "1.0.0-alpha.13",
+    "@lunora/d1": "1.0.0-alpha.34",
+    "@lunora/errors": "1.0.0-alpha.6",
+    "@lunora/seed": "1.0.0-alpha.28",
+    "@visulima/cerebro": "3.0.0",
+    "@visulima/error": "6.0.0",
+    "@visulima/fs": "5.0.4",
+    "@visulima/package": "5.0.4",
+    "@visulima/pail": "4.0.0",
+    "@visulima/path": "3.0.0",
+    "@visulima/spinner": "1.0.0",
+    "@visulima/tui": "1.0.4",
     "cfonts": "^3.3.1",
     "giget": "3.3.0",
     "jsonc-parser": "^3.3.1",
-    "magic-string": "^0.30.21",
+    "magic-string": "^1.0.0",
     "react": "^19.2.7",
     "react-reconciler": "^0.33.0",
     "ts-morph": "^28.0.0"

package/skills/lunora-quickstart/SKILL.md

@@ -31,9 +31,12 @@ Set up a working Lunora project as fast as possible.
    Lunora into the current project.
 4. Run `lunora codegen` to generate `lunora/_generated/` and typecheck the
    schema + functions. This is the agent's feedback loop.
-5. Start the dev loop with `lunora dev` (ask the user to run it locally, or
-   start it in the background for cloud/headless agents — it is long-running and
-   does not exit).
+5. Start the dev loop. As an agent, run `lunora dev --background` — it starts
+   the server as a managed detached process, blocks until it accepts requests,
+   prints the URL + PID, and returns (under a detected AI agent, plain
+   `lunora dev` does this automatically, with JSON logs). Never leave a bare
+   `lunora dev` running in your own shell — it is long-running and does not
+   exit.
 6. Verify a query/mutation round-trip works end to end.
 
 ## Path 1: New Project (Recommended)
@@ -54,6 +57,7 @@ pnpm install
 | `vite`                 | React + Vite (the simplest full-stack starter) |
 | `standalone`           | Worker-only Lunora backend, no frontend        |
 | `astro`                | Astro integration                              |
+| `next`                 | Next.js (App Router, OpenNext on Cloudflare)   |
 | `nuxt`                 | Nuxt (Vue)                                     |
 | `sveltekit`            | SvelteKit                                      |
 | `tanstack-start-react` | TanStack Start (React)                         |
@@ -87,7 +91,23 @@ not exit, so:
 
 - **Local development (user at the keyboard):** ask the user to run `lunora dev`
   in a terminal.
-- **Cloud or headless agents:** start `lunora dev` in the background.
+- **Agents:** run `lunora dev --background`. It detaches the server, waits until
+  it answers HTTP, prints `Dev server running at <url> (pid <n>)`, and exits —
+  no orphaned shell, no PID bookkeeping. When Lunora detects an AI agent
+  (Claude Code, Cursor, Codex, …), plain `lunora dev` flips into this mode
+  automatically with JSON logs; `LUNORA_AGENT_MODE=0` opts out.
+
+Manage the running server afterwards:
+
+```bash
+lunora dev status --json   # machine-readable: url, pid, uptime, logFile
+lunora dev logs --lines 50 # tail the captured output (.lunora/dev.log)
+lunora dev stop            # idempotent — succeeds even if nothing runs
+```
+
+A second `lunora dev` never double-starts: it reports the existing instance
+(`.lunora/dev.json` is the lockfile). Probe readiness or liveness at
+`GET /_lunora/status` (`{"ok":true}`).
 
 Vite serves on `http://localhost:5173` by default; the Worker is served on the
 same origin via `@cloudflare/vite-plugin`.
@@ -236,5 +256,6 @@ ids, `.dev.vars` secrets, and container exports.
 - [ ] New project: scaffolded with `lunora init --template <t>`.
 - [ ] Existing app: ran `lunora init --here` and wired `LunoraProvider`.
 - [ ] Ran `lunora codegen`: `lunora/_generated/` exists and typecheck is clean.
-- [ ] `lunora dev` is running — user terminal, or background for cloud agents.
+- [ ] Dev server is running — user terminal, or `lunora dev --background`
+      (check with `lunora dev status`).
 - [ ] Verified a query/mutation round-trip re-renders the client live.

package/dist/packem_shared/detect-package-manager-DYp7n3mJ.mjs

@@ -1,61 +0,0 @@
-import { spawnSync } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
-import { dirname, join } from '@visulima/path';
-
-const FALLBACK = "pnpm";
-const KNOWN_MANAGERS = ["pnpm", "yarn", "npm", "bun"];
-const INSTALL_PREFERENCE = ["pnpm", "bun", "yarn", "npm"];
-const isManagerInstalled = (manager) => {
-  try {
-    return spawnSync(manager, ["--version"], { stdio: "ignore", timeout: 5e3 }).status === 0;
-  } catch {
-    return false;
-  }
-};
-const detectInstalledManagers = (probe = isManagerInstalled) => INSTALL_PREFERENCE.filter((manager) => probe(manager));
-const installArgsFor = (manager) => {
-  return { args: ["install"], command: manager };
-};
-const parseDeclaredManager = (declared) => {
-  if (typeof declared !== "string") {
-    return void 0;
-  }
-  return KNOWN_MANAGERS.find((manager) => declared.startsWith(`${manager}@`));
-};
-const readDeclaredManager = (directory) => {
-  const candidate = join(directory, "package.json");
-  if (!existsSync(candidate)) {
-    return void 0;
-  }
-  try {
-    const parsed = JSON.parse(readFileSync(candidate, "utf8"));
-    return parseDeclaredManager(parsed.packageManager);
-  } catch {
-    return void 0;
-  }
-};
-const detectPackageManager = (startDirectory) => {
-  let directory = startDirectory;
-  while (directory && directory !== dirname(directory)) {
-    const declared = readDeclaredManager(directory);
-    if (declared !== void 0) {
-      return declared;
-    }
-    directory = dirname(directory);
-  }
-  return FALLBACK;
-};
-const execArgsFor = (manager, command, args) => {
-  if (manager === "yarn") {
-    return { args: [command, ...args], command: "yarn" };
-  }
-  if (manager === "bun") {
-    return { args: ["x", command, ...args], command: "bun" };
-  }
-  if (manager === "npm") {
-    return { args: ["--", command, ...args], command: "npx" };
-  }
-  return { args: ["exec", command, ...args], command: "pnpm" };
-};
-
-export { detectInstalledManagers as a, detectPackageManager as d, execArgsFor as e, installArgsFor as i };

package/dist/packem_shared/parseArgs-YXFuKdEk.mjs

@@ -1,56 +0,0 @@
-const consumeLongOption = (body, next, booleanFlags, accumulator) => {
-  const eqIndex = body.indexOf("=");
-  if (eqIndex !== -1) {
-    accumulator.options[body.slice(0, eqIndex)] = body.slice(eqIndex + 1);
-    return 1;
-  }
-  if (booleanFlags.has(body)) {
-    accumulator.flags[body] = true;
-    return 1;
-  }
-  if (next !== void 0 && !next.startsWith("-")) {
-    accumulator.options[body] = next;
-    return 2;
-  }
-  accumulator.flags[body] = true;
-  return 1;
-};
-const consumeShortOption = (body, next, accumulator) => {
-  if (body.length > 1) {
-    accumulator.options[body[0]] = body.slice(1);
-    return 1;
-  }
-  if (next !== void 0 && !next.startsWith("-")) {
-    accumulator.options[body] = next;
-    return 2;
-  }
-  accumulator.flags[body] = true;
-  return 1;
-};
-const parseArgs = (argv, booleanFlags = /* @__PURE__ */ new Set()) => {
-  const accumulator = { flags: {}, options: {}, positional: [] };
-  let index = 0;
-  let terminated = false;
-  while (index < argv.length) {
-    const token = argv[index];
-    if (token === void 0) {
-      index += 1;
-      continue;
-    }
-    if (terminated || !token.startsWith("-") || token.length === 1) {
-      accumulator.positional.push(token);
-      index += 1;
-      continue;
-    }
-    if (token === "--") {
-      terminated = true;
-      index += 1;
-      continue;
-    }
-    const next = argv[index + 1];
-    index += token.startsWith("--") ? consumeLongOption(token.slice(2), next, booleanFlags, accumulator) : consumeShortOption(token.slice(1), next, accumulator);
-  }
-  return { flags: accumulator.flags, options: accumulator.options, positional: accumulator.positional };
-};
-
-export { parseArgs as default };

package/dist/packem_shared/runAddCommand-DepS9W9W.mjs

@@ -1,4 +0,0 @@
-import 'node:fs';
-import '@visulima/path';
-export { r as runAddCommand, a as runBuildIndexCommand, e as runListCommand, b as runRegistryViewCommand } from './commands-CkkATMMx.mjs';
-import './buildRegistryIndex-BcYe607_.mjs';

package/dist/packem_shared/tui-prompts-CA9lngSS.mjs

@@ -1,269 +0,0 @@
-import { jsxs, jsx } from 'react/jsx-runtime';
-import { isInteractive } from '@lunora/config';
-import { render } from '@visulima/tui';
-import { BigText } from '@visulima/tui/components/big-text';
-import { Box } from '@visulima/tui/components/box';
-import { CommandPalette } from '@visulima/tui/components/command-palette';
-import { ConfirmInput } from '@visulima/tui/components/confirm-input';
-import { MultiSelect } from '@visulima/tui/components/multi-select';
-import { SelectInput } from '@visulima/tui/components/select-input';
-import { Spinner } from '@visulima/tui/components/spinner';
-import { Text } from '@visulima/tui/components/text';
-import { TextInput } from '@visulima/tui/components/text-input';
-import { useApp } from '@visulima/tui/hooks/use-app';
-import { useInput } from '@visulima/tui/hooks/use-input';
-import { useEffect } from 'react';
-
-const ACCENT = "#a855f7";
-const SCROLL_LIMIT = 10;
-const FILTER_THRESHOLD = 8;
-const PromptFrame = ({ children }) => jsx(Box, { borderColor: ACCENT, borderStyle: "round", flexDirection: "column", paddingX: 1, children });
-const runInkPrompt = async (build, fallback) => {
-  let result = fallback;
-  const instance = render(
-    build((value) => {
-      result = value;
-    }),
-    { exitOnCtrlC: true }
-  );
-  try {
-    await instance.waitUntilExit();
-  } catch {
-  } finally {
-    instance.unmount();
-  }
-  return result;
-};
-const itemLabel = (option) => option.description === void 0 ? option.label : `${option.label} — ${option.description}`;
-const useCommit = (finish) => {
-  const { exit } = useApp();
-  return (result) => {
-    finish(result);
-    exit();
-  };
-};
-const useEscapeToExit = () => {
-  const { exit } = useApp();
-  useInput((_input, key) => {
-    if (key.escape) {
-      exit();
-    }
-  });
-};
-const SelectView = ({ finish, initialIndex, message, options }) => {
-  const commit = useCommit(finish);
-  useEscapeToExit();
-  return jsxs(PromptFrame, { children: [
-    jsx(Text, { bold: true, children: message }),
-    jsx(
-      SelectInput,
-      {
-        accentColor: ACCENT,
-        initialIndex,
-        items: options.map((option) => {
-          return { key: option.value, label: itemLabel(option), value: option.value };
-        }),
-        limit: SCROLL_LIMIT,
-        onSelect: (item) => {
-          commit(item.value);
-        }
-      }
-    )
-  ] });
-};
-const PaletteView = ({ finish, message, options }) => {
-  const { exit } = useApp();
-  const commit = useCommit(finish);
-  return jsxs(Box, { flexDirection: "column", children: [
-    jsx(Text, { bold: true, children: message }),
-    jsx(
-      CommandPalette,
-      {
-        accentColor: ACCENT,
-        autoFocus: true,
-        commands: options.map((option) => {
-          return { description: option.description, id: option.value, label: option.label };
-        }),
-        limit: SCROLL_LIMIT,
-        onCancel: () => {
-          exit();
-        },
-        onSelect: (id) => {
-          commit(id);
-        },
-        placeholder: "Type to filter…"
-      }
-    )
-  ] });
-};
-const tuiSelect = async (message, options, settings) => {
-  if (!isInteractive() || options.length === 0) {
-    return settings?.default;
-  }
-  if (options.length > FILTER_THRESHOLD) {
-    return runInkPrompt((finish) => jsx(PaletteView, { finish, message, options }), settings?.default);
-  }
-  const defaultIndex = settings?.default === void 0 ? -1 : options.findIndex((option) => option.value === settings.default);
-  return runInkPrompt(
-    (finish) => jsx(SelectView, { finish, initialIndex: defaultIndex >= 0 ? defaultIndex : void 0, message, options }),
-    settings?.default
-  );
-};
-const TextView = ({ defaultValue, finish, message, placeholder }) => {
-  const commit = useCommit(finish);
-  useEscapeToExit();
-  return jsxs(PromptFrame, { children: [
-    jsx(Text, { bold: true, children: message }),
-    jsx(
-      TextInput,
-      {
-        defaultValue,
-        onSubmit: (value) => {
-          commit(value.trim() === "" ? defaultValue : value.trim());
-        },
-        placeholder
-      }
-    )
-  ] });
-};
-const tuiText = async (message, settings) => {
-  const fallback = settings?.default ?? "";
-  if (!isInteractive()) {
-    return fallback;
-  }
-  return runInkPrompt(
-    (finish) => jsx(TextView, { defaultValue: fallback, finish, message, placeholder: settings?.placeholder }),
-    fallback
-  );
-};
-const MultiSelectView = ({ defaults, finish, message, options }) => {
-  const commit = useCommit(finish);
-  useEscapeToExit();
-  return jsxs(PromptFrame, { children: [
-    jsx(Text, { bold: true, children: message }),
-    jsx(Text, { dimColor: true, children: "space toggles · enter confirms · esc cancels" }),
-    jsx(
-      MultiSelect,
-      {
-        accentColor: ACCENT,
-        defaultValue: [...defaults],
-        limit: SCROLL_LIMIT,
-        onSubmit: (values) => {
-          const chosen = new Set(values);
-          commit(options.filter((option) => chosen.has(option.value)).map((option) => option.value));
-        },
-        options: options.map((option) => {
-          return { key: option.value, label: itemLabel(option), value: option.value };
-        })
-      }
-    )
-  ] });
-};
-const tuiMultiSelect = async (message, options, settings) => {
-  const defaults = settings?.defaults ?? [];
-  if (!isInteractive() || options.length === 0) {
-    return [...defaults];
-  }
-  return runInkPrompt((finish) => jsx(MultiSelectView, { defaults, finish, message, options }), [...defaults]);
-};
-const ConfirmView = ({ defaultYes, finish, message }) => {
-  const commit = useCommit(finish);
-  return jsx(PromptFrame, { children: jsxs(Box, { children: [
-    jsxs(Text, { bold: true, children: [
-      message,
-      " "
-    ] }),
-    jsx(
-      ConfirmInput,
-      {
-        defaultChoice: defaultYes ? "confirm" : "cancel",
-        onCancel: () => {
-          commit(false);
-        },
-        onConfirm: () => {
-          commit(true);
-        }
-      }
-    )
-  ] }) });
-};
-const tuiConfirm = async (message, options) => {
-  const defaultYes = options?.defaultYes === true;
-  if (!isInteractive()) {
-    return defaultYes;
-  }
-  return runInkPrompt((finish) => jsx(ConfirmView, { defaultYes, finish, message }), false);
-};
-const createTuiConfirm = () => isInteractive() ? (message) => tuiConfirm(message, { defaultYes: true }) : () => Promise.resolve(false);
-const SelfExit = ({ children }) => {
-  const { exit } = useApp();
-  useEffect(() => {
-    exit();
-  }, [exit]);
-  return children;
-};
-const printFrame = async (element) => {
-  const instance = render(jsx(SelfExit, { children: element }));
-  try {
-    await instance.waitUntilExit();
-  } catch {
-  } finally {
-    instance.unmount();
-  }
-};
-const tuiIntro = async (message) => {
-  if (!isInteractive()) {
-    return;
-  }
-  await printFrame(
-    jsxs(Box, { borderColor: ACCENT, borderStyle: "round", paddingX: 1, children: [
-      jsxs(Text, { bold: true, color: ACCENT, children: [
-        "◆ Lunora",
-        " "
-      ] }),
-      jsx(Text, { children: message })
-    ] })
-  );
-};
-const tuiOutro = async (message) => {
-  if (!isInteractive()) {
-    return;
-  }
-  await printFrame(
-    jsxs(Box, { paddingX: 1, children: [
-      jsx(Text, { color: "green", children: "✔ " }),
-      jsx(Text, { children: message })
-    ] })
-  );
-};
-const tuiBanner = async (subtitle) => {
-  if (!isInteractive()) {
-    return;
-  }
-  await printFrame(
-    jsxs(Box, { flexDirection: "column", paddingX: 1, children: [
-      jsx(BigText, { colors: [ACCENT], font: "tiny", space: false, text: "LUNORA" }),
-      jsx(Text, { dimColor: true, children: subtitle })
-    ] })
-  );
-};
-const SpinnerView = ({ label }) => jsxs(Box, { children: [
-  jsx(Text, { color: ACCENT, children: jsx(Spinner, { type: "dots" }) }),
-  jsxs(Text, { children: [
-    " ",
-    label
-  ] })
-] });
-const withTuiSpinner = async (label, task) => {
-  if (!isInteractive()) {
-    return task();
-  }
-  const instance = render(jsx(SpinnerView, { label }));
-  try {
-    return await task();
-  } finally {
-    instance.unmount();
-  }
-};
-
-export { tuiSelect as a, tuiConfirm as b, createTuiConfirm as c, tuiOutro as d, tuiBanner as e, tuiIntro as f, tuiMultiSelect as g, tuiText as t, withTuiSpinner as w };