feat: basic cli support by jesse23 · Pull Request #3 · jesse23/webtty

jesse23 · 2026-03-22T00:12:25Z

Summary

This PR implements basic CLI support for wtty, including:

ADR 002: CLI start/stop functionality with POST /api/server/stop endpoint
ADR 003: Automated release process using semantic-release with npm publishing

Changes

CLI implementation in src/cli.ts
Server stop endpoint in src/server.ts
Release configuration (.releaserc.json, release.yml)
Build and package configuration updates
Documentation and ADR updates

Related ADRs

ADR 002: CLI start/stop
ADR 003: Release process

…t template

- Set up semantic-release for automated versioning and GitHub releases. - Update release workflow to push git tags and create releases with release notes. - Add CLI commands for starting and stopping the server. - Modify build script to include CLI entry point. - Introduce .releaserc.json for semantic-release configuration. - Update package.json to reflect development version and add CLI binary. - Enhance server to handle stop command via API.

…ntegration

…ish dependency

Ultraworked with Sisyphus Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

…ode-pty.d.ts Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Copilot

Pull request overview

Adds basic operational tooling around wtty by introducing a wtty CLI with start/stop behavior, a server shutdown HTTP endpoint, and an automated release workflow driven by semantic-release.

Changes:

Introduces src/cli.ts (wtty start / wtty stop) and adds POST /api/server/stop to shut down the running server.
Adds Bun tests for the CLI and server shutdown behavior.
Adds semantic-release configuration plus release workflow + packaging tweaks for npm publishing.

Reviewed changes

Copilot reviewed 17 out of 20 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
tsconfig.lint.json	Simplifies lint TS config overrides.
tsconfig.json	Updates TS compiler options (notably adds `verbatimModuleSyntax`).
src/server.ts	Adds `POST /api/server/stop` shutdown endpoint.
src/server.test.ts	Adds integration tests for server HTTP behavior + shutdown.
src/pty/node-pty.d.ts	Adds local type declarations for `@lydell/node-pty`.
src/cli.ts	Adds CLI entrypoint implementing `start`/`stop`.
src/cli.test.ts	Adds integration tests for CLI behavior.
scripts/clean-pkg-scripts.ts	Adds prepublish helper to strip `scripts`/`devDependencies` before publish.
scripts/build.ts	Builds both server + CLI into `dist/`.
package.json	Exposes `bin`, adjusts scripts, adds semantic-release, sets publishable version placeholder.
docs/specs/release-process.md	Documents semantic-release-based release pipeline.
docs/specs/cli.md	Links server lifecycle spec row to ADR 002.
docs/adrs/003.release-process.semantic-release.md	Adds ADR for semantic-release release strategy.
docs/adrs/002.cli.start-stop.md	Adds ADR for CLI start/stop and HTTP stop endpoint.
bun.lock	Locks new dependency tree for semantic-release.
.releaserc.json	Adds semantic-release configuration.
.npmignore	Adds npm ignore rules for source/docs/config.
.github/workflows/release.yml	Implements semantic-release + publish steps on `main`.
.github/workflows/copilot-review.yml	Removes Copilot Review workflow.
.github/pull_request_template.md	Adds PR template with ADR section.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Copilot

Pull request overview

Copilot reviewed 17 out of 20 changed files in this pull request and generated 5 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Copilot

Pull request overview

Copilot reviewed 17 out of 20 changed files in this pull request and generated 1 comment.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

….json.bak

Copilot

Pull request overview

Copilot reviewed 17 out of 21 changed files in this pull request and generated 4 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Ultraworked with Sisyphus Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Copilot

Pull request overview

Copilot reviewed 17 out of 21 changed files in this pull request and generated 5 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Copilot

Pull request overview

Copilot reviewed 17 out of 21 changed files in this pull request and generated 1 comment.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Copilot

Pull request overview

Copilot reviewed 17 out of 21 changed files in this pull request and generated 1 comment.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Copilot

Pull request overview

Copilot reviewed 17 out of 21 changed files in this pull request and generated 1 comment.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

…age if not found

feat: basic cli support

jesse23 and others added 12 commits March 21, 2026 17:01

refactor: remove unused compiler options from tsconfig files

1e9370e

docs: update CLI specification with ADR reference and add pull reques…

8432a30

…t template

feat: enhance release process with npm publishing and clean-publish i…

00dbb9f

…ntegration

feat: update release process to use npm publish and remove clean-publ…

260a071

…ish dependency

fix: use template literal in clean-pkg-scripts

29954f5

Ultraworked with Sisyphus Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

test: add integration tests for server endpoints

2486ada

Ultraworked with Sisyphus Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

test: add integration tests for CLI start/stop

a4efdf4

Ultraworked with Sisyphus Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

ci: add actions/checkout@v4 step before Copilot review

6d51de9

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

ci: remove copilot-review workflow

cfa0b27

fix: add TypeScript ambient module declaration for @lydell/node-pty

d3fa276

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

refactor: move TypeScript declarations from src/env.d.ts to src/pty/n…

4afd418

…ode-pty.d.ts Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

jesse23 requested a review from Copilot March 22, 2026 00:36

Copilot started reviewing on behalf of jesse23 March 22, 2026 00:37 View session

