@alphalawyer/alpha-classic-cli 0.1.2 → 0.1.3

package/README.md

@@ -5,7 +5,7 @@ Alpha Classic CLI 是为 **Alpha 律所管理系统** 开发的 AI-friendly CLI
 - CLI 命令能访问 Web 应用 API
 - Codex 能通过 Skill 理解该怎么调用 CLI
 - 登录、诊断、业务查询形成最小闭环
-- 环境在构建时固化，运行时不能切换，避免误连 dev/prod
+- 默认环境是 `prod`，也可以通过 `env use` 在预设环境间切换
 
 ## 安装依赖
 
@@ -16,10 +16,10 @@ npm install
 ## 构建
 
 ```bash
-npm run build:dev
+npm run build
 ```
 
-构建脚本会把环境写入产物：
+默认构建生产环境产物；本地调试也保留按环境构建的脚本：
 
 ```bash
 npm run build:local
@@ -41,10 +41,10 @@ npm run release:patch
 - `release:patch`：先确认 npm 登录用户，再完成发布前检查、自动升级补丁版本、重新生产构建并发布到公开 npm 仓库。
 - 如果 npm 要求 OTP，命令后追加参数即可，例如 `npm run release:patch -- --otp=123456`。
 
-当前 dev 环境：
+默认 prod 环境：
 
 ```text
-baseUrl/apiBaseUrl: https://dev.alphalawyer.cn
+baseUrl/apiBaseUrl: https://alphalawyer.cn
 current user API: GET /im/v1/users/me
 auth header: token: <token>
 device header: deviceType: ai
@@ -56,7 +56,10 @@ device header: deviceType: ai
 
 ```bash
 alpha-classic-cli version
+alpha-classic-cli env list
 alpha-classic-cli env current
+alpha-classic-cli env use test
+alpha-classic-cli env use prod
 alpha-classic-cli login
 alpha-classic-cli doctor
 alpha-classic-cli matter search --keyword 合同 --limit 10
@@ -68,7 +71,7 @@ alpha-classic-cli appro initiators --keyword 张三
 alpha-classic-cli appro detail --id <审批ID>
 ```
 
-`env use` 已移除。只保留 `env list` 和 `env current`；切换环境必须重新构建对应环境版本。
+`env use <local|dev|test|prod>` 会写入本地配置并清空旧登录态，切换后需要重新执行 `alpha-classic-cli login`。
 
 源码调试时也可以使用：
 
@@ -221,5 +224,5 @@ alpha-classic-cli capabilities
 - 默认输出 JSON envelope，方便 AI 解析。
 - 只支持查询，不执行写操作。
 - 不在终端输出 token。
-- 不接受运行时 baseUrl/apiBaseUrl 参数。
+- 运行时只允许切换内置环境预设，不接受任意 baseUrl/apiBaseUrl 参数。
 - Skill 负责告诉 AI 什么时候用哪个命令。

package/assets/alpha-classic-skill/references/alpha-classic-shared.md

@@ -10,7 +10,7 @@
 - 使用前先运行 `alpha-classic-cli doctor`。
 - 未登录时提示用户运行 `alpha-classic-cli login`。
 - Agent 异步登录使用 `alpha-classic-cli login --no-wait --json`，把 `data.verification_url` 原样交给用户；用户确认后运行 `alpha-classic-cli login --device-code <device_code>`。
-- 环境由 CLI 构建时固化，运行时不能切换；如环境不对，提示用户重新构建对应环境版本。
+- 默认环境是 `prod`；如环境不对，使用 `alpha-classic-cli env use <local|dev|test|prod>` 切换，并在切换后重新登录。
 
 ## 输出处理
 

package/assets/claude/alpha-classic-cli.md

@@ -107,7 +107,7 @@ alpha-classic-cli appro detail --id <approId> --comments 10
 
 - 除非用户明确要求做 CLI 开发工作，否则只使用查询 / 读取命令。
 - 不要输出 token 或 refreshToken。
