Skip to content

fix(stack-cli): clarify editor URL in dev server startup output#183

Open
avrahamr wants to merge 1 commit into
jay-framework:mainfrom
avrahamr:fix/dev-server-editor-link
Open

fix(stack-cli): clarify editor URL in dev server startup output#183
avrahamr wants to merge 1 commit into
jay-framework:mainfrom
avrahamr:fix/dev-server-editor-link

Conversation

@avrahamr

@avrahamr avrahamr commented Jul 9, 2026

Copy link
Copy Markdown

Problem

The dev server startup banner prints:

🎨 Editor Server: http://localhost:3301 (ID: init)

This reads like a URL you open in a browser, but :3301 (the editor port) is a Socket.io / port-discovery backend. Its only HTTP route is /editor-connect; every other path — including /, which is what a browser requests — returns Not Found. So users naturally open the advertised link and hit a 404, thinking the editor is broken.

Change

  • packages/jay-stack/stack-cli/lib/server.ts: relabel the line to point at the actual editor UI (/aiditor on the dev server port) and demote the socket server URL to a clarifying sub-line.
  • packages/jay-stack/stack-cli/README.md: update the sample startup output to match.

New output:

🎨 Editor (AIditor): http://localhost:3000/aiditor
   (editor socket server on http://localhost:3101, ID: init)

The 📱 Dev Server: line is intentionally left unchanged, since the smoke tests parse it to detect the server URL.

Open questions for maintainers

  • /aiditor assumption. The /aiditor route is contributed by the aiditor plugin, not the CLI core. If a project runs the dev server without that plugin, the printed link won't resolve. Happy to gate the AIditor line on the plugin being present, or to reword so it only clarifies the socket server without asserting /aiditor — whichever you prefer.
  • Left the historical design-log/83 - dev server logging and timing.md sample output untouched, treating design-log entries as dated records rather than living docs. Let me know if you'd rather I update those too.

Validation

Built and tested locally against @jay-framework/jay-stack-cli:

  • yarn install (workspace) — ✅
  • wsrun -p @jay-framework/jay-stack-cli -r -t build — ✅ (edit confirmed present in compiled dist/index.js)
  • build:check-types (tsc) — ✅ no type errors
  • test (vitest) — ✅ 108/108 passing across 7 files

Scoped to the stack-cli package (where the change lives), not a full-monorepo yarn test.

The startup banner advertised 'Editor Server: http://localhost:<editorPort>',
which reads like a browsable page. That port is a Socket.io/port-discovery
backend whose only HTTP route is /editor-connect — every other path (including
/) returns 'Not Found', so users who open it in a browser hit a 404.

Point the line at the actual editor UI (/aiditor on the dev server) and keep the
socket server URL as a clarifying sub-line.
@avrahamr avrahamr marked this pull request as ready for review July 9, 2026 14:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant