fabrica-e-commerce 0.2.2 → 0.2.4

package/README.md

@@ -1,122 +1,157 @@
 # fabrica-e-commerce
 
-Orange themed NPX CLI for launching a Fabrica e-commerce storefront from CMD or any terminal.
+Orange-themed NPX CLI for launching a Fabrica e-commerce storefront (Supabase + Vercel + Next.js) from any terminal — Windows, macOS, Linux, and Termux (no root required).
 
-## Install / run
+## Quick start
 
 ```bash
-npx fabrica-e-commerce help
 npx fabrica-e-commerce build
 ```
 
-The package exposes both `fabrica` and `fabrica-e-commerce` binaries after global install.
+Or install globally:
 
 ```bash
 npm install -g fabrica-e-commerce
 fabrica build
 ```
 
+Both `fabrica` and `fabrica-e-commerce` binaries are available after a global install.
 
-## Local NPX-style package test
+---
 
-Before publishing, test the package exactly like a fresh command-line install:
+## Commands
 
-```bash
-npm run build
-npm pack --dry-run
-npm exec --yes --package . -- fabrica help
-npm exec --yes --package . -- fabrica info
-```
+| Command | Description |
+|---------|-------------|
+| `build` | Full deploy wizard — Supabase → secrets → admin password → clone → Vercel or local |
+| `list`  | Show all projects and view details |
+| `env`   | Update environment variables for any project |
+| `rerun` | Re-open or restart an existing project |
+| `vins`  | Verify and auto-install CLI dependencies (git, gh, vercel) |
+| `clean` | Remove local data, env files, or logout from Vercel / GitHub |
+| `info`  | Package, bridge, repo, and storage info |
+| `help`  | Show the command guide |
 
-You can also run the bundled pack test, which creates a real `.tgz` tarball and executes the installed binary from that tarball:
+---
 
-```bash
-npm run test:pack
-```
+## Build flow (6 steps)
 
-On Windows CMD, these commands do not require Unix tools such as `find` or `xargs`; the build script uses a Node.js checker instead.
+### Step 1 — Dependency check
+Verifies `git` is installed. Auto-installs it if missing.
 
-## Commands
+### Step 2 — Supabase connect
+Posts your schema/seed SQL to the Fabrica bridge (`sparrow-supabase-connect.lovable.app`), opens the OAuth connect URL in your browser, and polls until the Supabase project is provisioned and returns `{ url, anonKey }`.
+
+### Step 3 — Environment variables
+Prompts for your API keys:
+
+| Variable | Purpose |
+|----------|---------|
+| `RAZORPAY_KEY_ID` | Razorpay payment key ID |
+| `RAZORPAY_KEY_SECRET` | Razorpay payment secret |
+| `OPENROUTER_API_KEY` | OpenRouter AI API key |
+| `UMAMI_WEBSITE_ID` | Umami analytics website ID |
+| `UMAMI_API_KEY` | Umami analytics API key |
+| `SHIPPO_API_KEY` | Shippo shipping API key |
+
+`SUPABASE_URL` and `SUPABASE_ANON_KEY` are filled automatically from the bridge response.
+
+### Step 4 — Admin password
+Prompts for a password to protect your store's admin and edit panel. Stored as the `PASS` environment variable.
+
+### Step 5 — Clone storefront
+Clones `https://github.com/trucount/fabrica-final-e-c.git` into a local builds directory. Asks for a project name (used as the Vercel project name).
+
+### Step 6 — Deploy target
+Choose how to run your store:
+
+**Local mode**
+- Writes all collected variables to `.env.local` inside the cloned app.
+- Runs `pnpm install` (or `npm install`) and starts the Next.js dev server at `http://localhost:3000`.
 
