Improve npm alpha publishing readiness

Merged
SL
5mo ago
+555-36

Summary\n- expands codex-claw doctor to check Node.js, npm auth, pnpm, Git, Codex CLI, state directory writability, and dev port availability\n- adds packed-tarball and npm-alpha install smoke scripts, then wires packed smoke coverage into CI and release packaging\n- documents Windows, macOS, and Linux alpha install/update paths with troubleshooting for npm auth, package-not-found, locked ports, and missing Codex CLI\n\n## Verification\n-

ode --check packages/codex-claw/bin/codex-claw.js\n-
ode --check packages/codex-claw/scripts/install-smoke.mjs\n-
ode packages/codex-claw/bin/codex-claw.js doctor --port 65534\n- pnpm smoke:codex-claw:pack\n- pnpm smoke:codex-claw:npm reports the expected package-not-found message until the first npm alpha publish\n- pnpm -C apps/codex-claw lint\n- pnpm -C apps/codex-claw test\n- pnpm -C apps/codex-claw build\n- pnpm pack:codex-claw\n\nCloses #94


Summary by cubic

Prepares codex-claw for npm alpha publishing by expanding doctor checks and adding cross‑platform smoke tests for packed tarballs and the alpha tag. Wires smoke tests into CI/release and updates docs for install, update, and troubleshooting.

  • New Features

    • doctor: checks Node.js (>=20), npm auth, pnpm, git + worktree, Codex CLI (--codex-command), state dir (--state-dir), and dev port (--port, --no-port-check); prints ok/warn/fail with summary; exits non‑zero on failures.
    • Smoke tests: scripts/install-smoke.mjs with pnpm smoke:codex-claw (pack alias), pnpm smoke:codex-claw:pack (packed tarball), and pnpm smoke:codex-claw:npm (published alpha); integrated into CI and release.
  • Bug Fixes

    • Install smoke avoids shell quoting by invoking the npm CLI directly, improving Windows/macOS/Linux reliability.