@geastack/cli 0.1.6 → 0.1.8

package/README.md

@@ -47,7 +47,7 @@ flowchart TD
   install --> setup["Next: npx gea setup"]
 
   auto["Automation flags"] -.-> starter
-  auto --> autoEmpty["--starter empty --yes"]
+  auto --> autoEmpty["--starter blank --yes"]
   auto --> autoExample["--starter example --example watch"]
 ```
 
@@ -157,6 +157,6 @@ First implementation is in place:
 - npm-resolved embedded board builds for ESP32 and RP2350;
 - `flash`, `monitor`, WiFi OTA, and BLE OTA through `@geastack/targets`;
 - `list` and `inspect` helpers;
-- `create-geastack` with a bundled counter starter, an empty starter, and a
+- `create-geastack` with a bundled counter starter, a blank application, and a
   GitHub-backed rich example flow for web, embedded, GeaOS, iOS, macOS, and Android apps,
   all with `.gea/boards.json`.

package/docs/NPX-COMMANDS.md

@@ -69,7 +69,7 @@ Automation can skip prompts:
 
 ```sh
 npx @geastack/create-geastack my-app --starter counter
-npx @geastack/create-geastack my-app --starter empty --yes
+npx @geastack/create-geastack my-app --starter blank --yes
 npx @geastack/create-geastack my-app --starter example --example watch
 npx @geastack/create-geastack my-ios-app --starter example --example ios-native-showcase
 npx gea build --target ios --mode simulator

package/docs/SPEC.md

@@ -120,7 +120,7 @@ or optional dependency is missing.
 Scaffolds a new app folder with:
 
 - `package.json` containing a `gea` manifest;
-- a bundled counter starter, an empty starter, or a selected GitHub example;
+- a bundled counter starter, a blank application, or a selected GitHub example;
 - `index.tsx` or `index.ts`;
 - `tsconfig.json`;
 - `vite.config.ts`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geastack/cli",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "type": "module",
   "description": "Command-line front door for GeaStack apps, targets, and local toolchains.",
   "publishConfig": {

package/src/create-geastack.mjs

@@ -22,9 +22,10 @@ export async function runCreateGeastack(argv, io = {}) {
   const stdout = io.stdout || console.log
   const env = io.env || process.env
   const cwd = io.cwd || process.cwd()
+  const commandName = io.commandName || 'create-geastack'
 
   if (flag(parsed, 'help') || parsed.positionals[0] === 'help') {
-    stdout(usage())
+    stdout(usage(commandName))
     return 0
   }
 
@@ -105,7 +106,7 @@ export async function runCreateGeastack(argv, io = {}) {
   stdout(`Created ${displayName} at ${targetDir}`)
   if (starter.kind === 'bundled') stdout(`Starter: ${starter.starter.name}`)
   else if (starter.kind === 'example') stdout(`Example: fetched ${starter.example.name}`)
-  else stdout('Starter: empty app')
+  else stdout('Starter: blank application')
   if (installDependencies) stdout(`Next: cd ${targetDir} && npx gea setup`)
   else stdout(`Next: cd ${targetDir} && npm install && npx gea setup`)
   return 0
@@ -133,10 +134,10 @@ async function resolveStarter(ctx, parsed, io) {
       return { kind: 'bundled', starter }
     }
     if (mode !== 'example') {
-      fail(`Unknown starter '${mode}'. Expected counter, empty, or example.`, ExitCode.usage)
+      fail(`Unknown starter '${mode}'. Expected counter, blank, or example.`, ExitCode.usage)
     }
     if (examples.length === 0) {
-      fail('No GitHub examples are available. Use --starter counter or --starter empty.', ExitCode.usage)
+      fail('No GitHub examples are available. Use --starter counter or --starter blank.', ExitCode.usage)
     }
 
     const requestedExample = option(parsed, 'example') || option(parsed, 'from-example') || ''
@@ -448,19 +449,28 @@ function ensureJson(filePath, create) {
   if (!exists(filePath)) writeJson(filePath, create())
 }
 
-function usage() {
+function usage(commandName = 'create-geastack') {
   return `Usage:
-  create-geastack <name> [--dir <path>] [--id <app-id>] [--name <display-name>]
+  ${commandName} <name>
+
+Run without options for guided setup. The CLI asks what you want to build and
+derives the source layout, targets, and runtime configuration from your choice.
 
 Options:
-  --starter counter|empty|example
+  --starter counter|blank|example
   --example <example-id>
+  --no-install
+
+Automation options:
+  --dir <path>
+  --id <app-id>
+  --name <display-name>
   --examples-repo <git-url-or-local-path>
   --examples-ref <git-ref>
   --targets web,esp32,rp2350,geaos,macos,ios,android
   --core-dependency <specifier>
   --cli-dependency <specifier>
-  --install / --no-install
+  --install
   --dry-run
   --yes
   --force

package/src/gea.mjs

@@ -40,7 +40,7 @@ export async function runGea(argv, io = {}) {
   if (command === 'create') {
     const createArgs = argv.slice(1)
     if (option(parsed, 'install') === undefined) createArgs.push('--install')
-    return runCreateGeastack(createArgs, io)
+    return runCreateGeastack(createArgs, { ...io, commandName: 'gea create' })
   }
   if (!command || command === 'help' || flag(parsed, 'help')) {
     stdout(usage())