@jigx/sdk-tools 1.2.0-next.1 → 1.2.0-next.3

package/README.md

@@ -1,69 +1,34 @@
 # @jigx/sdk-tools
 
-CLI for solution-designers to scaffold, build, and deploy Jigx Applications. Provides the `jigx` command with `create`, `build`, `login`, `init`, `deploy`, `whoami`, and `logout` verbs, backed by `@jigx/core-sdk` builders.
+`jigx` CLI for solution designers to scaffold, build, and deploy Jigx Applications (backed by `@jigx/core-sdk` builders).
 
 ## Requirements
 
-- **Node.js ≥22** — install from [nodejs.org](https://nodejs.org/) or `brew install node`.
+Node.js >=22. `jigx create` runs `npm install` in the new project; swap to yarn/pnpm afterwards if preferred.
 
-No package manager is required globally: `jigx create` runs `npm install` (which ships with Node) inside the new project. After scaffolding you can swap to yarn or pnpm in that project if you prefer.
-
-## Onboarding
+## Quick start
 
 ```bash
-npm i -g @jigx/sdk-tools@next    # 1. one-time per machine: puts `jigx` on PATH
-jigx create                       # 2. prompts → scaffolds <cwd>/<applicationName>, runs npm install
+npm i -g @jigx/sdk-tools@next    # once per machine
+jigx create                       # scaffolds <cwd>/<applicationName>
 cd <applicationName>
-jigx deploy                       # 3. first run: interactive login + init, then deploys to prod
+jigx deploy                       # first run: login + init inline, then deploy to prod
 ```
 
-On first `jigx deploy`, the CLI:
-
-1. Detects no cached **RefreshToken** and runs `jigx login` inline (Cognito email + password). Stores the refresh token at `~/.jigx/refresh-tokens.json`.
-2. Detects no **OrganizationBinding** in `<projectRoot>/jigx.json` and runs `jigx init` inline (Organization picker). Writes the binding to `jigx.json`.
-3. Builds, then deploys content to the prod environment.
-
-Subsequent deploys reuse both artifacts and skip straight to build + deploy. Pass `--env dev` to target staging, `--env clf-dev` for the Cloudflare dev stamp, or `--env clf-prod` for the Cloudflare prod stamp.
-
-## Commands
-
-| Command | What it does |
-| --- | --- |
-| `jigx create` | Prompts for Title → Name → Type, scaffolds a new Application project, runs `npm install`. |
-| `jigx build` | Compiles `src/app.ts` into `build/output.json` plus the canonical Builder folder layout under `build/app/` for inspection. |
-| `jigx login` | Signs in to Cognito (interactive email + password) and caches a refresh token in `~/.jigx/refresh-tokens.json`. |
-| `jigx init` | Picks an Organization for the current environment and writes the binding to `<projectRoot>/jigx.json`. |
-| `jigx deploy` | Builds, then deploys content. Defaults to prod. Pass `--env dev` for staging, `--env clf-dev` for the Cloudflare dev stamp, or `--env clf-prod` for the Cloudflare prod stamp. Auto-runs `jigx login` and `jigx init` if needed (TTY only). |
-| `jigx whoami` | Prints the live User identity and the project's Organization binding for the chosen environment. |
-| `jigx logout` | Clears cached refresh tokens for one env or all envs. |
-
-## Auth model
-
-Three commands compose the auth flow:
+Commands: `create`, `build`, `login`, `init`, `deploy`, `whoami`, `logout`. Run `jigx --help` for options.
 
-1. **`jigx login`** — interactive Cognito SRP sign-in. Stores a long-lived refresh token at `~/.jigx/refresh-tokens.json`, file mode `0o600`, dir mode `0o700`. Keyed by `<env>:<userPoolId>` so dev and prod entries never collide.
-2. **`jigx init`** — picks an Organization from the User's memberships and writes `<projectRoot>/jigx.json` (`{ "<env>": { "organizationId": "..." } }`). `jigx.json` is a per-project, per-environment binding and is intentionally committable — multiple developers on the same project share the same Organization mapping.
-3. **`jigx deploy`** — refreshes a Cognito ID token from the cached refresh token, looks up the Organization in `jigx.json`, and `Bearer`s the ID token at the Strata API.
+`--env dev` (staging), `--env clf-dev`, `--env clf-prod` target other environments; default is prod. `jigx init --org <id>` skips the Organization picker.
 
-In TTY mode, `jigx deploy` fills in missing pieces inline by invoking `jigx login` or `jigx init` as needed. In non-TTY mode (CI), missing pieces surface as typed errors naming the exact command to run.
+## Auth
 
-## Limitations
+- `jigx login`: Cognito email + password; refresh token cached at `~/.jigx/refresh-tokens.json` (keyed per env).
+- `jigx init`: writes the Organization binding to `<projectRoot>/jigx.json` (per env, safe to commit).
+- `jigx deploy` runs login/init inline when missing (TTY only). Non-TTY (CI) fails with the command to run.
 
-- **No CI / non-interactive auth.** The auth flow assumes a TTY for the email + password prompt. There is no service-account / API-key path. CI deploys must pre-populate `~/.jigx/refresh-tokens.json` from a prior interactive `jigx login` (out of scope for the CLI).
-- **No SSO.** Users whose Jigx accounts are managed by an external IdP cannot use `jigx login` today.
-
-See [ADR-0002](../../docs/adr/0002-sdk-tools-cognito-only-auth.md) for the rationale.
+Limitations: no CI/non-interactive auth (pre-populate `~/.jigx/refresh-tokens.json` from an interactive login), no SSO. Rationale: [ADR-0002](../../docs/adr/0002-sdk-tools-cognito-only-auth.md).
 
 ## Troubleshooting
 
-### `jigx: command not found`
-
-`@jigx/sdk-tools` is not installed globally. Run `npm i -g @jigx/sdk-tools@next` and retry.
-
-### `Not authenticated. Run jigx login.`
-
-`~/.jigx/refresh-tokens.json` is missing or the cached refresh token has expired/been revoked. Run `jigx login` (add `--env dev` for staging or `--env clf-dev` for the Cloudflare dev stamp) and retry.
-
-### `No Organization configured for env "<env>".`
-
-`<projectRoot>/jigx.json` has no binding for the requested environment. Run `jigx init` (add `--env dev` for staging or `--env clf-dev` for the Cloudflare dev stamp, optionally `--org <id>` to skip the picker).
+- `jigx: command not found`: install globally (above).
+- `Not authenticated. Run jigx login.`: refresh token missing/expired/revoked; run `jigx login` (with the same `--env`).
+- `No Organization configured for env "<env>".`: run `jigx init` (with the same `--env`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jigx/sdk-tools",
-  "version": "1.2.0-next.1",
+  "version": "1.2.0-next.3",
   "description": "Jigx SDK toolkit (jigx CLI) — scaffold, build, and publish Jigx Application projects",
   "license": "ISC",
   "type": "module",
@@ -68,7 +68,7 @@
     "oxfmt": "*",
     "oxlint": "*",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.11"
   },
   "publishConfig": {
     "access": "public",