-- `build` — checks Git, creates a Fabrica Connect Supabase job, opens the OAuth bridge, asks for required secrets, clones `https://github.com/trucount/fabrica-final-e-c.git`, then asks whether to run locally or deploy on Vercel. Local mode writes `.env.local`, installs dependencies, and starts the Next.js dev server. Vercel mode checks GitHub/Vercel dependencies, verifies/logs in to Vercel, creates a user-owned repo from the hardcoded storefront source (fork/template, not `git push`), connects Vercel to that repo, writes every environment variable to production/preview/development, and deploys with `vercel --prod`.
-- `list` — shows locally saved deployments and lets you replace a saved project's Vercel environment variable (across production, preview, and development), then redeploys.
-- `vins` — verifies the CLI's external dependencies (`git`, GitHub CLI `gh`, and the Vercel CLI via `npx`) and automatically installs anything missing using your system's package manager (`apt-get`/`dnf`/`pacman` on Linux, `brew` on macOS, `winget`/`choco` on Windows). Prints manual install links for anything it can't install automatically.
-- `info` / `.info` — prints package, bridge, repository, and local data paths.
-- `help` — prints the command guide.
-
-## Build flow
-
-1. Posts the hidden schema/seed SQL to `https://sparrow-supabase-connect.lovable.app/api/public/jobs` using the configured bridge API key.
-2. Opens the returned `connectUrl` in the browser and polls until `{ status: "done", url, anonKey }` is returned.
-3. Prompts for user-owned secrets:
-   - `RAZORPAY_KEY_ID`
-   - `RAZORPAY_KEY_SECRET`
-   - `OPENROUTER_API_KEY`
-   - `UMAMI_WEBSITE_ID`
-   - `UMAMI_API_KEY`
-   - `SHIPPO_API_KEY`
-4. Adds hardcoded values requested by the project:
-   - `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=0000`
-   - `UMAMI_API_CLIENT_ENDPOINT=https://api.umami.is/v1`
-   - `SUPABASE_SERVICE_ROLE_KEY=0000`
-5. Adds `SUPABASE_URL` and `SUPABASE_ANON_KEY` from the bridge response.
-6. **Step 3 — run target:**
-   - Asks whether to run the storefront **locally** or deploy on **Vercel cloud**.
-   - Local mode writes every collected variable to `.env.local` inside the cloned Next.js app, installs dependencies (`pnpm install` when available, otherwise `npm install`), and starts `pnpm run dev`/`npm run dev` at `http://localhost:3000`.
-   - Vercel mode verifies you're logged in to Vercel (`vercel whoami`); if not, runs an interactive `vercel login` and waits for it to finish.
-   - Vercel mode logs in to the GitHub CLI if needed (`gh auth login`) and creates a user-owned repo from the hardcoded storefront source with a fork/template flow, avoiding local `git push` credentials.
-   - Vercel mode links a new Vercel project with `vercel link --yes --project <name>` and connects it to the new GitHub repo with `vercel git connect` so future pushes auto-deploy.
-   - Vercel mode writes every collected environment variable (including the Supabase URL/anon key) to the **production, preview, and development** environments with `vercel env add`, so the values are permanent for the project, not just the first deploy.
-   - Vercel mode creates the production deployment with `vercel --prod --yes`.
-
-## Dependency check (`vins`)
-
-Run `npx fabrica-e-commerce vins` any time to verify the tools the CLI depends on:
+**Vercel cloud mode**
+- Checks and installs `gh` (GitHub CLI) and `vercel` CLI if missing.
+- Logs in to Vercel interactively if needed.
+- Logs in to GitHub CLI if needed and forks the storefront to a new user-owned repo.
+- Links a new Vercel project and connects it to the GitHub repo for auto-deploys.
+- Writes every environment variable to **production, preview, and development** environments with `vercel env add`.
+- Deploys with `vercel --prod`.
+
+---
+
+## Dependency installer (`vins`)
+
+`vins` checks for `git`, `gh`, and the Vercel CLI and auto-installs anything missing — **no root or admin required** on any platform.
 
 ```bash
 npx fabrica-e-commerce vins
 ```
 
-It checks for `git`, the GitHub CLI (`gh`), and the Vercel CLI (via `npx`), and tries to install anything missing using the right package manager for your OS. If a tool can't be installed automatically (for example, no package manager is available), it prints a manual install link and exits with a non-zero status so scripts can detect the failure.
+| Platform | Install strategy |
+|----------|-----------------|
+| **Termux** | `pkg install` — no root needed |
+| **Linux (no root)** | Homebrew/Linuxbrew → system pkg manager (tries without sudo first) → conda/mamba → binary download from GitHub releases |
+| **Linux (with sudo)** | apt-get / dnf / yum / pacman / zypper / apk |
+| **macOS** | `brew install` → auto-installs Homebrew if missing → binary download |
+| **Windows (no admin)** | `winget --scope user` → auto-installs Scoop → `scoop install` → Chocolatey |
 
+If a tool still can't be installed automatically, `vins` prints the correct manual install command for your platform and exits with a non-zero status.
 
+---
 
-## Windows Vercel command note
+## Managing projects
 
