@lunora/cli 1.0.0-alpha.58 → 1.0.0-alpha.59

package/dist/packem_shared/{COMMANDS-DsWLzOXZ.mjs → COMMANDS-0BD3K1pb.mjs}

@@ -4,7 +4,7 @@ import { createCerebro } from '@visulima/cerebro';
 import completionCommand from '@visulima/cerebro/command/completion';
 import versionCommand from '@visulima/cerebro/command/version';
 import { A as API_SPEC_HELP } from './api-spec-Bx0iKbxA.mjs';
-import { createLogger } from './createLogger-B40gPzQo.mjs';
+import { createLogger } from './createLogger-CIWSHrTL.mjs';
 import { VisulimaError, renderError } from '@visulima/error';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
@@ -215,9 +215,19 @@ const deploymentsCommand = {
 };
 
 const devCommand = {
+  argument: {
+    description: "Optional subcommand: stop (shut the running dev server down) | status (report it) | logs (print its captured output)",
+    name: "args",
+    type: String
+  },
   description: "Run the dev stack: wrangler worker + studio + codegen watch",
   examples: [
     ["lunora dev", "Run the worker + studio + codegen watch"],
+    ["lunora dev --background", "Run detached: blocks until ready, prints URL + PID, then returns"],
+    ["lunora dev stop", "Stop the background/tracked dev server (idempotent)"],
+    ["lunora dev status", "Report the running dev server (URL, PID, uptime)"],
+    ["lunora dev logs", "Print the captured dev-server log (background runs)"],
+    ["lunora dev --json", "Machine-readable JSON log lines (also LUNORA_LOG_JSON=1)"],
     ["lunora dev --no-studio", "Skip the embedded studio server"],
     ["lunora dev --worker-port 8080", "Use a custom wrangler dev port"],
     ["lunora dev --remote", "Proxy D1/KV/R2 to the deployed worker (also LUNORA_REMOTE=1)"]
@@ -227,10 +237,19 @@ const devCommand = {
     return { default: m.execute };
   }),
   name: "dev",
+  // KEEP IN SYNC with `daemonArguments` in `./lifecycle.ts`: a new flag that
+  // must reach a `--background` daemon has to be forwarded there explicitly.
   options: [
     { description: `Which API spec(s) codegen emits: ${API_SPEC_HELP} (default openapi)`, name: "api-spec", type: String },
     { description: "Studio server port (default 6173)", name: "port", type: Number },
     { description: "wrangler dev port (default 8787)", name: "worker-port", type: Number },
+    {
+      description: "Run the dev server as a managed background process (auto-enabled when an AI agent is detected; LUNORA_AGENT_MODE=0 disables)",
+      name: "background",
+      type: Boolean
+    },
+    { description: "Emit machine-readable JSON log lines (also LUNORA_LOG_JSON=1; auto-enabled for AI agents)", name: "json", type: Boolean },
+    { description: "How many trailing lines `lunora dev logs` prints (default 100, 0 = all)", name: "lines", type: Number },
     { description: "Don't start the embedded studio server", name: "no-studio", type: Boolean },
     { description: "Don't watch + regenerate codegen", name: "no-codegen", type: Boolean },
     { description: "Proxy D1/KV/R2 bindings to the deployed worker (or set LUNORA_REMOTE=1)", name: "remote", type: Boolean }

package/dist/packem_shared/{command-D3lB_4Az.mjs → command-lYnl4QyF.mjs}

@@ -1,4 +1,4 @@
-import { createLogger } from './createLogger-B40gPzQo.mjs';
+import { createLogger } from './createLogger-CIWSHrTL.mjs';
 import { P as PromptCancelledError, a as PROMPT_CANCEL_EXIT_CODE } from './prompt-cancelled-APzX1Im-.mjs';
 
 const defineHandler = (body) => async (toolbox) => {

package/dist/packem_shared/{createLogger-B40gPzQo.mjs → createLogger-CIWSHrTL.mjs}

@@ -2,19 +2,46 @@ import { STEP_BADGE_NAMES, LunoraReporter } from '@lunora/config';
 import { JsonReporter } from '@visulima/pail/reporter/json';
 import { createPail } from '@visulima/pail/server';
 
+let sharedPail;
+let jsonForced = false;
+let configuredReporters;
 const wantJson = () => {
+  if (jsonForced) {
+    return true;
+  }
   const flag = process.env.LUNORA_LOG_JSON;
   return flag === "1" || flag === "true";
 };
-const buildReporter = () => {
-  const Reporter = wantJson() ? JsonReporter : LunoraReporter;
-  return new Reporter();
+const constructReporter = (Reporter) => new Reporter();
+const buildReporters = () => {
+  if (jsonForced) {
+    return [constructReporter(JsonReporter)];
+  }
+  if (configuredReporters !== void 0 && configuredReporters.length > 0) {
+    return configuredReporters;
+  }
+  return [constructReporter(wantJson() ? JsonReporter : LunoraReporter)];
+};
+const forceJsonLogging = () => {
+  if (jsonForced) {
+    return;
+  }
+  jsonForced = true;
+  sharedPail = void 0;
+};
+const logHandlers = {
+  compose: (...reporters) => reporters,
+  console: () => constructReporter(LunoraReporter),
+  json: () => constructReporter(JsonReporter)
+};
+const configureLogHandlers = (reporters) => {
+  configuredReporters = Array.isArray(reporters) ? reporters : [reporters];
+  sharedPail = void 0;
 };
 const STEP_LOG_TYPES = Object.fromEntries(STEP_BADGE_NAMES.map((name) => [name, { label: name, logLevel: "informational" }]));
-let sharedPail;
 const getPail = () => {
   sharedPail ??= createPail({
-    reporters: [buildReporter()],
+    reporters: buildReporters(),
     scope: ["lunora"],
     stderr: process.stderr,
     stdout: process.stdout,
@@ -75,4 +102,4 @@ const logStep = (type, message) => {
   getPail()[type](message);
 };
 
-export { createLogger, createStderrLogger, getPail, logStep, pail };
+export { configureLogHandlers, createLogger, createStderrLogger, forceJsonLogging, getPail, logHandlers, logStep, pail };

package/dist/packem_shared/{createRecordingSpawner-DxI3mebw.mjs → createRecordingSpawner-Cw5Iu73G.mjs}

@@ -1,5 +1,13 @@
 import { spawn } from 'node:child_process';
 
+const NEEDS_CMD_QUOTING = /\s/;
+const spawnShellCompat = (command, args, platform = process.platform) => {
+  if (platform !== "win32" || command === process.execPath) {
+    return { args: [...args], command, shell: false };
+  }
+  const quote = (value) => NEEDS_CMD_QUOTING.test(value) ? `"${value}"` : value;
+  return { args: args.map((argument) => quote(argument)), command: quote(command), shell: true };
+};
 const defaultSpawner = (descriptor) => new Promise((resolve, reject) => {
   const hasInput = typeof descriptor.input === "string";
   const wantCapture = descriptor.captureStdout === true;
@@ -9,9 +17,11 @@ const defaultSpawner = (descriptor) => new Promise((resolve, reject) => {
   } else if (descriptor.stdoutToStderr) {
     stdout = 2;
   }
-  const child = spawn(descriptor.command, [...descriptor.args], {
+  const exec = spawnShellCompat(descriptor.command, descriptor.args);
+  const child = spawn(exec.command, exec.args, {
     cwd: descriptor.cwd ?? process.cwd(),
     env: descriptor.env ? { ...process.env, ...descriptor.env } : process.env,
+    shell: exec.shell,
     stdio: [hasInput ? "pipe" : "inherit", stdout, "inherit"]
   });
   let captured = "";
@@ -40,4 +50,4 @@ const createRecordingSpawner = (exitCode = 0) => {
   return { calls, spawner };
 };
 
-export { createRecordingSpawner, defaultSpawner };
+export { createRecordingSpawner, defaultSpawner, spawnShellCompat };

package/dist/packem_shared/{output-format-wUvAN6AL.mjs → output-format-B4642rjE.mjs}

@@ -1,4 +1,4 @@
-import { createStderrLogger } from './createLogger-B40gPzQo.mjs';
+import { createStderrLogger } from './createLogger-CIWSHrTL.mjs';
 
 const OUTPUT_FORMATS = /* @__PURE__ */ new Set(["json", "pretty"]);
 const validateOutputFormat = (command, format) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/cli",
-  "version": "1.0.0-alpha.58",
+  "version": "1.0.0-alpha.59",
   "description": "The Lunora CLI: init, dev, deploy, codegen, run, reset, and migrate commands",
   "keywords": [
     "agent-skills",
@@ -53,7 +53,7 @@
   "dependencies": {
     "@bomb.sh/tab": "0.0.17",
     "@lunora/codegen": "1.0.0-alpha.29",
-    "@lunora/config": "1.0.0-alpha.46",
+    "@lunora/config": "1.0.0-alpha.47",
     "@lunora/container": "1.0.0-alpha.6",
     "@lunora/d1": "1.0.0-alpha.22",
     "@lunora/errors": "1.0.0-alpha.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.