-- 不要使用 `env use`；这个命令已经移除，只保留 `env list` 和 `env current`，环境在构建时已经锁定。
+- 默认环境是 `prod`；需要切换时使用 `alpha-classic-cli env use <local|dev|test|prod>`，切换后重新登录。
 - 优先使用 `matter`，`project` 只是别名。
 - 在项目详情页里，任务表用 `matter task`。
 - 最终回答默认隐藏内部 ID，包括 `项目ID`、`审批ID`、`任务ID`、`流程任务ID`、`节点ID`、`字段ID`、`文件ID`、`评论ID`、`动态ID`；这些只留给后续 CLI 调用。`项目编号`、`审批编号` 这类业务编号可以展示。

package/dist/index.js

@@ -19,7 +19,7 @@ function normalizeBaseUrl(value) {
 }
 
 // src/config/environments.ts
-var DEFAULT_ENVIRONMENT_NAME = "dev";
+var DEFAULT_ENVIRONMENT_NAME = "prod";
 var PRESETS = {
   local: {
     label: "Local development",
@@ -68,6 +68,16 @@ function getEnvironmentPresetOrThrow(name) {
 function getDefaultEnvironmentPreset() {
   return getEnvironmentPresetOrThrow(BUILD_ENVIRONMENT_NAME);
 }
+async function getCurrentEnvironmentPreset(configReader) {
+  const config = await configReader.getConfig();
+  const configuredEnvironment = getEnvironmentPreset(config.environment);
+  const fallbackEnvironment = getDefaultEnvironmentPreset();
+  const environment = configuredEnvironment ?? fallbackEnvironment;
+  return {
+    ...environment,
+    source: configuredEnvironment ? "config" : "default"
+  };
+}
 function normalizePreset(name, preset) {
   return {
     name,
@@ -368,6 +378,7 @@ async function createLoginDeviceAuthorization(options, sessionStore) {
     client: CLIENT_NAME,
     deviceName: buildDeviceName()
   });
+  const normalizedAuth = normalizeDeviceAuthorizationUrls(auth, context.baseUrl);
   await sessionStore.saveConfig({
     environment: context.environment.name,
     baseUrl: context.baseUrl,
@@ -378,7 +389,7 @@ async function createLoginDeviceAuthorization(options, sessionStore) {
     baseUrl: context.baseUrl,
     apiBaseUrl: context.apiBaseUrl,
     timeoutMs: context.timeoutMs,
-    auth
+    auth: normalizedAuth
   };
 }
 async function pollLoginDeviceAuthorization(options, sessionStore, deviceCode) {
@@ -439,7 +450,7 @@ async function runTokenLogin(options, sessionStore) {
   if (!options.token) {
     throw new Error("Missing token.");
   }
-  const environment = getDefaultEnvironmentPreset();
+  const environment = await getCurrentEnvironmentPreset(sessionStore);
   const currentUser = await verifyToken(environment.apiBaseUrl, options.token);
   const currentUserData = getCurrentUserData(currentUser);
   const userId = options.userId ?? currentUserData?.accid ?? currentUserData?.id ?? currentUserData?.user_id;
@@ -468,9 +479,9 @@ async function runTokenLogin(options, sessionStore) {
 }
 async function resolveLoginContext(options, sessionStore) {
   const config = await sessionStore.getConfig();
-  const environment = getDefaultEnvironmentPreset();
-  const baseUrl = normalizeBaseUrl(config.baseUrl ?? environment.baseUrl);
-  const apiBaseUrl = normalizeBaseUrl(config.apiBaseUrl ?? environment.apiBaseUrl);
+  const environment = await getCurrentEnvironmentPreset(sessionStore);
+  const baseUrl = normalizeBaseUrl(environment.baseUrl);
+  const apiBaseUrl = normalizeBaseUrl(environment.apiBaseUrl);
   const timeoutMs = options.timeoutMs ?? config.timeoutMs ?? DEFAULT_LOGIN_TIMEOUT_MS;
   const apiClient = options.apiClient ?? new ApiClient({
     sessionStore,
@@ -573,6 +584,27 @@ ${qrcode}
   }
   emitProgress(reporter, `login: open ${auth.verificationUriComplete}`);
 }
+function normalizeDeviceAuthorizationUrls(auth, baseUrl) {
+  return {
+    ...auth,
+    ...auth.verificationUri ? { verificationUri: replaceUrlOrigin(auth.verificationUri, baseUrl) } : {},
+    verificationUriComplete: replaceUrlOrigin(auth.verificationUriComplete, baseUrl)
+  };
+}
+function replaceUrlOrigin(value, baseUrl) {
+  if (!value.trim()) {
+    return value;
+  }
+  try {
+    const currentUrl = new URL(value);
+    const targetUrl = new URL(baseUrl);
+    currentUrl.protocol = targetUrl.protocol;
+    currentUrl.host = targetUrl.host;
+    return currentUrl.toString();
+  } catch {
+    return new URL(value.startsWith("/") ? value : `/${value}`, baseUrl).toString();
+  }
+}
 function emitProgress(reporter, message) {
   reporter?.(`[${(/* @__PURE__ */ new Date()).toLocaleTimeString("zh-CN", { hour12: false })}] ${message}`);
 }
@@ -643,7 +675,7 @@ function printError(type, message, options) {
 // src/commands/api.ts
 async function runApiCommand(method, apiPath, options, sessionStore) {
   const config = await sessionStore.getConfig();
-  const environment = getDefaultEnvironmentPreset();
+  const environment = await getCurrentEnvironmentPreset(sessionStore);
   const client = new ApiClient({
     sessionStore,
     apiBaseUrl: environment.apiBaseUrl,
@@ -694,7 +726,7 @@ async function runApproList(options, sessionStore) {
   const approTypes = parseNumberList(options.approType);
   const status = parseApproStatus(options.status);
   const config = await sessionStore.getConfig();
-  const environment = getDefaultEnvironmentPreset();
+  const environment = await getCurrentEnvironmentPreset(sessionStore);
   const client = new ApiClient({
     sessionStore,
     apiBaseUrl: environment.apiBaseUrl,
@@ -747,7 +779,7 @@ async function runApproList(options, sessionStore) {
 async function runApproInitiators(options, sessionStore) {
   const limit = clampLimit(options.limit ?? 50);
   const config = await sessionStore.getConfig();
-  const environment = getDefaultEnvironmentPreset();
+  const environment = await getCurrentEnvironmentPreset(sessionStore);
   const client = new ApiClient({
     sessionStore,
     apiBaseUrl: environment.apiBaseUrl,
@@ -775,7 +807,7 @@ async function runApproDetail(options, sessionStore) {
     throw new Error("Missing appro id. Use: alpha-classic-cli appro detail --id <approId>");
   }
   const config = await sessionStore.getConfig();
-  const environment = getDefaultEnvironmentPreset();
+  const environment = await getCurrentEnvironmentPreset(sessionStore);
   const client = new ApiClient({
     sessionStore,
     apiBaseUrl: environment.apiBaseUrl,
@@ -1975,8 +2007,8 @@ function clampCommentLimit(limit) {
 }
 
 // src/commands/capabilities.ts
-function runCapabilities(version) {
-  const environment = getDefaultEnvironmentPreset();
+async function runCapabilities(version, sessionStore) {
+  const environment = await getCurrentEnvironmentPreset(sessionStore);
   printSuccess({
     "\u5DE5\u5177": {
       "\u540D\u79F0": "alpha-classic-cli",
@@ -1988,8 +2020,9 @@ function runCapabilities(version) {
       "\u5F53\u524D\u73AF\u5883": environment.name,
       "baseUrl": environment.baseUrl,
       "apiBaseUrl": environment.apiBaseUrl,
-      "\u662F\u5426\u6784\u5EFA\u65F6\u9501\u5B9A": true,
-      "\u5207\u6362\u65B9\u5F0F": "\u91CD\u65B0\u6784\u5EFA\u5BF9\u5E94\u73AF\u5883\u7248\u672C\uFF0C\u4F8B\u5982 npm run build:dev"
+      "\u662F\u5426\u53EF\u8FD0\u884C\u65F6\u5207\u6362": true,
+      "\u73AF\u5883\u6765\u6E90": environment.source,
+      "\u5207\u6362\u65B9\u5F0F": "alpha-classic-cli env use <local|dev|test|prod>"
     },
     "\u8BA4\u8BC1": {
       "\u68C0\u67E5\u767B\u5F55": "alpha-classic-cli doctor",
@@ -2016,7 +2049,7 @@ function runCapabilities(version) {
       "\u5378\u8F7D Claude Code": "alpha-classic-cli uninstall --agent claude",
       "\u5378\u8F7D Alpha-claw": "alpha-classic-cli uninstall --agent alphaclaw",
       "\u5378\u8F7D\u5168\u90E8": "alpha-classic-cli uninstall --agent all",
-      "\u8BF4\u660E": "\u7528\u6237\u81EA\u884C\u9009\u62E9\u5B89\u88C5\u76EE\u6807\uFF1BAlpha-claw \u4F1A\u6309 CLI \u6784\u5EFA\u73AF\u5883\u5B89\u88C5\u5230\u5BF9\u5E94 .openclaw-<env>alphaclaw \u5DE5\u4F5C\u533A\u3002"
+      "\u8BF4\u660E": "\u7528\u6237\u81EA\u884C\u9009\u62E9\u5B89\u88C5\u76EE\u6807\uFF1BAlpha-claw \u4F1A\u6309\u5F53\u524D CLI \u73AF\u5883\u5B89\u88C5\u5230\u5BF9\u5E94 .openclaw-<env>alphaclaw \u5DE5\u4F5C\u533A\u3002"
     },
     "\u8F93\u51FA\u534F\u8BAE": {
       "\u6210\u529F": { "ok": true, "data": "\u4E1A\u52A1\u6570\u636E" },
@@ -2300,7 +2333,7 @@ function runCapabilities(version) {
       "\u4E0D\u8981\u8F93\u51FA token\u3002",
       "\u4E0D\u8981\u81EA\u884C\u62FC\u63A5\u540E\u7AEF\u63A5\u53E3\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F7F\u7528 api \u8C03\u8BD5\u547D\u4EE4\u3002",
       "\u4F18\u5148\u4F7F\u7528 capabilities \u4E2D\u58F0\u660E\u7684\u7A33\u5B9A\u4E1A\u52A1\u547D\u4EE4\u3002",
-      "\u73AF\u5883\u8FD0\u884C\u65F6\u4E0D\u53EF\u5207\u6362\uFF0C\u907F\u514D\u8BEF\u8FDE dev/prod\u3002"
+      "\u9700\u8981\u5207\u6362\u73AF\u5883\u65F6\u4F7F\u7528 alpha-classic-cli env use\uFF0C\u5E76\u5728\u5207\u6362\u540E\u91CD\u65B0\u767B\u5F55\u3002"
     ]
   });
 }
@@ -2356,11 +2389,10 @@ function resolveClaudeGuidePath(homeDir = os2.homedir()) {
 function resolveClaudeMemoryPath(homeDir = os2.homedir()) {
   return path2.join(homeDir, ".claude", "CLAUDE.md");
 }
-function resolveAlphaClawSkillPath(homeDir = os2.homedir()) {
-  const environment = getDefaultEnvironmentPreset();
+function resolveAlphaClawSkillPath(homeDir = os2.homedir(), environmentName = DEFAULT_ENVIRONMENT_NAME) {
   return path2.join(
     homeDir,
-    `.openclaw-${environment.name}alphaclaw`,
+    `.openclaw-${environmentName}alphaclaw`,
     "workspace",
     "skills",
     SKILL_NAME
@@ -2409,8 +2441,8 @@ async function uninstallAgentGuides(options) {
     result.claudeMemoryUpdated = claudeResult.claudeMemoryUpdated;
   }
   if (agent === "alphaclaw" || agent === "all") {
-    await fs2.rm(resolveAlphaClawSkillPath(options?.homeDir), { recursive: true, force: true });
-    result.alphaClawSkillPath = resolveAlphaClawSkillPath(options?.homeDir);
+    await fs2.rm(resolveAlphaClawSkillPath(options?.homeDir, options?.environmentName), { recursive: true, force: true });
+    result.alphaClawSkillPath = resolveAlphaClawSkillPath(options?.homeDir, options?.environmentName);
     result.alphaClawSkillInstalled = false;
   }
   return result;
@@ -2425,7 +2457,7 @@ async function installCodexSkill(options) {
   };
 }
 async function installAlphaClawSkill(options) {
-  const skillPath = resolveAlphaClawSkillPath(options?.homeDir);
+  const skillPath = resolveAlphaClawSkillPath(options?.homeDir, options?.environmentName);
   await fs2.rm(skillPath, { recursive: true, force: true });
   await copyDirectory(SKILL_TEMPLATE_ROOT, skillPath);
   return {
@@ -2482,7 +2514,7 @@ async function inspectInstallState(options) {
   } catch {
     claudeGuideInstalled = false;
   }
-  const alphaClawSkillPath = resolveAlphaClawSkillPath(options?.homeDir);
+  const alphaClawSkillPath = resolveAlphaClawSkillPath(options?.homeDir, options?.environmentName);
   let alphaClawSkillInstalled = false;
   try {
     await fs2.access(path2.join(alphaClawSkillPath, "SKILL.md"));
@@ -2549,8 +2581,10 @@ async function removeClaudeImport(memoryPath) {
 async function runDoctor(sessionStore) {
   const config = await sessionStore.getConfig();
   let session = await sessionStore.getSession();
-  const environment = getDefaultEnvironmentPreset();
-  const installState = await inspectInstallState();
+  const environment = await getCurrentEnvironmentPreset(sessionStore);
+  const installState = await inspectInstallState({
+    environmentName: environment.name
+  });
   let apiCheck = {
     ok: false,
     message: "\u672A\u767B\u5F55\u3002\u8BF7\u6267\u884C\uFF1Aalpha-classic-cli login"
@@ -2584,8 +2618,8 @@ async function runDoctor(sessionStore) {
       environment: environment.name,
       baseUrl: environment.baseUrl,
       apiBaseUrl: environment.apiBaseUrl,
-      locked: true,
-      source: "build",
+      locked: false,
+      source: environment.source,
       configPath: sessionStore.configPath
     },
     session: session ? {
@@ -2633,30 +2667,52 @@ function getCurrentUserData2(response) {
 }
 
 // src/commands/env.ts
-async function runEnvCommand(action, _name, _sessionStore) {
+async function runEnvCommand(action, name, sessionStore) {
   const normalizedAction = action?.trim().toLowerCase() ?? "current";
   if (normalizedAction === "list") {
+    const currentEnvironment = await getCurrentEnvironmentPreset(sessionStore);
     printSuccess(listEnvironmentPresets(), {
-      count: listEnvironmentPresets().length
+      count: listEnvironmentPresets().length,
+      current: currentEnvironment.name
     });
     return;
   }
   if (normalizedAction === "current") {
-    const fallback = getDefaultEnvironmentPreset();
+    const currentEnvironment = await getCurrentEnvironmentPreset(sessionStore);
     printSuccess({
-      environment: fallback.name,
-      label: fallback.label,
-      baseUrl: fallback.baseUrl,
-      apiBaseUrl: fallback.apiBaseUrl,
-      locked: true,
-      source: "build"
+      environment: currentEnvironment.name,
+      label: currentEnvironment.label,
+      baseUrl: currentEnvironment.baseUrl,
+      apiBaseUrl: currentEnvironment.apiBaseUrl,
+      locked: false,
+      source: currentEnvironment.source,
+      configPath: sessionStore.configPath
     });
     return;
   }
   if (normalizedAction === "use") {
-    throw new Error(
-      "env use has been removed. This CLI only exposes env list and env current."
-    );
+    if (!name?.trim()) {
+      throw new Error("Missing environment name. Use: alpha-classic-cli env use <local|dev|test|prod>");
+    }
+    const nextEnvironment = getEnvironmentPresetOrThrow(name);
+    await sessionStore.saveConfig({
+      environment: nextEnvironment.name,
+      baseUrl: nextEnvironment.baseUrl,
+      apiBaseUrl: nextEnvironment.apiBaseUrl
+    });
+    await sessionStore.clearAuthState();
+    printSuccess({
+      environment: nextEnvironment.name,
+      label: nextEnvironment.label,
+      baseUrl: nextEnvironment.baseUrl,
+      apiBaseUrl: nextEnvironment.apiBaseUrl,
+      locked: false,
+      source: "config",
+      session: "cleared",
+      hint: "\u73AF\u5883\u5DF2\u5207\u6362\uFF0C\u8BF7\u91CD\u65B0\u6267\u884C alpha-classic-cli login\u3002",
+      configPath: sessionStore.configPath
+    });
+    return;
   }
   throw new Error(`Unknown env action: ${normalizedAction}`);
 }
@@ -2664,7 +2720,7 @@ async function runEnvCommand(action, _name, _sessionStore) {
 // src/commands/matter.ts
 async function runMatterSearch(options, sessionStore) {
   const config = await sessionStore.getConfig();
-  const environment = getDefaultEnvironmentPreset();
+  const environment = await getCurrentEnvironmentPreset(sessionStore);
   const client = new ApiClient({
     sessionStore,
     apiBaseUrl: environment.apiBaseUrl,
@@ -2715,7 +2771,7 @@ async function runMatterDetail(options, sessionStore) {
     throw new Error("Missing matter id. Use: alpha-classic-cli matter detail --id <matterId>");
   }
   const config = await sessionStore.getConfig();
-  const environment = getDefaultEnvironmentPreset();
+  const environment = await getCurrentEnvironmentPreset(sessionStore);
   const client = new ApiClient({
     sessionStore,
     apiBaseUrl: environment.apiBaseUrl,
@@ -2746,7 +2802,7 @@ async function runMatterTaskList(options, sessionStore) {
     throw new Error("Missing matter id. Use: alpha-classic-cli matter task --id <matterId>");
   }
   const config = await sessionStore.getConfig();
-  const environment = getDefaultEnvironmentPreset();
+  const environment = await getCurrentEnvironmentPreset(sessionStore);
   const client = new ApiClient({
     sessionStore,
     apiBaseUrl: environment.apiBaseUrl,
@@ -2798,7 +2854,7 @@ async function runMatterTaskDetail(options, sessionStore) {
     throw new Error("Missing task id. Use: alpha-classic-cli matter task-detail --id <taskId>");
   }
   const config = await sessionStore.getConfig();
-  const environment = getDefaultEnvironmentPreset();
+  const environment = await getCurrentEnvironmentPreset(sessionStore);
   const client = new ApiClient({
     sessionStore,
     apiBaseUrl: environment.apiBaseUrl,
@@ -3820,8 +3876,8 @@ function dateFromTimestamp2(timestamp) {
 }
 
 // src/commands/version.ts
-function runVersion(info) {
-  const environment = getDefaultEnvironmentPreset();
+async function runVersion(info, sessionStore) {
+  const environment = await getCurrentEnvironmentPreset(sessionStore);
   printSuccess({
     "\u540D\u79F0": info.name,
     "\u7248\u672C": info.version,
@@ -3829,7 +3885,8 @@ function runVersion(info) {
     "\u73AF\u5883": environment.name,
     "baseUrl": environment.baseUrl,
     "apiBaseUrl": environment.apiBaseUrl,
-    "\u73AF\u5883\u662F\u5426\u6784\u5EFA\u65F6\u9501\u5B9A": true
+    "\u73AF\u5883\u662F\u5426\u53EF\u8FD0\u884C\u65F6\u5207\u6362": true,
+    "\u73AF\u5883\u6765\u6E90": environment.source
   });
 }
 
@@ -3914,22 +3971,33 @@ async function main() {
   program.name("alpha-classic-cli").description("Alpha Classic AI-friendly CLI for Alpha web app").version(packageJson.version ?? "0.0.0");
   program.command("install").description("Install agent guides for Codex, Claude Code, Alpha-claw, or all supported agents").option("--agent <agent>", "Agent target: codex, claude, alphaclaw, all", "codex").action(async (options) => {
     const agent = parseAgentInstallTarget(options.agent);
-    const result = await installAgentGuides({ agent });
+    const environment = await getCurrentEnvironmentPreset(sessionStore);
+    const result = await installAgentGuides({
+      agent,
+      environmentName: environment.name
+    });
     printSuccess(result);
   });
   program.command("uninstall").description("Uninstall agent guides for Codex, Claude Code, Alpha-claw, or all supported agents").option("--agent <agent>", "Agent target: codex, claude, alphaclaw, all", "codex").action(async (options) => {
     const agent = parseAgentInstallTarget(options.agent);
-    const result = await uninstallAgentGuides({ agent });
+    const environment = await getCurrentEnvironmentPreset(sessionStore);
+    const result = await uninstallAgentGuides({
+      agent,
+      environmentName: environment.name
+    });
     printSuccess(result);
   });
-  program.command("capabilities").description("Print machine-readable CLI capabilities for agents").action(() => {
-    runCapabilities(packageJson.version ?? "0.0.0");
+  program.command("capabilities").description("Print machine-readable CLI capabilities for agents").action(async () => {
+    await runCapabilities(packageJson.version ?? "0.0.0", sessionStore);
   });
-  program.command("version").description("Print machine-readable CLI version").action(() => {
-    runVersion({
-      name: packageJson.name ?? "alpha-classic-cli",
-      version: packageJson.version ?? "0.0.0"
-    });
+  program.command("version").description("Print machine-readable CLI version").action(async () => {
+    await runVersion(
+      {
+        name: packageJson.name ?? "alpha-classic-cli",
+        version: packageJson.version ?? "0.0.0"
+      },
+      sessionStore
+    );
   });
   program.command("login").description("Start Alpha CLI device authorization login").option("--token <token>", "Debug fallback token").option("--user-id <id>", "Current user id").option("--office-id <id>", "Current office id").option("--name <name>", "Current user name").option("--no-wait", "Create device authorization and print JSON only").option("--json", "Print final result as JSON envelope").option("--device-code <deviceCode>", "Poll an existing device code").option("--timeout-ms <ms>", "Device authorization wait timeout", parseInteger).option("--no-open-browser", "Do not open browser when token is missing").action(
     async (options) => {
@@ -3992,7 +4060,7 @@ async function main() {
   program.command("doctor").description("Inspect config, session, skill install, and API health").action(async () => {
     await runDoctor(sessionStore);
   });
-  program.command("env").description("Inspect the build-time environment").argument("[action]", "Action: list, current").argument("[name]", "Environment name for list/current only").action(async (action, name) => {
+  program.command("env").description("Inspect or switch the current environment").argument("[action]", "Action: list, current, use").argument("[name]", "Environment name for env use: local, dev, test, prod").action(async (action, name) => {
     await runEnvCommand(action, name, sessionStore);
   });
   program.command("api").description("Call a raw API endpoint").argument("<method>", "HTTP method").argument("<path>", "API path").option("--params <json>", "Query params JSON object").option("--data <json>", "Request body JSON").action(