GeezerVison

Summary

ns live [--mac | --electron] [--new] [--no-open] [--allow-eval] [--token <t>]
  LiveCommand.run
    npx --yes @nativescript/edge-cli@latest live <the rest of argv>
      creates a project on preview.nativescript.org, or reopens this folder's (.ns-edge.json)
      opens its browser IDE
      phone:              prints a QR code for NativeScript Preview
      --mac / --electron: runs the app on this Mac, streamed into the IDE
    non-zero exit -> ctx.fail("ns live exited with code N.", { help: false })

ns live is the one-command entry point for live NativeScript projects on Cloudflare (ns-edge). It forwards to @nativescript/edge-cli, the same way ns preview forwards to @nativescript/preview-cli. People without the NativeScript CLI get the same thing with npx nativescript live or npx @nativescript/edge-cli live.

 lib/
 ├── bootstrap.ts                         # registerBuiltInCommand("live", …)
+├── commands/live.ts                     # Command({ name: "live", params: "any", allowUnknownOptions: true })
 docs/man_pages/project/testing/
+└── live.md
 test/commands/
+└── live.ts

Questions for review (why this is a draft):

• @latest or a pinned version? @latest ships live-CLI fixes without a NativeScript CLI release. A pin makes a given ns version reproducible.
• npx or install? ns preview installs its CLI into the project. ns live needs no project and is usually run from an empty folder, so it uses npx and npm's cache.

Evidence

• Tests: test/commands/live.ts covers both paths:
  • ns live --mac --new spawns npx --yes @nativescript/edge-cli@latest live --mac --new.
  • A non-zero exit fails with ns live exited with code 1.
• Against the published live CLI, from an empty folder:

  $ ns live --ios
  --ios isn't available yet. Run `live` for a phone app or `live --mac` for a Mac app.
  ns live exited with code 1.
  

• The live CLI itself, checked on production: live, live --mac and live --electron each created a free project from an empty folder.
  • The phone project printed a QR code for NativeScript Preview.
  • The Mac app rendered in 259 ms.
  • The Electron app rendered in 2.4 s and streamed to the IDE at 25 fps.
• ns live --help renders the new man page.

Merge Danger

Door: two-way

A new command name; nothing existing changes.

Blast Radius: additive

live becomes a reserved command name, so an extension that registers its own live command would now collide with it.