@ekzs/cli 0.3.0 → 0.3.4

package/dist/lib/providers/cursor-sdk.js

@@ -0,0 +1,25 @@
+import { providersCommandLabels } from "../commands-i18n.js";
+export class CursorSdkMissingError extends Error {
+    constructor(locale = "en") {
+        const p = providersCommandLabels(locale);
+        const msg = locale === "pt"
+            ? `Provider Cursor requer @cursor/sdk. Instala: npm install -g @cursor/sdk\nOu usa outro provider em ${p.repl}.`
+            : locale === "zh"
+                ? `Cursor provider 需要 @cursor/sdk。安装: npm install -g @cursor/sdk\n或在 ${p.repl} 选择其他 provider。`
+                : `Cursor provider requires @cursor/sdk. Run: npm install -g @cursor/sdk\nOr pick another provider via ${p.repl}.`;
+        super(msg);
+        this.name = "CursorSdkMissingError";
+    }
+}
+let cached = null;
+export async function loadCursorSdk(locale = "en") {
+    if (cached)
+        return cached;
+    try {
+        cached = await import("@cursor/sdk");
+        return cached;
+    }
+    catch {
+        throw new CursorSdkMissingError(locale);
+    }
+}

package/dist/lib/providers/store.d.ts

@@ -17,5 +17,5 @@ export declare function setStoredProvider(id: ProviderId, entry: StoredProvider)
 export declare function removeStoredProvider(id: ProviderId): void;
 export declare function setActiveProvider(id: ProviderId): void;
 export declare function resolveModel(id: ProviderId, stored?: StoredProvider): string;
-export declare function resolveBaseUrl(id: ProviderId, stored?: StoredProvider): string | undefined;
+export declare function resolveBaseUrl(id: ProviderId, _stored?: StoredProvider): string | undefined;
 //# sourceMappingURL=store.d.ts.map

package/dist/lib/providers/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/store.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAyB,MAAM,cAAc,CAAC;AAEtE,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;CACxD,CAAC;AAWF,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,iBAAiB,IAAI,aAAa,CAcjD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,QAQpD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,CAE5E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,QAKtE;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,UAAU,QAOlD;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,QAO/C;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,CAG5E;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAG1F"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/store.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAyB,MAAM,cAAc,CAAC;AAGtE,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;CACxD,CAAC;AAWF,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,iBAAiB,IAAI,aAAa,CAcjD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,QAQpD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,CAE5E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,QAQtE;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,UAAU,QAOlD;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,QAO/C;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,CAM5E;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAE3F"}

package/dist/lib/providers/store.js

@@ -2,6 +2,7 @@ import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "f
 import { homedir } from "os";
 import { join } from "path";
 import { getProviderDefinition } from "./catalog.js";
