@enterpriseai/cli 3.8.2 → 3.9.0

package/README.md

@@ -93,45 +93,51 @@ npm install -g ./docs-site/static/registry/-/@enterpriseai/cli-latest.tgz
 ## Quick Start
 
 ```bash
-# 1. Create a new app
-eai init my-app
+# 1. Run the guided first-time setup
+eai create my-app
 cd my-app
-npm install
 
-# 2. Authenticate
-eai login
+# `eai create` checks local tooling, signs you in, confirms the signup
+# workspace, creates the app, installs dependencies, verifies Gofer, and
+# checks builder readiness. Use `/0_business_scenario` in your AI tool when
+# it finishes. Pass `--no-install` to skip the install and run
+# `npm install` yourself.
 
-# 3. Choose the tenant to work with
+# 2. For an existing login or automation, use the lower-level commands:
+eai whoami
 eai tenant select
 
-# 4. Create child tenants only when you need them
+# 3. Create child tenants only when you need them
 #    `eai tenant create --parent <id>` now creates the tenant record,
 #    attempts first-admin bootstrap for the current login, and only marks
 #    the tenant usable after direct tenant-admin membership is confirmed.
 #    The child home region defaults to the parent region; pass
 #    `--home-region au|ca|eu` when the child must use another region.
 
-# 5. Sync project environment if your app needs local configuration
+# 4. Sync project environment if your app needs local configuration
 eai env pull --include-secrets
 
-# 6. Define your data model
+# 5. Define your data model
 #    Edit src/eai.config/object-types.ts
 
-# 7. Validate and seed
+# 6. Validate and seed
 eai types validate
 eai types seed
 
-# 8. Start developing
+# 7. Start developing
 eai dev
 ```
 
-`eai init` installs Gofer AI terminal assets by default. New app repos include
+`eai create` installs Gofer AI terminal assets by default. New app repos include
 Claude commands and agents, Codex skills, Gemini commands, Copilot prompts and
 CLI skills, and the `.specify` commands/scripts/templates/hooks required to run
 the Gofer pipeline.
-Use `eai init my-app --no-gofer` only when you need a bare scaffold.
+Use `eai create my-app --no-gofer` only when you need a bare scaffold. `eai init`
+remains available as the low-level, backwards-compatible scaffold command.
+Use `eai create my-app --skip-onboarding` when you want the old init prompts
+without the first-run checks.
 
-By default, `eai init my-app` creates a new `./my-app` folder. If you already
+By default, `eai create my-app` creates a new `./my-app` folder. If you already
 created and entered a project folder, run `eai init`, enter the app name, and
 answer yes when asked to use the current folder. For automation, pass
 `--current-dir` with the kebab-case app name. Current-folder init preserves
@@ -157,7 +163,8 @@ All commands support these global flags:
 
 | Command | Description |
 |---------|-------------|
-| `eai init [name]` | Interactive scaffold from the CLI-pinned public EAI application template with Gofer AI CLI assets |
+| `eai create [name]` | Guided first-run setup plus scaffold, Gofer verification, and builder readiness check |
+| `eai init [name]` | Low-level backwards-compatible scaffold command |
 | `eai dev` | Start local dev server with connectivity checks |
 
 The bundled default template is pinned to the latest `eai-app-template` `main`

package/dist/commands/init.d.ts

@@ -2,6 +2,11 @@
  * eai init — scaffold a new application from the template.
  */
 import { Command } from "commander";
+import { resolveActiveTenantContext } from "../lib/tenant-context.js";
+import { type ParsedApiError } from "../lib/api.js";
+export declare function describeAppCreationFailure(error: ParsedApiError): string;
+export declare function describeCreateFlowFailure(error: unknown): string;
+type CreateAiTool = "codex" | "claude" | "vscode" | "gemini";
 export interface TemplateClonePlan {
     readonly cloneSource: string;
     readonly displaySource: string;
@@ -10,5 +15,69 @@ export interface TemplateClonePlan {
 export declare function describeCloneFailure(templateSource: string, error: unknown): string;
 export declare function isDefaultTemplateSource(templateSource: string): boolean;
 export declare function resolveTemplateClonePlan(templateSource: string): TemplateClonePlan;
+/**
+ * `--from` accepts any GitHub repo or local path, and install runs after
+ * .env.local has been generated and hydrated. Only the canonical template is
+ * trusted to execute npm lifecycle scripts on the developer machine.
+ */
+export declare function buildTemplateInstallArgs(from: string): string[];
+export declare function consumeLastInitBinding(): InitTenantAppBinding | undefined;
 export declare const initCommand: Command;
+export interface CreateCommandOptions {
+    from: string;
+    skipPrompts: boolean;
+    skipOnboarding: boolean;
+    currentDir: boolean;
+    tenant?: string;
+    companyTenant?: string;
+    parentTenant?: string;
+    childTenant?: string;
+    createChildTenant?: boolean;
+    gofer?: boolean;
+    install?: boolean;
+    packageProfile: string;
+    tool?: string;
+    splash?: boolean;
+}
+interface CreateOnboardingAnswers {
+    name: string;
+    displayName: string;
+    description: string;
+    useCurrentDirectory: boolean;
+    aiTool: CreateAiTool;
+}
+/**
+ * Guided first-run setup matching the public Getting Started flow.
+ *
+ * The legacy `init` command remains the low-level scaffold entry point. This
+ * command owns the first-run experience: local checks, browser auth, tenant
+ * confirmation, non-interactive scaffolding, and the hand-off to Gofer.
+ */
+export declare const createCommand: Command;
+/**
+ * Resolve the workspace for guided create.
+ *
+ * An explicit --company-tenant/--tenant is passed through as `tenantId` so the
+ * membership is validated and the cached active tenant cannot silently replace
+ * the operator's choice on a state-changing app create.
+ */
+export declare function resolveCreateTenantContext(publicApiUrl: string, options: CreateCommandOptions): ReturnType<typeof resolveActiveTenantContext>;
+export declare function buildForwardedInitArgs(nameArg: string | undefined, options: CreateCommandOptions, answers?: CreateOnboardingAnswers, tenantId?: string): string[];
+/**
+ * Next-step copy for guided create. A failed or unchecked builder readiness must
+ * not be presented as a ready workspace, and must not send the builder straight
+ * into a hand-off that is known to be unproven.
+ */
+export declare function buildCreateCompletionSummary(builderReady: boolean, aiTool: CreateAiTool): {
+    heading: string;
+    steps: string[];
+};
+export declare function toKebabCase(value: string): string;
+interface InitTenantAppBinding {
+    parentTenantId: string;
+    runtimeTenantId: string;
+    childTenantId?: string;
+    runtimeTenantHomeRegion?: string | null;
+}
+export {};
 //# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8DpC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAoDD,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,OAAO,GACb,MAAM,CAmCR;AAUD,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,GACrB,iBAAiB,CAmBnB;AAiED,eAAO,MAAM,WAAW,SA0YpB,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}