-The CLI runs npm-launched commands through `npx.cmd` on Windows, so `npx vercel@latest ...` works from CMD and PowerShell instead of failing with `'vercel@latest' is not recognized`. If you still see Vercel login prompts, complete them in the browser and rerun the command.
+### `list`
+Shows all projects saved locally with their type (local/cloud), creation date, GitHub repo, Supabase URL, and live URL.
 
-## Automatic npm publishing from GitHub
+### `env`
+Lets you update any environment variable for a saved project. For local projects it rewrites `.env.local`. For cloud projects it updates Vercel (production, preview, development) and triggers a redeploy.
 
-The repository includes a GitHub Actions workflow at `.github/workflows/npm-publish.yml` that verifies the CLI and publishes it to npm on pushes to `main`, `master`, or `work`, and can also be started manually from the Actions tab.
+### `rerun`
+- **Local projects** — restarts the dev server at `http://localhost:3000`.
+- **Cloud projects** — opens the production URL in your browser.
 
-Before the workflow can publish, add an npm automation token to your GitHub repository secrets:
+### `clean`
+Offers four modes: delete local project records, wipe env files, logout from Vercel, logout from GitHub, or a full reset of all of the above.
 
-1. Create an npm token with publish permissions from your npm account.
-2. In GitHub, open **Settings → Secrets and variables → Actions**.
-3. Add a repository secret named `NPM_TOKEN` with that npm token.
+---
 
-On every publish run, the workflow:
+## Local project records
 
-1. Runs `npm run build`.
-2. Runs `npm run test:cli`.
-3. Runs `npm run test:pack`.
-4. Checks the current latest version on npm and bumps `package.json` to the next patch version when needed.
-5. Runs `npm publish --access public --provenance`.
-6. Commits the published version back to GitHub with `[skip npm-publish]` to avoid an infinite publish loop.
+Deployment metadata is saved to `~/.fabrica-ecommerce/projects.json`. Secret values are **not** stored — only variable names, project path, repo URL, creation date, and Supabase URL are recorded.
 
-The workflow publishes `fabrica-e-commerce` as an unscoped public npm package. The package name must be available on npm, and your `NPM_TOKEN` account must have permission to publish it.
+---
 
+## Requirements
 
-For npm provenance publishing, `package.json` includes a `repository.url` that matches the GitHub repository used by the workflow. Keep that URL in sync if you move the repository, otherwise npm will reject the provenance bundle.
+- **Node.js 18.17+**
+- **Git** — run `npx fabrica-e-commerce vins` to auto-install
+- **GitHub CLI (`gh`)** — run `vins` to auto-install; interactive login handled by `build`
+- **Vercel account** — login is handled interactively by `build` if needed
+- A **Supabase** account connected via the Fabrica bridge
 
-## Local project records
+---
 
-Deployment metadata is saved to `~/.fabrica-ecommerce/projects.json`. Secret values are not stored; only the variable names, project path, repo URL, created date, and Supabase URL are saved.
+## Automatic npm publishing (GitHub Actions)
 
-## Requirements
+The workflow at `.github/workflows/npm-publish.yml` verifies and publishes to npm on every push to `main`, `master`, or `work`, and can be triggered manually from the Actions tab.
+
+**Setup — add your npm token once:**
+1. Create an npm token with publish permissions.
+2. In GitHub go to **Settings → Secrets and variables → Actions**.
+3. Add a secret named `NPM_TOKEN`.
+
+**What the workflow does on each run:**
+1. Upgrades npm to the latest version (avoids bundled-npm bugs on GitHub runners).
+2. Runs `npm install`, `npm run build`, `npm run test:cli`, `npm run test:pack`.
+3. Bumps `package.json` to the next patch version if the current version is already published.
+4. Publishes with `npm publish --access public --provenance`.
+5. Commits the bumped version back to GitHub with `[skip npm-publish]` to prevent an infinite loop.
+
+> The `repository.url` in `package.json` must match the GitHub repo used by the workflow — npm uses it to verify the provenance bundle.
+
+---
+
+## Windows notes
 
