huaweicloud-devkit 1.1.8 → 1.1.9-next.1

package/plugins/huaweicloud-core/src/auth/credentials.mjs

@@ -11,6 +11,8 @@ import {
 import { dirname, join } from 'node:path';
 import { homedir } from 'node:os';
 
+import { buildOnboardingSteps, makeError } from './guidance.mjs';
+
 // Verify a credential file ended up with 0600. On Windows-mounted drives inside WSL
 // (drvfs/9p) chmod is silently ignored, so the file can be world-readable (0777).
 // Native Windows has no POSIX modes (statSync always reports 0666), so skip the check there.
@@ -203,7 +205,8 @@ export function writeObsConfig(credentials = {}) {
   const sk = String(credentials.sk || '');
   const securityToken = String(credentials.securityToken || '');
   if (!region || !ak || !sk) {
-    throw new Error('region, ak, and sk are required to write OBS config');
+    // #900: unified error shape from the shared ERROR_TABLE.
+    throw makeError('HDKIT_CRED_REGION_MISSING');
   }
   const path = obsConfigPath();
   const endpoint = credentials.endpoint || `https://obs.${region}.myhuaweicloud.com`;
@@ -263,43 +266,25 @@ export function resolveCredentials(options = {}) {
 
   if (!ak || !sk) {
     if (options.allowMissing) return null;
-    const err = new Error(
-      'Huawei Cloud credentials are not configured. Run "npx huaweicloud-devkit auth init" or set HW_ACCESS_KEY/HW_SECRET_KEY.',
-    );
-    err.code = 'HDKIT_CRED_MISSING';
-    // Lightweight onboarding hint. HDKIT_CRED_MISSING fires when no credential
-    // resolved: with env empty/masked and S1 absent, the scenario is 3 by
-    // default. Scenario 4 (import a config-provided account) is only reachable
-    // in the narrow case where CodeArts S4 offers real creds that the resolver
-    // still couldn't adopt (e.g. CODEARTS_PROJECT_DIR set but the marker dir is
-    // absent). Full guidance comes from getAuthStatus(); keep this branch cheap.
+    // #900: unified guidance — one steps builder shared with computeOnboarding,
+    // and the error shape from the single ERROR_TABLE. Zero IO beyond the
+    // readCodeArtsCredentials() probe we already did above for scenario routing.
     const codeartsCreds = readCodeArtsCredentials();
     const injectedAvailable = present(codeartsCreds?.ak) && present(codeartsCreds?.sk);
+    const codearts = isCodeArtsContext();
+    const err = makeError('HDKIT_CRED_MISSING');
     err.onboarding = injectedAvailable
       ? {
           scenario: 4,
           reason: 'import-injected',
           message: '检测到配置中已有有效账号,可导入为正式凭证。',
-          steps: isCodeArtsContext()
-            ? [{ action: 'auth_switch', args: { mode: 'mcp-config', action: 'persist' }, label: '导入配置中的账号' }]
-            : [
-                {
-                  action: 'auth_switch',
-                  args: { mode: 'import', action: 'persist' },
-                  label: '通过 creds-import.json 导入',
-                },
-              ],
+          steps: buildOnboardingSteps(4, { codearts }),
         }
       : {
           scenario: 3,
           reason: 's1-missing',
           message: '未配置华为云凭证,需要完成登录后才能使用云能力。',
-          steps: isCodeArtsContext()
-            ? [
-                { action: 'write-import', target: join(homedir(), '.config', 'huaweicloud', 'creds-import.json') },
-                { action: 'auth_switch', args: { mode: 'import', action: 'persist' } },
-              ]
-            : [{ action: 'auth-init', args: {} }],
+          steps: buildOnboardingSteps(3, { codearts }),
         };
     throw err;
   }
@@ -320,7 +305,9 @@ export function getParentCwd() {
   }
 }
 
-function isCodeArtsContext() {
+// Exported for tests: the failure path and the tests must agree on which
+// onboarding variant (codearts vs plain) the current environment selects.
+export function isCodeArtsContext() {
   return (
     existsSync(join(process.cwd(), '.codeartsdoer')) ||
     existsSync(join(homedir(), '.codeartsdoer')) ||

package/plugins/huaweicloud-core/src/auth/guidance.mjs

@@ -0,0 +1,112 @@
+// plugins/huaweicloud-core/src/auth/guidance.mjs
+// Single Source of Truth for onboarding guidance steps and the error surface.
+// Leaf module: imports NOTHING from auth/ siblings. Zero IO — pure builders.
+// Callers: credentials.mjs (failure path), service.mjs (computeOnboarding),
+// credential-validator / reconcile / hcloud-probe (error shapes).
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+export function buildOnboardingSteps(scenario, { codearts = false } = {}) {
+  switch (scenario) {
+    case 3: {
+      const base = [{ order: 1, action: 'obtain-aksk', target: 'console', label: '获取 AK/SK(华为云控制台)' }];
+      if (codearts) {
+        return [
+          ...base,
+          {
+            order: 2,
+            action: 'write-import',
+            target: join(homedir(), '.config', 'huaweicloud', 'creds-import.json'),
+            label: '把 AK/SK 写入 creds-import.json',
+          },
+          {
+            order: 3,
+            action: 'auth_switch',
+            // QA #905 Required: scenario-3 codearts flow writes creds-import.json
+            // in step 2, so the import must READ that file (mode:'import').
+            // mode:'mcp-config' reads the CodeArts injected environment, which
+            // is empty/placeholder in scenario 3 — the channel would not close.
+            args: { mode: 'import', action: 'persist' },
+            label: '执行导入完成配置',
+          },
+        ];
+      }
+      return [...base, { order: 2, action: 'auth-init', args: {}, label: '运行 npx huaweicloud-devkit auth init' }];
+    }
+    case 4:
+      return [
+        {
+          order: 1,
+          action: 'auth_switch',
+          args: { mode: codearts ? 'mcp-config' : 'import', action: 'persist' },
+          label: '导入该账号',
+        },
+      ];
+    default:
+      return [];
+  }
+}
+
+// #900 error contract table. messageZh: Chinese, human-readable, no English
+// sentences, no internal codenames. action: directly executable. nextStep is
+// kept as a derived compatibility field for existing consumers.
+export const ERROR_TABLE = {
+  HDKIT_CRED_MISSING: {
+    messageZh: '未配置华为云凭证,需要先完成登录。',
+    action: 'npx huaweicloud-devkit auth init',
+  },
+  HDKIT_CRED_INVALID: {
+    messageZh: '凭证已被华为云拒绝(AK/SK 无效或已过期),请重新生成。',
+    action: 'npx huaweicloud-devkit auth status',
+  },
+  HDKIT_CRED_FORBIDDEN: {
+    messageZh: '凭证有效但无权限列出项目,请检查账号授权。',
+    action: 'hcloud IAM KeystoneListProjects --cli-region=<region>',
+  },
+  HDKIT_CRED_REGION_MISSING: {
+    messageZh: '缺少 region(区域),登录配置不完整。',
+    action: 'hcloud configure set --cli-region=<region>',
+  },
+  HDKIT_KOOCLI_NOT_READY: {
+    messageZh: 'KooCLI(hcloud)未安装或未就绪。',
+    action: 'npx huaweicloud-devkit install-hcloud',
+  },
+  HDKIT_PROJECT_ID_MISSING: {
+    messageZh: 'KooCLI 配置缺少 project_id,导致同步失败。',
+    action: 'hcloud configure set --cli-project-id=<id>',
+  },
+  // Runtime credentials (in-process, set via auth_init/auth_switch) suppress
+  // auto-sync (rule R10). No `auth sync --force` flag exists; the real unblock
+  // is clearing the runtime store first, then re-running the sync.
+  HDKIT_SYNC_SKIPPED_RUNTIME: {
+    messageZh: '运行时凭证生效,自动同步已跳过。',
+    action: 'huaweicloud_auth_switch action=clear',
+  },
+  // IAM returned something other than 200/401/403 (or the request itself
+  // failed). The canonical debug hint lives in the cli-and-auth skill.
+  HDKIT_CRED_UNEXPECTED: {
+    messageZh: '凭证校验遇到异常响应,请开启调试排查。',
+    action: 'hcloud <Service> <Op> --cli-debug=true',
+  },
+};
+
+export function errorFromTable(code, detail) {
+  const e = ERROR_TABLE[code];
+  if (!e) return { code, messageZh: detail || String(code), action: '', nextStep: detail || '' };
+  return {
+    code,
+    messageZh: detail ? `${e.messageZh}(${detail})` : e.messageZh,
+    action: e.action,
+    nextStep: e.action,
+  };
+}
+
+export function makeError(code, detail) {
+  const shape = errorFromTable(code, detail);
+  const err = new Error(shape.messageZh);
+  err.code = shape.code;
+  err.action = shape.action;
+  err.nextStep = shape.nextStep;
+  err.messageZh = shape.messageZh;
+  return err;
+}

package/plugins/huaweicloud-core/src/auth/reconcile.mjs

@@ -12,6 +12,7 @@ import {
   readLastSync,
   resolveCredentialsWithRuntime,
 } from './credentials.mjs';
+import { errorFromTable } from './guidance.mjs';
 import { resolveHcloudCommand } from '../hcloud-probe.mjs';
 import { redactSecrets } from '../safety-policy.mjs';
 
@@ -43,7 +44,12 @@ export function isManualModified(path) {
 
 export function readKooCliProfiles() {
   const configPath = kooCliConfigPath();
-  if (!existsSync(configPath)) return { error: 'KooCLI config not found' };
+  if (!existsSync(configPath)) {
+    // #900: bare string replaced by the unified ERROR_TABLE shape; the old
+    // English text survives only as the distinguishing detail argument.
+    const e = errorFromTable('HDKIT_KOOCLI_NOT_READY', 'KooCLI config not found');
+    return { error: e.messageZh, code: e.code, messageZh: e.messageZh, action: e.action, nextStep: e.nextStep };
+  }
   try {
     const raw = JSON.parse(readFileSync(configPath, 'utf8'));
     const current = String(raw.current || 'default');
@@ -72,7 +78,9 @@ export function readKooCliProfiles() {
       ),
     };
   } catch {
-    return { error: 'KooCLI config parse failed' };
+    // #900: bare string replaced by the unified ERROR_TABLE shape.
+    const e = errorFromTable('HDKIT_KOOCLI_NOT_READY', 'KooCLI config parse failed');
+    return { error: e.messageZh, code: e.code, messageZh: e.messageZh, action: e.action, nextStep: e.nextStep };
   }
 }
 
@@ -221,3 +229,29 @@ export function runHcloudConfigure(profile, ak, sk, region) {
     ),
   };
 }
+
+// Delete a KooCLI profile (best-effort). Used by the auth persist path (#920):
+// `configure set` REFUSES an empty --cli-security-token, so a stale/expired
+// token already in the profile can never be overwritten — it poisons every
+// hcloud call with APIGW.0301. The documented manual bypass is
+// `hcloud configure delete --cli-profile=<profile>` followed by a re-configure;
+// this helper makes that path a runtime step instead of user knowledge.
+// A missing profile reports a non-zero status, which callers treat as
+// "nothing to clean" — never as an error.
+export function runHcloudProfileDelete(profile) {
+  const { executable, argsPrefix } = resolveHcloudCommand();
+  const r = spawnSync(executable, [...argsPrefix, 'configure', 'delete', `--cli-profile=${profile}`], {
+    shell: false,
+    windowsHide: true,
+    stdio: 'pipe',
+    timeout: 30000,
+  });
+  return {
+    ok: r.status === 0,
+    error: redactSecrets(
+      String(r.stderr || '')
+        .trim()
+        .slice(0, 240),
+    ),
+  };
+}

package/plugins/huaweicloud-core/src/auth/service.mjs

@@ -1,11 +1,10 @@
 import { existsSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
 
 import { getAgentRegistrationStatuses } from './agent-registration.mjs';
 import { resolveAndApplyProjectId } from './project-id.mjs';
 import {
   globalCredentialsPath,
+  isCodeArtsContext,
   isPlaceholder,
   obsConfigPath,
   parseStsExpiry,
@@ -15,6 +14,7 @@ import {
   writeLastSync,
   writeObsConfig,
 } from './credentials.mjs';
+import { buildOnboardingSteps, errorFromTable } from './guidance.mjs';
 import {
   fingerprint,
   exportStateForStatus,
@@ -22,15 +22,7 @@ import {
   resolveManagedProfile,
   runHcloudConfigure,
 } from './reconcile.mjs';
-import { hcloudProbeNextStep, probeHcloud } from '../hcloud-probe.mjs';
-
-function isCodeArtsHome() {
-  return (
-    existsSync(join(process.cwd(), '.codeartsdoer')) ||
-    existsSync(join(homedir(), '.codeartsdoer')) ||
-    existsSync(join(homedir(), '.codeartswork'))
-  );
-}
+import { hcloudProbeNextStep, hcloudProbeRaw, probeHcloud } from '../hcloud-probe.mjs';
 
 function envHasRealTriplet() {
   return (
@@ -57,7 +49,9 @@ export function computeOnboarding({ credentials, reconciled } = {}) {
   const envRealAk = !isPlaceholder(process.env.HW_ACCESS_KEY) && Boolean(process.env.HW_ACCESS_KEY);
   const envRealSk = !isPlaceholder(process.env.HW_SECRET_KEY) && Boolean(process.env.HW_SECRET_KEY);
   const envHasCreds = envRealAk && envRealSk;
-  const codeArts = isCodeArtsHome();
+  // Same context detector the resolveCredentials failure path uses (#900): the
+  // codearts flag must select the identical builder variant on both paths.
+  const codeArts = isCodeArtsContext();
   const accountHint = s1Has ? fingerprint(creds.ak, creds.sk) : null;
 
   let scenario;
@@ -133,32 +127,12 @@ export function computeOnboarding({ credentials, reconciled } = {}) {
     scenario = 4;
     reason = 'import-injected';
     message = '检测到配置中已有有效账号,可导入为正式凭证。';
-    steps = [
-      {
-        order: 1,
-        action: 'switch-persist',
-        args: { mode: codeArts ? 'mcp-config' : 'import', action: 'persist' },
-        label: '导入该账号',
-      },
-    ];
+    steps = buildOnboardingSteps(4, { codearts: codeArts });
   } else {
     scenario = 3;
     reason = 's1-missing';
     message = '未配置华为云凭证,需要完成登录后才能使用云能力。';
-    steps = [
-      { order: 1, action: 'obtain-aksk', target: 'console', label: '获取 AK/SK(华为云控制台)' },
-      ...(codeArts
-        ? [
-            {
-              order: 2,
-              action: 'write-import',
-              target: join(homedir(), '.config', 'huaweicloud', 'creds-import.json'),
-              label: '把 AK/SK 写入 creds-import.json',
-            },
-            { order: 3, action: 'auth_switch', args: { mode: 'import', action: 'persist' }, label: '执行导入完成配置' },
-          ]
-        : [{ order: 2, action: 'auth-init', args: {}, label: '运行 npx huaweicloud-devkit auth init' }]),
-    ];
+    steps = buildOnboardingSteps(3, { codearts: codeArts });
   }
 
   return { needsSetup: true, scenario, reason, message, steps, accountHint };
@@ -215,6 +189,7 @@ export function getAuthStatus(target = 'all') {
     kooCliInstalled: hcloud.installed,
     kooCliStatus: hcloud.status,
     kooCliNextStep: hcloudProbeNextStep(hcloud),
+    kooCliRaw: hcloudProbeRaw(hcloud),
     reconciled,
     onboarding,
     agents: getAgentRegistrationStatuses(target).agents,
@@ -224,17 +199,28 @@ export function getAuthStatus(target = 'all') {
 export function syncAuth(target = 'all') {
   const credentials = readGlobalCredentials();
   if (!credentials?.ak || !credentials?.sk) {
+    // #900: unified error shape from the shared ERROR_TABLE.
+    const e = errorFromTable('HDKIT_CRED_MISSING');
     return {
       ok: false,
-      error: 'Global credentials are not configured.',
-      nextStep: 'Run "npx huaweicloud-devkit auth init" first.',
+      error: e.messageZh,
+      code: e.code,
+      messageZh: e.messageZh,
+      action: e.action,
+      nextStep: e.nextStep,
     };
   }
   if (hasRuntimeCredentials()) {
+    // R10: runtime credentials suppress auto-sync. The codename stays in code
+    // comments only, never in user-facing strings (#900).
+    const e = errorFromTable('HDKIT_SYNC_SKIPPED_RUNTIME');
     return {
       ok: false,
-      error: 'Runtime credentials are active; auto-sync suppressed (R10).',
-      nextStep: 'Run huaweicloud_auth_switch action=clear or action=persist first.',
+      error: e.messageZh,
+      code: e.code,
+      messageZh: e.messageZh,
+      action: e.action,
+      nextStep: e.nextStep,
     };
   }
 
@@ -264,25 +250,47 @@ export function syncAuth(target = 'all') {
 
   const hcloud = probeHcloud();
   if (!hcloud.ok) {
+    // #900: three probe states share the table code; the detail distinguishes.
+    const detail =
+      hcloud.status === 'sandbox_home_failure'
+        ? '无法解析用户主目录'
+        : hcloud.status === 'privacy_pending'
+          ? '隐私协议待同意'
+          : '';
+    const e = errorFromTable('HDKIT_KOOCLI_NOT_READY', detail);
     return {
       ok: false,
-      error:
-        hcloud.status === 'sandbox_home_failure'
-          ? 'KooCLI detected but cannot resolve the user home directory in this agent sandbox.'
-          : hcloud.status === 'privacy_pending'
-            ? 'KooCLI privacy agreement is pending.'
-            : 'KooCLI not ready.',
+      error: e.messageZh,
+      code: e.code,
+      messageZh: e.messageZh,
+      action: e.action,
+      // #900 issue comment: nextStep is the executable table action; the
+      // verbose English guidance survives only in the `raw` side-channel.
       nextStep: hcloudProbeNextStep(hcloud),
+      raw: hcloudProbeRaw(hcloud),
       obs: { configured: true, path: obs.path, endpoint: obs.endpoint },
     };
   }
 
   const { ok, error } = runHcloudConfigure(profile, credentials.ak, credentials.sk, credentials.region);
   if (!ok) {
+    // #900: `hcloud configure set` failures are usually a missing/invalid
+    // project_id for the target region; anything else keeps the raw (already
+    // redacted) stderr as the detail argument.
+    const detail = String(error || '').trim();
+    const projectIdCause = /project[_\s-]?id/i.test(detail);
+    const e = projectIdCause
+      ? errorFromTable('HDKIT_PROJECT_ID_MISSING', detail)
+      : errorFromTable('HDKIT_KOOCLI_NOT_READY', detail || 'KooCLI 配置同步失败');
     return {
       ok: false,
-      error: error || 'KooCLI config sync failed',
-      nextStep: 'Run "npx huaweicloud-devkit auth init" in a real terminal to refresh the KooCLI config.',
+      error: e.messageZh,
+      code: e.code,
+      messageZh: e.messageZh,
+      action: e.action,
+      nextStep: projectIdCause
+        ? e.nextStep
+        : 'Run "npx huaweicloud-devkit auth init" in a real terminal to refresh the KooCLI config.',
       obs: { configured: true, path: obs.path, endpoint: obs.endpoint },
     };
   }

package/plugins/huaweicloud-core/src/hcloud-cli.mjs

@@ -659,11 +659,39 @@ function runHcloudOnce(plan, options) {
         });
         return;
       }
+      // #921: the ok verdict converges on the exit code plus structured error
+      // parsing (errorCode-first, handled above). Two false-positive classes
+      // are closed here:
+      //   1. exit code 0 but the output carries a KooCLI parameter error (e.g.
+      //      `--delete_ip` instead of `--delete_publicip`) — the command never
+      //      executed; report ok:false with a PARAM_ERROR errorCode.
+      //   2. non-zero exit code with "successfully" in the output — the old
+      //      broad regex flagged ANY failure mentioning "successfully". It is
+      //      narrowed to OBS obsutil-style commands (which are known to return
+      //      non-zero exit codes on success, #57) AND require the output to
+      //      carry no error indicators.
+      const combined = `${stdout}${stderr}`;
+      const paramError = combined.match(
+        /\[?(?:ERROR|USE_ERROR)\]?[: ]*(?:unknown parameter|unknown option|incorrect (?:option|switch|parameter)|invalid (?:parameter|argument)|参数不存在|参数错误|无效的参数)[^\n]*/i,
+      );
+      if (paramError) {
+        finish({
+          ok: false,
+          exitCode: code,
+          signal,
+          errorCode: 'PARAM_ERROR',
+          errorMessage: paramError[0].trim(),
+          stdout: redactOutput(stdout),
+          stderr: redactOutput(stderr),
+          plan,
+        });
+        return;
+      }
+      const isObsCommand = /^obs\b/i.test(String(plan.rawArgs?.[0] || ''));
+      const successText = /successfully/i.test(combined);
+      const errorIndicators = /error|failed|失败|invalid|not found|denied|拒绝/i.test(combined);
       finish({
-        ok:
-          code === 0 ||
-          (code !== 0 &&
-            /successfully|succ?ess.*\[200\]|create bucket successfully|upload successfully/i.test(stdout + stderr)),
+        ok: code === 0 || (isObsCommand && successText && !errorIndicators),
         exitCode: code,
         signal,
         stdout: redactOutput(stdout),

package/plugins/huaweicloud-core/src/hcloud-probe.mjs

@@ -3,6 +3,7 @@ import { existsSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 
+import { errorFromTable } from './auth/guidance.mjs';
 import { compareVersion, getKooCliVersion, parseHcloudVersion } from './koocli-version.mjs';
 import { kooCliInstallLogPath } from './preflight.mjs';
 import { redactSecrets } from './safety-policy.mjs';
@@ -140,19 +141,24 @@ export function probeHcloud(options = {}) {
   };
 }
 
-export function hcloudProbeNextStep(probe) {
-  if (probe.status === 'ok')
+// #900 (issue comment Required 1): every not-ready probe state routes through
+// the shared ERROR_TABLE.HDKIT_KOOCLI_NOT_READY so nextStep is always a
+// directly executable command (d11-41-nextstep-actionable). The verbose
+// English guidance is preserved verbatim in hcloudProbeRaw() — a docs/debug
+// side-channel — and must never leak back into the top-level nextStep.
+export function hcloudProbeRaw(probe) {
+  if (probe?.status === 'ok')
     return 'Use huaweicloud_show_profile_redacted to inspect the active KooCLI profile safely.';
-  if (probe.status === 'version_mismatch') {
+  if (probe?.status === 'version_mismatch') {
     return `KooCLI version mismatch: installed ${probe.installedVersion}, this plugin is paired with ${probe.requiredVersion}. Reinstall the pinned version (see huaweicloud-cli-and-auth skill) and restart the agent.`;
   }
-  if (probe.status === 'sandbox_home_failure') {
+  if (probe?.status === 'sandbox_home_failure') {
     return 'KooCLI was found, but this agent sandbox cannot resolve the Windows user home directory. Set HCLOUD_BIN to the full hcloud path, restart Codex, or verify from a normal terminal.';
   }
-  if (probe.status === 'privacy_pending') {
+  if (probe?.status === 'privacy_pending') {
     return 'KooCLI requires accepting its one-time privacy agreement. Run hcloud version in a real terminal and accept the prompt, then restart the agent.';
   }
-  if (probe.status === 'not_found') {
+  if (probe?.status === 'not_found') {
     return (
       'KooCLI is not installed yet. Background auto-install may be running — please retry shortly instead of assuming failure. To install now: npx huaweicloud-devkit install-hcloud. DevKit picks up the binary from its fixed install dirs (~/.local/bin on Linux, /usr/local/bin on macOS, ~/hcloud on Windows) or HCLOUD_BIN on the next call — no agent restart needed. Install progress: ' +
       kooCliInstallLogPath()
@@ -160,3 +166,17 @@ export function hcloudProbeNextStep(probe) {
   }
   return 'Install Huawei Cloud KooCLI: npx huaweicloud-devkit install-hcloud. Configure credentials outside the agent conversation.';
 }
+
+export function hcloudProbeNextStep(probe) {
+  if (probe?.status === 'ok') return 'huaweicloud_show_profile_redacted';
+  const detail =
+    probe?.status === 'version_mismatch'
+      ? `版本不匹配(已装 ${probe?.installedVersion ?? '未知'},插件配套 ${probe?.requiredVersion ?? '未知'})`
+      : probe?.status === 'sandbox_home_failure'
+        ? '无法解析用户主目录'
+        : probe?.status === 'privacy_pending'
+          ? '隐私协议待同意'
+          : '';
+  const e = errorFromTable('HDKIT_KOOCLI_NOT_READY', detail);
+  return e.nextStep;
+}