Skip to content

feat: add web server scaffold and cdk explore command (#1578) - #1598

Merged
megha-narayanan merged 2 commits into
aws:feat/cdk-explorerfrom
megha-narayanan:feat/cdk-explorer-web-scaffold
Jun 4, 2026
Merged

feat: add web server scaffold and cdk explore command (#1578)#1598
megha-narayanan merged 2 commits into
aws:feat/cdk-explorerfrom
megha-narayanan:feat/cdk-explorer-web-scaffold

Conversation

@megha-narayanan

Copy link
Copy Markdown
Contributor
  • Adds a minimal Express web server in @aws-cdk/cdk-explorer with a /api/health endpoint
  • Wires up cdk explore as a CLI subcommand that starts the server and blocks until SIGINT/SIGTERM
  • Port behavior: auto-increments from 4200 if default is taken; throws if an explicit --port is unavailable

Fixes #

  • This change contains a major version upgrade for a dependency and I confirm all breaking changes are addressed
    • Release notes for the new version:

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license


Fixes #

Checklist

  • This change contains a major version upgrade for a dependency and I confirm all breaking changes are addressed
    • Release notes for the new version:

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

- Adds a minimal Express web server in `@aws-cdk/cdk-explorer` with a
`/api/health` endpoint
- Wires up `cdk explore` as a CLI subcommand that starts the server and
blocks until SIGINT/SIGTERM
- Port behavior: auto-increments from 4200 if default is taken; throws
if an explicit -`-port` is unavailable

Fixes #

- [ ] This change contains a major version upgrade for a dependency and
I confirm all breaking changes are addressed
  - Release notes for the new version:

---
By submitting this pull request, I confirm that my contribution is made
under the terms of the Apache-2.0 license

---------

Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@megha-narayanan
megha-narayanan marked this pull request as ready for review June 4, 2026 18:15
@megha-narayanan
megha-narayanan merged commit aae2e60 into aws:feat/cdk-explorer Jun 4, 2026
11 of 13 checks passed
@megha-narayanan
megha-narayanan deleted the feat/cdk-explorer-web-scaffold branch June 4, 2026 18:15
megha-narayanan added a commit that referenced this pull request Jul 7, 2026
…r stdio (#1670)

Editors and AI agents start a language server by running a command over
stdio,
but the CDK Language Server (in `@aws-cdk/cdk-explorer`) has no such
entry
point. This adds one, so any LSP-capable editor or agent can get CDK
diagnostics and CodeLens by pointing at `cdk lsp`.

Wires up `cdk lsp` as a CLI subcommand that starts the server on
stdin/stdout
and runs until the client closes the channel.

- Adds `@aws-cdk/cdk-explorer` as a runtime dependency so the server
ships in the CLI bundle, version-aligned with the user's CDK toolchain.
- Writes nothing to stdout (CLI logs already go to stderr), keeping the
JSON-RPC channel clean. `applicationDir` comes from the LSP `initialize`
options, so the command takes no arguments.
- Mirrors the `cdk explore` wiring from #1598 

Fixes #

### Checklist
- [ ] This change contains a major version upgrade for a dependency and
I confirm all breaking changes are addressed
  - Release notes for the new version:

---
By submitting this pull request, I confirm that my contribution is made
under the terms of the Apache-2.0 license
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants