Skip to content

refactor: rename dev scripts for clearer naming convention#227

Draft
malhotra5 wants to merge 1 commit into
mainfrom
rohit/refactor-dev-scripts-naming
Draft

refactor: rename dev scripts for clearer naming convention#227
malhotra5 wants to merge 1 commit into
mainfrom
rohit/refactor-dev-scripts-naming

Conversation

@malhotra5
Copy link
Copy Markdown
Member

Summary

This PR refactors the development scripts to use a clearer, more intuitive naming convention. The main change is renaming dev-safe.mjs to dev-server.mjs and introducing a consistent naming scheme that describes what services each script launches.

Changes

Script Renames

Old Name New Name Services
devdev:automation devdev:full All (agent-server + automation + canvas)
dev:safe / dev:minimal dev:server Agent-server + Canvas
dev:frontend dev:canvas Canvas only

Files Changed

  • Renamed: scripts/dev-safe.mjsscripts/dev-server.mjs
  • Renamed: __tests__/scripts/dev-safe.test.ts__tests__/scripts/dev-server.test.ts
  • Updated imports in:
    • scripts/dev-with-automation.mjs
    • scripts/dev-extra-backend.mjs
    • scripts/dev-static.mjs
  • Updated docs: DEVELOPMENT.md, AGENTS.md
  • Updated package.json: New script aliases + backward-compatible legacy aliases

Backward Compatibility

Legacy script names are preserved as npm aliases pointing to the new names:

  • dev:safedev:server
  • dev:minimaldev:server
  • dev:frontenddev:canvas
  • dev:automationdev:full

Quick Reference Table

Script Services Description
npm run dev All Full stack (default)
npm run dev:full All Explicit full stack
npm run dev:server Agent-server + Canvas Without automation
npm run dev:canvas Canvas only Assumes running backend
npm run dev:mock Canvas (mocked) Frontend with MSW
npm run dev:extra-backend Agent-server only Additional backend
npm run dev:static All With production build

Testing

  • All existing tests pass
  • Renamed test file properly imports from new script path
  • Typecheck passes

Fixes #226


This PR was created by an AI agent (OpenHands) on behalf of the user.

@malhotra5 can click here to continue refining the PR

- Rename dev-safe.mjs to dev-server.mjs
- Add dev:full as explicit full stack script (default)
- Add dev:server for agent-server + canvas only
- Add dev:canvas for frontend-only development
- Keep legacy aliases (dev:safe, dev:minimal, dev:frontend, dev:automation)
  for backward compatibility
- Update all imports and documentation

Script naming convention:
- dev / dev:full: All services (agent-server + automation + canvas)
- dev:server: Agent-server + Canvas (no automation)
- dev:canvas: Canvas only (assumes running backend)
- dev:mock: Canvas with MSW mock APIs
- dev:extra-backend: Additional standalone agent-server
- dev:static: Full stack with production build

Fixes #226

Co-authored-by: openhands <openhands@all-hands.dev>
@malhotra5 malhotra5 added the enhancement New feature or request label May 9, 2026 — with OpenHands AI
@vercel
Copy link
Copy Markdown

vercel Bot commented May 9, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agent-canvas Ready Ready Preview, Comment May 9, 2026 3:03pm

Request Review

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Refactor dev scripts: rename dev-safe and add modular service launch options

2 participants