work-ally 0.2.0-alpha.2 → 0.2.0-alpha.3

package/README.md

@@ -60,6 +60,7 @@
 - bridge 主干在 `bridge/src/`
 - 产品级 Skill 包在 `skills/`
 - 默认安装与升级走 npm（install-first）
+- 安装后可先执行 `ally prepare` 做 Codex CLI 预检查
 - 官方 Codex runtime 包装在 `runtime/`
 - assistant 长期资产在 `~/.work-ally/assistants/<name>/`
 - 运行期状态、日志、会话都在 assistant desk 的 `.system/`

package/ally.sh

@@ -85,6 +85,7 @@ usage() {
 Usage: $CMD_NAME <command> [args]
 
 Commands:
+  prepare            [machine scope] Preflight Codex CLI prerequisites
   setup              [assistant scope] Create or bind an assistant to a project path
   assistant <subcmd> [global scope] Manage named assistant profiles
   start              [assistant scope] Start a named assistant from anywhere

package/docs/user-quickstart.md

@@ -18,6 +18,12 @@ npm i -g work-ally@alpha
 ally help
 ```
 
+安装后先做一次预检查：
+
+```bash
+ally prepare
+```
+
 ## 三步启动
 
 ```bash
@@ -54,6 +60,7 @@ WORK_ALLY_SOURCE_DIR=/path/to/work-ally ally status --assistant <assistant-name>
 ```
 
 - 当前不支持用户侧定时任务能力；默认不会在无触发时自行执行任务
+- Codex CLI 是必需依赖；未安装时请先按官方指南安装：<https://openrouter.ai/docs/guides/guides/codex-cli>
 
 ## 导出日志包（给支持同学）
 

package/internal/dispatch.sh

@@ -12,6 +12,7 @@ usage() {
 Usage: $cmd_name <command> [args]
 
 Commands:
+  prepare                                  # machine scope; preflight checks for Codex CLI prerequisites
   setup                                    # assistant scope; requires --workspace <path>
   assistant <add|ensure|bind|remove|rename|list|show> [args]   # global profile management
   start                                    # assistant scope; use --assistant <name> when needed
@@ -51,6 +52,9 @@ work_ally_init_context
 work_ally_ensure_state_dirs
 
 case "$CMD" in
+  prepare)
+    exec "$SCRIPT_DIR/modules/runtime/prepare.sh" "$@"
+    ;;
   setup)
     exec "$SCRIPT_DIR/modules/bootstrap/setup.sh" "$@"
     ;;

package/internal/modules/runtime/prepare.sh

@@ -0,0 +1,59 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck disable=SC1091
+. "$SCRIPT_DIR/../../lib/common.sh"
+
+work_ally_init_context
+work_ally_ensure_state_dirs
+
+check_ok=1
+
+work_ally_note "Running preflight checks for official Codex CLI integration"
+
+if command -v codex >/dev/null 2>&1; then
+  codex_bin=$(command -v codex)
+  codex_version=$(codex --version 2>/dev/null | head -n 1 || true)
+  work_ally_ok "codex found: ${codex_bin}${codex_version:+ ($codex_version)}"
+else
+  work_ally_warn "codex command not found"
+  check_ok=0
+fi
+
+global_codex_config="$HOME/.codex/config.toml"
+if [ -f "$global_codex_config" ]; then
+  work_ally_ok "global Codex config found: $global_codex_config"
+else
+  work_ally_warn "global Codex config missing: $global_codex_config"
+  check_ok=0
+fi
+
+if [ -n "${WORK_ALLY_ASSISTANT_NAME:-}" ] && work_ally_registry_has_assistant "$WORK_ALLY_ASSISTANT_NAME"; then
+  assistant_codex_home=$(work_ally_assistant_registered_codex_home "$WORK_ALLY_ASSISTANT_NAME")
+  if [ -n "$assistant_codex_home" ] && [ -d "$assistant_codex_home" ]; then
+    work_ally_ok "assistant codex home ready: $assistant_codex_home"
+  else
+    work_ally_warn "assistant codex home not ready for ${WORK_ALLY_ASSISTANT_NAME:-unknown}"
+  fi
+fi
+
+if [ "$check_ok" -eq 0 ]; then
+  cat <<'EOF2'
+
+Codex CLI is required before using work-ally runtime features.
+Install and configure Codex CLI first:
+https://openrouter.ai/docs/guides/guides/codex-cli
+EOF2
+  work_ally_die "Preflight failed"
+fi
+
+cat <<'EOF2'
+
+Preflight passed.
+You can continue with:
+  ally setup <assistant-name> --workspace <path>
+  ally start --assistant <assistant-name>
+EOF2
+
+work_ally_ok "Prepare checks passed"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "work-ally",
-  "version": "0.2.0-alpha.2",
+  "version": "0.2.0-alpha.3",
   "private": false,
   "type": "module",
   "bin": {
@@ -25,7 +25,7 @@
     "test:full": "npm test",
     "test:fast": "node --test \"tests/unit/**/*.test.mjs\" \"tests/integration/**/*.test.mjs\"",
     "test:maintainer": "bash dev/run-regression-suite.sh",
-    "test:shell": "bash tests/shell/smoke.sh && bash tests/shell/assistant.sh && bash tests/shell/assistant-remove.sh && bash tests/shell/assistant-rename.sh && bash tests/shell/assistant-lock.sh && bash tests/shell/global-entrypoint.sh && bash tests/shell/global-manage.sh && bash tests/shell/security.sh && bash tests/shell/ops.sh && bash tests/shell/lifecycle.sh && bash tests/shell/channel-lock.sh && bash tests/shell/mcp.sh && bash tests/shell/routines.sh && bash tests/shell/recovery.sh && bash tests/shell/service-mode.sh && bash tests/shell/bridge-health-fallback.sh && bash tests/shell/startup-delivery-gate.sh && bash tests/shell/status-health.sh && bash tests/shell/codex-runtime.sh && bash tests/shell/codex-handoff.sh && bash tests/shell/supervised-start-boundary.sh && bash tests/shell/log-export.sh",
+    "test:shell": "bash tests/shell/smoke.sh && bash tests/shell/assistant.sh && bash tests/shell/assistant-remove.sh && bash tests/shell/assistant-rename.sh && bash tests/shell/assistant-lock.sh && bash tests/shell/global-entrypoint.sh && bash tests/shell/global-manage.sh && bash tests/shell/security.sh && bash tests/shell/ops.sh && bash tests/shell/lifecycle.sh && bash tests/shell/channel-lock.sh && bash tests/shell/mcp.sh && bash tests/shell/routines.sh && bash tests/shell/recovery.sh && bash tests/shell/service-mode.sh && bash tests/shell/bridge-health-fallback.sh && bash tests/shell/startup-delivery-gate.sh && bash tests/shell/status-health.sh && bash tests/shell/codex-runtime.sh && bash tests/shell/codex-handoff.sh && bash tests/shell/supervised-start-boundary.sh && bash tests/shell/log-export.sh && bash tests/shell/prepare.sh",
     "test:bridge": "node --test \"tests/unit/**/*.test.mjs\" \"tests/integration/**/*.test.mjs\"",
     "dev:debug-workspace": "bash dev/prepare-debug-workspace.sh",
     "bridge:start": "node bridge/src/server.ts",