AI Agents SDE Task Viewer
      • Context
      • Plan
      • Prd
  1. Home
  2. AgentSDE
  3. agent-core-control-center
  4. gh-46
  5. plan
  6. plan.md
plan.md(1.6 KB)· Apr 2, 2026· 1 min read
  • Summary
  • Files
  • Steps
  • Verification
  • Risks

Plan: Fix failing deploy workflow — remove broken Volta dependency#

Summary#

The deploy workflow fails because volta is not in $PATH on the self-hosted runner (~/.volta/bin is missing from PATH), so volta install node@20 errors with No such file or directory. Node v22 is available directly via ~/.volta/tools/image/node/22.22.0/bin/node (which is in PATH). The fix: remove the Volta step from deploy.yml to align with agent-core's working deploy pattern, and add a node --version smoke check as a recurrence guard.

Files#

FileActionDescription
.github/workflows/deploy.ymlmodifyRemove "Ensure Node via Volta" step; add node --version guard step

Steps#

  1. Remove the "Ensure Node via Volta" step from .github/workflows/deploy.yml — delete the volta install node@20 step entirely.
  2. Add a "Verify Node available" guard step before "Install dependencies" — run node --version so the workflow fails fast with a clear error if Node ever disappears from the runner.
  3. Validate workflow YAML — confirm the file is syntactically valid and step ordering is correct.

Verification#

  • npm run lint passes with zero warnings.
  • npm run build completes successfully.
  • deploy.yml contains no Volta references; includes node --version guard step before npm install.

Risks#

  • If the runner's Node path (~/.volta/tools/image/node/22.22.0/bin) is removed or changes, the deploy will fail at the new node --version guard step with a clear error message rather than a cryptic Volta error.
ContextPrd