+import { clearGlobalOffline, markSetupComplete } from "../global-config.js";
 const EKZ_HOME = join(homedir(), ".ekz");
 const PROVIDERS_PATH = join(EKZ_HOME, "providers.json");
 function ensureEkzHome() {
@@ -49,10 +50,12 @@ export function getStoredProvider(id) {
 }
 export function setStoredProvider(id, entry) {
     const file = loadProvidersFile();
-    file.providers[id] = entry;
-    if (!file.active)
-        file.active = id;
+    const { baseUrl: _ignored, ...rest } = entry;
+    file.providers[id] = rest;
+    file.active = id;
     saveProvidersFile(file);
+    clearGlobalOffline();
+    markSetupComplete();
 }
 export function removeStoredProvider(id) {
     const file = loadProvidersFile();
@@ -72,10 +75,13 @@ export function setActiveProvider(id) {
 }
 export function resolveModel(id, stored) {
     const def = getProviderDefinition(id);
-    return stored?.model?.trim() || def?.defaultModel || "gpt-4o";
+    if (!def)
+        return stored?.model?.trim() || "gpt-4o";
+    const trimmed = stored?.model?.trim();
+    if (trimmed)
+        return trimmed;
+    return def.defaultModel;
 }
-export function resolveBaseUrl(id, stored) {
-    if (stored?.baseUrl?.trim())
-        return stored.baseUrl.trim();
+export function resolveBaseUrl(id, _stored) {
     return getProviderDefinition(id)?.defaultBaseUrl;
 }

package/dist/lib/providers/ui.d.ts

@@ -1,4 +1,6 @@
 import { type EkzLocale } from "../locale.js";
+/** One-shot provider pick + configure — used by `ekz setup`. */
+export declare function runSetupProviderWizard(locale?: EkzLocale): Promise<boolean>;
 export declare function runProvidersInteractive(locale?: EkzLocale): Promise<void>;
 export declare function formatActiveProviderLabel(locale: EkzLocale): string;
 //# sourceMappingURL=ui.d.ts.map

package/dist/lib/providers/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/ui.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AA+L9C,wBAAsB,uBAAuB,CAAC,MAAM,GAAE,SAAgB,iBAuDrE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAMnE"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/ui.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAqN9C,gEAAgE;AAChE,wBAAsB,sBAAsB,CAAC,MAAM,GAAE,SAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBvF;AAED,wBAAsB,uBAAuB,CAAC,MAAM,GAAE,SAAgB,iBAuDrE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAMnE"}

package/dist/lib/providers/ui.js

@@ -88,10 +88,46 @@ function printProviderList(rows, locale) {
     console.log(`  ${muted(t(locale, "[número] configurar · u usar · r remover · q sair", "[number] configure · u use · r remove · q quit", "[数字] 配置 · u 使用 · r 删除 · q 退出"))}`);
     console.log("");
 }
+function printCatalogPicker(locale) {
+    console.log("");
+    console.log(`  ${c.bold}${t(locale, "Escolhe o provedor", "Choose provider", "选择 provider")}${c.reset}`);
+    console.log("");
+    PROVIDER_CATALOG.forEach((def, index) => {
+        console.log(`  ${c.bold}${String(index + 1).padStart(2)}.${c.reset} ${def.name.padEnd(16)} ${muted(def.description)}`);
+    });
+    console.log("");
+}
+async function pickModel(id, locale) {
+    const def = getProviderDefinition(id);
+    if (!def)
+        return null;
+    const defaultIndex = Math.max(0, def.models.findIndex((m) => m === def.defaultModel));
+    const defaultNum = defaultIndex + 1;
+    console.log("");
+    console.log(`  ${c.bold}${t(locale, "Modelo", "Model", "模型")}${c.reset}`);
+    def.models.forEach((model, index) => {
+        const n = index + 1;
+        const tag = model === def.defaultModel
+            ? muted(t(locale, " · predefinição", " · default", " · 默认"))
+            : "";
+        console.log(`  ${c.bold}${String(n).padStart(2)}.${c.reset} ${model}${tag}`);
+    });
+    console.log("");
+    const prompt = t(locale, `  Escolha [${defaultNum}]: `, `  Choice [${defaultNum}]: `, `  选择 [${defaultNum}]: `);
+    const choice = await askLine(prompt);
+    if (!choice)
+        return def.defaultModel;
+    const num = Number(choice);
+    if (Number.isInteger(num) && num >= 1 && num <= def.models.length) {
+        return def.models[num - 1];
+    }
+    warn(t(locale, "Opção inválida — a usar predefinição.", "Invalid choice — using default.", "无效选项 — 使用默认。"));
+    return def.defaultModel;
+}
 async function configureProvider(id, locale) {
     const def = getProviderDefinition(id);
     if (!def)
-        return;
+        return false;
     console.log("");
     console.log(`  ${c.bold}${def.name}${c.reset} — ${muted(def.description)}`);
     console.log(`  ${muted(def.docsUrl)}`);
@@ -100,29 +136,14 @@ async function configureProvider(id, locale) {
     const apiKey = await askLine(keyPrompt, true);
     if (!apiKey) {
         warn(t(locale, "Chave vazia — cancelado.", "Empty key — cancelled.", "密钥为空，已取消。"));
-        return;
-    }
-    const modelDefault = def.defaultModel;
-    const modelPrompt = t(locale, `Modelo [${modelDefault}]: `, `Model [${modelDefault}]: `, `模型 [${modelDefault}]: `);
-    const modelInput = await askLine(modelPrompt);
-    const model = modelInput || modelDefault;
-    let baseUrl;
-    if (def.kind === "openai-compatible" || def.defaultBaseUrl) {
-        const urlPrompt = t(locale, `Base URL [${def.defaultBaseUrl ?? "(default)"}]: `, `Base URL [${def.defaultBaseUrl ?? "(default)"}]: `, `Base URL [${def.defaultBaseUrl ?? "(default)"}]: `);
-        const urlInput = await askLine(urlPrompt);
-        if (urlInput)
-            baseUrl = urlInput;
-    }
-    setStoredProvider(id, { apiKey, model, baseUrl });
-    ok(t(locale, `Guardado ${def.name} (${maskApiKey(apiKey)})`, `Saved ${def.name} (${maskApiKey(apiKey)})`, `已保存 ${def.name} (${maskApiKey(apiKey)})`));
-    const active = resolveActiveCredentials();
-    if (!active || active.id !== id) {
-        const useNow = await askLine(t(locale, "Usar como provider activo? [Y/n]: ", "Use as active provider? [Y/n]: ", "设为当前 provider? [Y/n]: "), false);
-        if (!useNow || useNow.toLowerCase() === "y" || useNow.toLowerCase() === "s" || useNow === "") {
-            setActiveProvider(id);
-            ok(t(locale, `${def.name} activo.`, `${def.name} is now active.`, `${def.name} 已激活。`));
-        }
+        return false;
     }
+    const model = await pickModel(id, locale);
+    if (!model)
+        return false;
+    setStoredProvider(id, { apiKey, model });
+    ok(t(locale, `Guardado ${def.name} · ${model} (${maskApiKey(apiKey)})`, `Saved ${def.name} · ${model} (${maskApiKey(apiKey)})`, `已保存 ${def.name} · ${model} (${maskApiKey(apiKey)})`));
+    return true;
 }
 function resolveRowTarget(rows, target) {
     const trimmed = target.trim().toLowerCase();
@@ -132,6 +153,21 @@ function resolveRowTarget(rows, target) {
     }
     return rows.find((r) => r.definition.id === trimmed);
 }
+/** One-shot provider pick + configure — used by `ekz setup`. */
+export async function runSetupProviderWizard(locale = "pt") {
+    printCatalogPicker(locale);
+    const prompt = t(locale, "  Número do provedor (Enter cancelar): ", "  Provider number (Enter to cancel): ", "  Provider 编号 (Enter 取消): ");
+    const choice = (await askLine(prompt)).trim();
+    if (!choice)
+        return false;
+    const num = Number(choice);
+    if (!Number.isInteger(num) || num < 1 || num > PROVIDER_CATALOG.length) {
+        warn(t(locale, "Opção inválida.", "Invalid option.", "无效选项。"));
+        return false;
+    }
+    const def = PROVIDER_CATALOG[num - 1];
+    return configureProvider(def.id, locale);
+}
 export async function runProvidersInteractive(locale = "pt") {
     while (true) {
         const rows = listProviderRows();
@@ -184,5 +220,5 @@ export function formatActiveProviderLabel(locale) {
     if (!creds) {
         return t(locale, "sem provider", "no provider", "未配置");
     }
-    return `${creds.definition.name} · ${creds.maskedKey}`;
+    return `${creds.definition.name} · ${creds.model} · ${creds.maskedKey}`;
 }

package/dist/lib/setup-messages.d.ts

@@ -0,0 +1,4 @@
+/** Shown when agent needs provider but setup was not run (all locales). */
+export declare function formatSetupRequiredMessage(): string;
+export declare function providersSetupHint(_locale?: string): string;
+//# sourceMappingURL=setup-messages.d.ts.map

package/dist/lib/setup-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-messages.d.ts","sourceRoot":"","sources":["../../src/lib/setup-messages.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,wBAAgB,0BAA0B,IAAI,MAAM,CAQnD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/lib/setup-messages.js

@@ -0,0 +1,13 @@
+/** Shown when agent needs provider but setup was not run (all locales). */
+export function formatSetupRequiredMessage() {
+    return [
+        "Setup required · Configuração necessária · 需要设置",
+        "",
+        "  pt: Corre `ekz setup` ou `ekz --offline`",
+        "  en: Run `ekz setup` or `ekz --offline`",
+        "  zh: 运行 `ekz setup` 或 `ekz --offline`",
+    ].join("\n");
+}
+export function providersSetupHint(_locale) {
+    return formatSetupRequiredMessage();
+}

package/dist/lib/ui/splash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"splash.d.ts","sourceRoot":"","sources":["../../../src/lib/ui/splash.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,cAAc,CAAC;AACzD,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAMvD,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AA2GF,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAQtD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAG1D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,SAAI,GAAG,MAAM,CAIrE"}
+{"version":3,"file":"splash.d.ts","sourceRoot":"","sources":["../../../src/lib/ui/splash.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,cAAc,CAAC;AACzD,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAMvD,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AA6GF,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAQtD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAG1D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,SAAI,GAAG,MAAM,CAIrE"}

package/dist/lib/ui/splash.js

@@ -4,6 +4,7 @@ import { readFileSync } from "fs";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 import { formatSplashTool, splashHelpHint, splashSectionTitle, SPLASH_TOOLS, splashSessionLines, welcomeMessage, } from "../commands-i18n.js";
+import { getGlobalUserName } from "../global-config.js";
 import { uiStrings } from "../locale.js";
 import { MODE_LABELS } from "../mode.js";
 import { detectShellEnvironment, shellLabel } from "../shell.js";
@@ -24,6 +25,9 @@ function packageVersion() {
     }
 }
 function displayName() {
+    const fromConfig = getGlobalUserName();
+    if (fromConfig)
+        return fromConfig.split(/\s+/)[0] ?? fromConfig;
     const fromEnv = process.env.EKZ_USER_NAME?.trim();
     if (fromEnv)
         return fromEnv.split(/\s+/)[0] ?? fromEnv;

package/dist/lib/version.d.ts

@@ -0,0 +1,2 @@
+export declare function packageVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/lib/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAMA,wBAAgB,cAAc,IAAI,MAAM,CASvC"}

package/dist/lib/version.js

@@ -0,0 +1,13 @@
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+const here = dirname(fileURLToPath(import.meta.url));
+export function packageVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(join(here, "../../package.json"), "utf8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekzs/cli",
-  "version": "0.3.0",
+  "version": "0.3.4",
   "description": "CLI agent for e-Kwanza v2.4 — health checks, code scan, webhook tests, AI assistance",
   "type": "module",
   "bin": {
@@ -17,12 +17,20 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@cursor/sdk": "^1.0.13",
     "@ekzs/connect": "^0.1.0",
     "commander": "^12.1.0",
     "dotenv": "^16.4.7"
   },
+  "peerDependencies": {
+    "@cursor/sdk": "^1.0.13"
+  },
+  "peerDependenciesMeta": {
+    "@cursor/sdk": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@cursor/sdk": "^1.0.13",
     "@types/node": "^20",
     "typescript": "^5"
   },