@lunora/cli 1.0.0-alpha.8 → 1.0.0-alpha.81

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/cli",
-  "version": "1.0.0-alpha.8",
+  "version": "1.0.0-alpha.81",
   "description": "The Lunora CLI: init, dev, deploy, codegen, run, reset, and migrate commands",
   "keywords": [
     "agent-skills",
@@ -51,18 +51,21 @@
     "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.18",
+    "@lunora/codegen": "1.0.0-alpha.40",
+    "@lunora/config": "1.0.0-alpha.62",
+    "@lunora/container": "1.0.0-alpha.9",
+    "@lunora/d1": "1.0.0-alpha.26",
+    "@lunora/errors": "1.0.0-alpha.4",
+    "@lunora/seed": "1.0.0-alpha.22",
+    "@visulima/cerebro": "3.0.0",
+    "@visulima/error": "6.0.0",
+    "@visulima/fs": "5.0.0",
+    "@visulima/package": "5.0.0",
+    "@visulima/pail": "4.0.0",
+    "@visulima/path": "3.0.0",
+    "@visulima/spinner": "1.0.0",
+    "@visulima/tui": "1.0.0",
     "cfonts": "^3.3.1",
     "giget": "3.3.0",
     "jsonc-parser": "^3.3.1",

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)
@@ -87,7 +90,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 +255,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/skills/lunora-setup-storage/SKILL.md

@@ -41,7 +41,7 @@ This:
 1. Adds `@lunora/storage` and `@lunora/server` to `package.json` (run
    `pnpm install` afterwards).
 2. Adds an R2 bucket binding to `wrangler.jsonc` (`r2_buckets`, binding
-   **`UPLOADS`**, `bucket_name: "REPLACE_ME-uploads"` — rename it to a real
+   **`UPLOADS`**, `bucket_name: "replace-me-uploads"` — rename it to a real
    bucket). It **merges** into any existing `r2_buckets`.
 3. Scaffolds `STORAGE_SIGNING_SECRET` (a secret) and `STORAGE_PUBLIC_BASE_URL`
    into `.dev.vars`.
@@ -137,8 +137,12 @@ persist that, and pass the bare key back in — the component re-scopes it.
 
 1. **Skipping `verifySignedUrl` on the download route.** Without it, anyone can
    read any key. Always verify before streaming.
-2. **Placeholder bucket name.** `bucket_name: "REPLACE_ME-uploads"` ships as a
-   placeholder — rename it to a real R2 bucket.
+2. **Placeholder bucket name.** `lunora init` and `lunora add storage` prompt for
+   the bucket name (or take `--bucket <name>`), but the low-level
+   `lunora registry add storage` writes the placeholder
+   `bucket_name: "replace-me-uploads"` — rename it to a real R2 bucket. (R2 names
+   are lowercase alphanumeric + hyphens, 3–63 chars; wrangler rejects anything
+   else on `dev`/`deploy`.)
 3. **Short / shared signing secret.** Use ≥32 chars and a distinct secret per
    bucket; reusing it lets one bucket's URLs sign for another.
 4. **Proxying bytes through the Worker.** The design uploads/downloads directly

package/dist/packem_shared/features-ocSSpZtS.mjs

@@ -1,24 +0,0 @@
-const AUTH_PROVIDER_OPTIONS = [
-  { description: "Email + password on better-auth (default)", label: "Email & password", value: "auth" },
-  { description: "Clerk-hosted auth", label: "Clerk", value: "auth-clerk" },
-  { description: "Auth0 (OIDC)", label: "Auth0", value: "auth-auth0" }
-];
-const DEFAULT_AUTH_ITEM = "auth";
-const promptAuthProvider = async (select) => await select("Which auth provider?", AUTH_PROVIDER_OPTIONS, { default: DEFAULT_AUTH_ITEM }) ?? DEFAULT_AUTH_ITEM;
-const EMAIL_ITEM = "mail";
-const normalizeFeature = (raw) => {
-  const value = raw.trim();
-  if (value === "") {
-    return void 0;
-  }
-  const lower = value.toLowerCase();
-  if (lower === "auth") {
-    return { kind: "auth" };
-  }
-  if (lower === "email" || lower === "mail") {
-    return { kind: "email" };
-  }
-  return { item: lower, kind: "item" };
-};
-
-export { AUTH_PROVIDER_OPTIONS as A, DEFAULT_AUTH_ITEM as D, EMAIL_ITEM as E, normalizeFeature as n, promptAuthProvider as p };

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-G544_v6e.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-DqsEzojt.mjs';
-import './buildRegistryIndex-BcYe607_.mjs';

package/dist/packem_shared/tui-prompts-XHFxlOg5.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 { tuiConfirm as a, tuiOutro as b, createTuiConfirm as c, tuiBanner as d, tuiText as e, tuiIntro as f, tuiMultiSelect as g, tuiSelect as t, withTuiSpinner as w };