-- Node.js 18.17+
-- Git installed and available in PATH
-- [GitHub CLI](https://github.com/cli/cli) (`gh`) installed and available in PATH — used to create the new repository and push the storefront code. Logging in (`gh auth login`) is handled interactively by `build` if needed.
-- A Vercel account. The Vercel CLI will prompt/login when required (`build` also runs this check up front).
-- Run `npx fabrica-e-commerce vins` to check for and auto-install `git`/`gh` if either is missing.
+The CLI spawns npm commands through `npx.cmd` on Windows so `npx vercel@latest ...` works correctly from CMD and PowerShell. If you see a Vercel login prompt, complete it in your browser and the CLI will continue automatically.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fabrica-e-commerce",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "CLI launcher for deploying Fabrica e-commerce stores — Supabase + Vercel, works on Windows, macOS, Linux & Termux.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -3,14 +3,21 @@ import { readFile } from 'node:fs/promises';
 import { fileURLToPath } from 'node:url';
 import path from 'node:path';
 import { connectSupabase } from './bridge.js';
-import { collectEnv, cloneRepo, deployToVercel, updateProjectEnv, ensureVercelLogin, runLocally } from './deploy.js';
+import {
+  collectEnv, collectAdminPassword, cloneRepo,
+  deployToVercel, updateProjectEnv, ensureVercelLogin, runLocally,
+} from './deploy.js';
 import { createGithubRepoFromClone } from './github.js';
 import { ensureDependencies, vinsCommand } from './deps.js';
 import { cleanCommand } from './clean.js';
 import { BRIDGE_ORIGIN, STORE_REPO } from './config.js';
 import { dataDir, readProjects } from './store.js';
 import { choose, ask } from './prompt.js';
-import { banner, help, kv, kvSuccess, kvFail, section, endSections, subBox, log, logInfo, logWarn, divider, stepHeader, orange, dimOrange, bold, dim, green, cyan } from './ui.js';
+import {
+  banner, help, kv, kvSuccess, kvFail, section, endSections, subBox,
+  log, logInfo, logWarn, logSuccess, divider, stepHeader,
+  orange, dimOrange, bold, dim, green, cyan, yellow, red, white,
+} from './ui.js';
 import { openUrl } from './system.js';
 
 async function packageVersion() {
@@ -23,31 +30,42 @@ async function packageVersion() {
 async function build() {
   banner();
 
-  stepHeader(1, 5, 'Dependency check');
+  // Step 1 — Dependency check
+  stepHeader(1, 6, 'Dependency check');
   section('Dependency check');
   await ensureDependencies({ names: ['git'] });
   endSections();
 
-  stepHeader(2, 5, 'Supabase connect');
+  // Step 2 — Supabase connect
+  stepHeader(2, 6, 'Supabase connect');
   section('Supabase connect');
   kv('Bridge', 'ONLINE');
   kv('SQL',    'Prepared securely (hidden from UI)');
   const supabase = await connectSupabase();
   endSections();
 
-  stepHeader(3, 5, 'Environment variables');
+  // Step 3 — Environment variables
+  stepHeader(3, 6, 'Environment variables');
   const env = await collectEnv(supabase);
 
-  stepHeader(4, 5, 'Clone storefront');
+  // Step 4 — Admin password
+  stepHeader(4, 6, 'Admin password');
+  const adminPassword = await collectAdminPassword();
+  env['PASS'] = adminPassword;
+
+  // Step 5 — Clone storefront
+  stepHeader(5, 6, 'Clone storefront');
   const project = await cloneRepo();
 
-  stepHeader(5, 5, 'Deploy target');
+  // Step 6 — Deploy target
+  stepHeader(6, 6, 'Deploy target');
   section('Where should Fabrica deploy?');
+  logInfo('Choose how you want to run your store:');
   endSections();
 
   const target = await choose('Select deployment target:', [
-    { name: '☁  Deploy on Vercel (cloud, shareable URL)', value: 'vercel' },
-    { name: '💻  Run locally on this computer',           value: 'local' },
+    { name: '☁   Deploy on Vercel  —  cloud, shareable URL', value: 'vercel' },
+    { name: '💻  Run locally         —  development on this machine', value: 'local' },
   ]);
 
   if (target === 'local') {
@@ -63,14 +81,14 @@ async function build() {
   const githubRepo = await createGithubRepoFromClone(project);
   const record = await deployToVercel(project, env, githubRepo);
 
-  section('✓ Deployment complete');
+  section('✓  Deployment complete');
   divider();
-  kv('Project',    record.projectName);
+  kvSuccess('Project',    record.projectName);
   kv('GitHub',     record.githubRepo || dim('n/a'));
-  kv('URL',        record.productionUrl || dim('n/a'));
-  kv('Local path', record.target);
+  kv('Live URL',   record.productionUrl || dim('n/a'));
+  kv('Local path', dim(record.target));
   divider();
-  log(green('Your Fabrica store is live!'));
+  logSuccess('Your Fabrica store is live! 🎉');
   endSections();
 }
 
@@ -81,18 +99,22 @@ async function list() {
 
   section('Your Fabrica projects');
   if (!projects.length) {
-    logInfo('No projects found');
-    log('Run: npx fabrica-e-commerce build');
+    logInfo('No projects found yet');
+    log(`Run ${cyan('npx fabrica-e-commerce build')} to create your first store`);
     endSections();
     return;
   }
 
-  kv('Total projects', String(projects.length));
+  kv('Total', String(projects.length) + ' project' + (projects.length !== 1 ? 's' : ''));
   divider();
   for (const p of projects) {
-    const type = p.type === 'local' ? cyan('local') : green('cloud');
-    log(`${bold(p.projectName)}  ${type}  ${dim(p.createdAt?.slice(0,10) || '')}`);
+    const badge = p.type === 'local'
+      ? `${yellow('◉')} ${yellow('local')}`
+      : `${green('◉')} ${green('cloud')}`;
+    log(`${bold(white(p.projectName))}  ${badge}  ${dim(p.createdAt?.slice(0, 10) || '')}`);
   }
+  divider();
+  logInfo('Select a project to view its details');
   endSections();
 
   const choices = projects.map((p) => ({
@@ -103,14 +125,19 @@ async function list() {
   const selected = await choose('Select a project to view details:', choices);
   const project = projects.find((p) => p.id === selected);
 
-  section(`Project: ${bold(project.projectName)}`);
-  kv('Type',      project.type === 'local' ? cyan('local') : green('cloud'));
-  kv('Created',   project.createdAt || dim('unknown'));
-  kv('Path',      project.target || dim('n/a'));
+  section(`Project — ${bold(orange(project.projectName))}`);
+  divider();
+  const typeBadge = project.type === 'local' ? yellow('local') : green('cloud');
+  kv('Type',      typeBadge);
+  kv('Created',   project.createdAt ? project.createdAt.slice(0, 19).replace('T', ' ') : dim('unknown'));
+  kv('Path',      dim(project.target || 'n/a'));
   kv('GitHub',    project.githubRepo || dim('n/a'));
   kv('Supabase',  project.supabaseUrl || dim('n/a'));
   kv('URL',       project.productionUrl || dim('n/a'));
-  kv('Env keys',  (project.envKeys || []).join(', ') || dim('none'));
+  kv('Env keys',  (project.envKeys || []).length
+    ? (project.envKeys || []).join(dim('  ·  '))
+    : dim('none'));
+  divider();
   endSections();
 }
 
@@ -120,24 +147,26 @@ async function env() {
   const projects = await readProjects();
 
   section('Environment manager');
+  logInfo('Update API keys and secrets for any project.');
   if (!projects.length) {
-    logInfo('No projects found');
-    log('Run: npx fabrica-e-commerce build');
+    divider();
+    log(`No projects found — run ${cyan('npx fabrica-e-commerce build')} first`);
     endSections();
     return;
   }
+  kv('Total projects', String(projects.length));
   endSections();
 
   const typeFilter = await choose('Which projects to show?', [
-    { name: 'All projects',                 value: 'all' },
-    { name: 'Local projects only',          value: 'local' },
-    { name: 'Cloud (Vercel) projects only', value: 'cloud' },
+    { name: '📋  All projects',                  value: 'all' },
+    { name: '💻  Local projects only',           value: 'local' },
+    { name: '☁   Cloud (Vercel) projects only',  value: 'cloud' },
   ]);
 
   const filtered = typeFilter === 'all' ? projects : projects.filter((p) => p.type === typeFilter);
   if (!filtered.length) {
     section('Environment manager');
-    log(`No ${typeFilter} projects found`);
+    logWarn(`No ${typeFilter} projects found`);
     endSections();
     return;
   }
@@ -156,13 +185,22 @@ async function env() {
     return;
   }
 
+  section(`Env keys — ${bold(orange(project.projectName))}`);
+  divider();
+  for (const k of envKeys) log(`${orange('·')} ${white(k)}`);
+  divider();
+  endSections();
+
   const key = await choose('Select env variable to update:', envKeys.map((k) => ({ name: k, value: k })));
   const currentVal = (project.env || {})[key];
-  const value = await ask(`New value for ${key}`, currentVal || '');
+
+  console.log();
+  const value = await ask(`New value for ${orange(key)}`, currentVal || '');
+  console.log();
 
   section('Applying update');
   await updateProjectEnv(project, key, value);
-  kvSuccess('Updated', `${key} → ${project.type === 'local' ? '.env.local' : 'Vercel + redeployed'}`);
+  kvSuccess('Updated', `${key}  →  ${project.type === 'local' ? '.env.local' : 'Vercel + redeployed'}`);
   endSections();
 }
 
@@ -173,17 +211,18 @@ async function rerun() {
 
   section('Re-run / re-open project');
   if (!projects.length) {
-    logInfo('No projects found');
-    log('Run: npx fabrica-e-commerce build');
+    logInfo('No projects found yet');
+    log(`Run ${cyan('npx fabrica-e-commerce build')} to create your first store`);
     endSections();
     return;
   }
+  kv('Total', String(projects.length) + ' project' + (projects.length !== 1 ? 's' : ''));
   endSections();
 
   const typeFilter = await choose('Which type of project?', [
-    { name: 'All projects',              value: 'all' },
-    { name: 'Local projects',            value: 'local' },
-    { name: 'Cloud (Vercel) projects',   value: 'cloud' },
+    { name: '📋  All projects',               value: 'all' },
+    { name: '💻  Local projects',             value: 'local' },
+    { name: '☁   Cloud (Vercel) projects',    value: 'cloud' },
   ]);
 
   const filtered = typeFilter === 'all' ? projects : projects.filter((p) => p.type === typeFilter);
@@ -200,12 +239,14 @@ async function rerun() {
   })));
   const project = filtered.find((p) => p.id === projectId);
 
-  section(`Re-running: ${bold(project.projectName)}`);
+  section(`Re-running — ${bold(orange(project.projectName))}`);
 
   if (project.type === 'local') {
-    kv('Path', project.target);
+    divider();
+    kv('Path', dim(project.target));
     kv('URL',  'http://localhost:3000');
-    log('Starting dev server — browser opens in 3s…');
+    log(dim('Starting dev server — browser opens in 3s…'));
+    divider();
     endSections();
 
     const { runCommand, runCommandCapture } = await import('./system.js');
@@ -217,11 +258,13 @@ async function rerun() {
     await runCommand(devCommand[0], devCommand[1], { cwd: project.target });
   } else {
     const url = project.productionUrl || null;
+    divider();
     kv('GitHub',  project.githubRepo || dim('n/a'));
     kv('URL',     url || dim('n/a'));
     kv('Inspect', project.inspectUrl || dim('n/a'));
-    kv('Created', project.createdAt || dim('unknown'));
-    if (url) log(`Opening ${url} …`);
+    kv('Created', project.createdAt ? project.createdAt.slice(0, 19).replace('T', ' ') : dim('unknown'));
+    divider();
+    if (url) log(dim(`Opening ${url}…`));
     endSections();
     if (url) await openUrl(url);
   }
@@ -230,14 +273,21 @@ async function rerun() {
 // ── info ──────────────────────────────────────────────────────────────────────
 async function info() {
   banner();
+  const version = await packageVersion();
+
   section('Package info');
-  kv('Package',    `fabrica-e-commerce v${await packageVersion()}`);
+  divider();
+  kvSuccess('Package',   `fabrica-e-commerce  v${version}`);
   kv('Bridge',     BRIDGE_ORIGIN);
   kv('Store repo', STORE_REPO);
-  kv('Local data', dataDir);
+  kv('Local data', dim(dataDir));
+  divider();
   kv('Node.js',    process.version);
   kv('Platform',   process.platform);
+  kv('Arch',       process.arch);
+  divider();
   kv('Creator',    'SPARROW AI SOLUTION');
+  kv('License',    'MIT');
   endSections();
 }
 
@@ -254,7 +304,9 @@ export async function run(args) {
   if (command === 'vins'  || command === '/vins')                        return vinsCommand();
   if (command === 'help'  || command === '--help' || command === '-h')   return help();
 
-  console.error(`Unknown command: ${command}`);
-  help();
+  section('Unknown command');
+  logWarn(`"${command}" is not a valid command`);
+  log(`Run ${cyan('npx fabrica-e-commerce help')} to see all commands`);
+  endSections();
   process.exitCode = 1;
 }