Copilot AI reviewed Mar 22, 2026

View reviewed changes

Comment thread src/server.test.ts Outdated

Comment thread src/cli.ts Outdated

Comment thread src/cli.ts

Comment thread src/server.ts

Comment thread .github/workflows/release.yml Outdated

Comment thread .github/workflows/release.yml Outdated

Comment thread src/cli.test.ts Outdated

jesse23 and others added 3 commits March 21, 2026 20:47

fix: resolve server entry and fetch error handling in CLI

677c85b

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

test: use dynamic port allocation via getFreePort()

b5e6856

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

fix: update release pipeline to use npm publish

3728aab

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

jesse23 requested a review from Copilot March 22, 2026 00:53

Copilot started reviewing on behalf of jesse23 March 22, 2026 00:53 View session

Copilot AI reviewed Mar 22, 2026

View reviewed changes

Comment thread docs/adrs/002.cli.start-stop.md Outdated

Comment thread docs/adrs/003.release-process.semantic-release.md

Comment thread scripts/clean-pkg-scripts.ts Outdated

Comment thread package.json Outdated

Comment thread docs/adrs/002.cli.start-stop.md

jesse23 and others added 2 commits March 21, 2026 21:01

docs: update ADR status to Accepted and fix wording

ce4e07e

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

fix: restore package.json on exit via process handlers

bc97036

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

jesse23 requested a review from Copilot March 22, 2026 01:02

Copilot started reviewing on behalf of jesse23 March 22, 2026 01:02 View session

Copilot AI reviewed Mar 22, 2026

View reviewed changes

Comment thread scripts/clean-pkg-scripts.ts Outdated

jesse23 and others added 2 commits March 21, 2026 21:09

fix: implement package.json strip/restore on publish

bbbe019

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

chore: rename BACKUP_PATH from package.json.publish-backup to package…

b942474

….json.bak

jesse23 requested a review from Copilot March 22, 2026 01:29

Copilot started reviewing on behalf of jesse23 March 22, 2026 01:29 View session

fix: wrap restore block in try/catch to handle missing backup gracefully

8a8665f

jesse23 requested a review from Copilot March 22, 2026 01:35

Copilot started reviewing on behalf of jesse23 March 22, 2026 01:36 View session

Copilot AI reviewed Mar 22, 2026

View reviewed changes

Comment thread src/cli.ts Outdated

Comment thread src/server.test.ts Outdated

Comment thread src/cli.test.ts

Comment thread src/cli.test.ts

fix: rename npm scripts and guard backup strip against stale .bak files

5a1812a

Ultraworked with Sisyphus Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

jesse23 requested a review from Copilot March 22, 2026 01:48

Copilot started reviewing on behalf of jesse23 March 22, 2026 01:49 View session

Copilot AI reviewed Mar 22, 2026

View reviewed changes

Comment thread src/cli.test.ts

Comment thread src/cli.test.ts

Comment thread docs/adrs/003.release-process.semantic-release.md Outdated

Comment thread package.json

Comment thread src/server.test.ts

jesse23 and others added 3 commits March 21, 2026 21:58

fix: use 127.0.0.1 instead of localhost in CLI and build

9b284d1

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

test: replace Bun.sleep with waitForServerDown polling

1bcc558

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

chore: add Node.js engine requirement and update release process

0141cf5

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

jesse23 requested a review from Copilot March 22, 2026 02:02

Copilot started reviewing on behalf of jesse23 March 22, 2026 02:02 View session

Copilot AI reviewed Mar 22, 2026

View reviewed changes

Comment thread src/server.ts Outdated

fix: update server log message to use 127.0.0.1 instead of localhost

3451bfe

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

jesse23 requested a review from Copilot March 22, 2026 02:10

Copilot started reviewing on behalf of jesse23 March 22, 2026 02:10 View session

Copilot AI reviewed Mar 22, 2026

View reviewed changes

Comment thread scripts/build.ts Outdated

fix: add trailing newline to CLI banner string

966aed2

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-opencode) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

jesse23 requested a review from Copilot March 22, 2026 02:17

Copilot started reviewing on behalf of jesse23 March 22, 2026 02:17 View session

Copilot AI reviewed Mar 22, 2026

View reviewed changes

Comment thread src/cli.ts

fix: check serverEntry exists before spawning, exit 1 with error mess…

ad9043c

…age if not found

jesse23 assigned jesse23 and unassigned Copilot Mar 22, 2026

jesse23 merged commit 5671542 into main Mar 22, 2026
3 checks passed

jesse23 mentioned this pull request Mar 22, 2026

fix: post-review fixes and release pipeline #4

Merged

jesse23 added a commit that referenced this pull request Mar 23, 2026

Merge pull request #3 from jesse23/feat/basic-cli-support

bf8bcb8

feat: basic cli support

jesse23 added a commit that referenced this pull request Mar 23, 2026

feat: basic cli support (#3)

ff197f5

jesse23 mentioned this pull request Mar 25, 2026

feat: CLI polish, static client assets, config system, and test infrastructure #15

Merged

Conversation

jesse23 commented Mar 22, 2026

Summary

Changes

Related ADRs

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants