feat(ripple): add `bit ripple` CLI for Ripple CI management by davidfirst · Pull Request #10261 · teambit/bit

davidfirst · 2026-03-30T16:01:06Z

Adds a new bit ripple command with subcommands for managing Ripple CI jobs from the CLI:

bit ripple list — list recent jobs with filters (owner, scope, lane, status, user, limit)
bit ripple log [job-id] — show job details and per-component build status
bit ripple errors [job-id] — show build errors with actual log output from containers
bit ripple retry [job-id] — retry a failed job
bit ripple stop [job-id] — stop a running job

All commands auto-detect the current lane from .bitmap when no job-id is given. The errors command fetches container logs in parallel from the Ripple SSE endpoint with idle timeouts for fast response (~5s).

New aspect: teambit.cloud/ripple at scopes/cloud/ripple/.

Adds a new aspect (teambit.cloud/ripple) providing CLI access to Ripple CI: - `bit ripple list` — list recent jobs with filters (owner, scope, status, limit) - `bit ripple log [job-id]` — show job details and component build status - `bit ripple errors [job-id]` — show build errors with actual log output - `bit ripple retry [job-id]` — retry a failed job - `bit ripple stop [job-id]` — stop a running job All commands auto-detect the current lane from .bitmap when no job-id is given. Error logs are fetched in parallel from the Ripple SSE endpoint with idle timeouts.

Copilot

Pull request overview

Introduces a new core aspect (teambit.cloud/ripple) that adds a bit ripple CLI namespace for interacting with Ripple CI jobs on bit.cloud (list/log/errors/retry/stop), and wires it into Bit’s core aspect manifests so it loads as part of the standard CLI.

Changes:

Added new teambit.cloud/ripple aspect with bit ripple command + subcommands for job inspection and control.
Registered the new aspect in core aspect manifests and core-aspects IDs list.
Added the Ripple aspect to the workspace .bitmap.

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
scopes/harmony/testing/load-aspect/core-aspects-ids.json	Adds `teambit.cloud/ripple` to the generated list of core aspects.
scopes/harmony/bit/manifests.ts	Registers `RippleAspect` in the core manifests map so the aspect loads in Bit CLI.
scopes/cloud/ripple/ripple.main.runtime.ts	Implements RippleMain: GraphQL calls, SSE log fetching, lane auto-detection helpers, and CLI registration.
scopes/cloud/ripple/ripple.cmd.ts	Adds the top-level `bit ripple` command entry point.
scopes/cloud/ripple/ripple.aspect.ts	Declares the `teambit.cloud/ripple` aspect ID.
scopes/cloud/ripple/ripple-stop.cmd.ts	Implements `bit ripple stop` subcommand.
scopes/cloud/ripple/ripple-retry.cmd.ts	Implements `bit ripple retry` subcommand.
scopes/cloud/ripple/ripple-log.cmd.ts	Implements `bit ripple log` subcommand.
scopes/cloud/ripple/ripple-list.cmd.ts	Implements `bit ripple list` subcommand.
scopes/cloud/ripple/ripple-errors.cmd.ts	Implements `bit ripple errors` subcommand, including container log parsing.
scopes/cloud/ripple/index.ts	Exports the Ripple aspect (and RippleMain type).
.bitmap	Tracks the new `ripple` component under `teambit.cloud`.

scopes/cloud/ripple/ripple.main.runtime.ts

scopes/cloud/ripple/ripple-errors.cmd.ts

scopes/cloud/ripple/ripple-list.cmd.ts

scopes/cloud/ripple/ripple.main.runtime.ts

- Use Workspace API directly (getCurrentLaneId, defaultScope) instead of manually parsing .bitmap and workspace.jsonc - Add null guard for job in json() method of errors command - Remove unused --component flag from errors command - Validate --limit flag in list command

Extract colorPhase, stripComponentVersion, resolveJobId to ripple-utils.ts. Remove unused methods, types, and GQL queries. Fix idleTimer cleanup leak.

Copilot

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 11 comments.

scopes/cloud/ripple/ripple.main.runtime.ts

scopes/cloud/ripple/ripple-list.cmd.ts

scopes/cloud/ripple/ripple-errors.cmd.ts

scopes/cloud/ripple/ripple-list.cmd.ts

scopes/cloud/ripple/ripple.main.runtime.ts

scopes/cloud/ripple/ripple-stop.cmd.ts

scopes/cloud/ripple/ripple-log.cmd.ts

scopes/cloud/ripple/ripple.main.runtime.ts

scopes/cloud/ripple/ripple-list.cmd.ts

- Fix scope.replace('.', '/') to handle multiple dots in scope names - Improve --owner and --lane option descriptions to match actual behavior - Throw clear error for invalid --limit values instead of misleading empty results

Copilot

Pull request overview

Copilot reviewed 12 out of 12 changed files in this pull request and generated 15 comments.

scopes/cloud/ripple/ripple.main.runtime.ts

scopes/cloud/ripple/ripple-stop.cmd.ts

scopes/cloud/ripple/ripple-retry.cmd.ts

scopes/cloud/ripple/ripple-errors.cmd.ts

scopes/cloud/ripple/ripple-log.cmd.ts

scopes/cloud/ripple/ripple.main.runtime.ts

scopes/cloud/ripple/ripple-errors.cmd.ts

Copilot

Pull request overview

Copilot reviewed 13 out of 13 changed files in this pull request and generated 2 comments.

scopes/cloud/ripple/ripple.main.runtime.ts

Switch from teambit.harmony/node to teambit.harmony/envs/core-aspect-env so that Babel's lazy require transform is applied, reducing bootstrap file reads.

…strap reads Move all subcommand classes into ripple.cmd.ts to eliminate 5 separate file reads during bootstrap, bringing the total under the 1050 threshold.

Copilot

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated 3 comments.

Copilot · 2026-03-30T21:34:03Z

scopes/cloud/ripple/ripple.main.runtime.ts

+      const response = await fetch(url, { headers, signal: controller.signal });
+      if (!response.ok || !response.body) {
+        clearTimeout(hardTimeout);
+        return [];
+      }
+      const reader = response.body.getReader();
+      const decoder = new TextDecoder();
+      let buffer = '';


getContainerLog() reads response.body.getReader() (WHATWG streams). With the repo’s current engines.node >=12.22.0, this will not work in older Node runtimes, and the errors command will fail when fetching logs. Consider aligning the repo’s declared Node support (>=18) or reworking log consumption to a Node stream-compatible implementation.

Copilot · 2026-03-30T21:34:04Z

scopes/cloud/ripple/ripple.cmd.ts

+    const table = new Table({
+      head: [
+        chalk.cyan('Job ID'),
+        chalk.cyan('Name'),
+        chalk.cyan('Scope'),
+        chalk.cyan('Status'),
+        chalk.cyan('User'),
+        chalk.cyan('Started'),
+        chalk.cyan('Duration'),
+      ],
+      chars: {
+        top: '',
+        'top-mid': '',
+        'top-left': '',
+        'top-right': '',
+        bottom: '',
+        'bottom-mid': '',
+        'bottom-left': '',
+        'bottom-right': '',
+        left: '',
+        'left-mid': '',
+        mid: '',
+        'mid-mid': '',
+        right: '',
+        'right-mid': '',
+        middle: ' ',
+      },
+      style: { 'padding-left': 1, 'padding-right': 1 },
+    });


The cli-table rendering configuration (custom chars + padding) is duplicated in multiple places in this file. Consider extracting a small helper (e.g. createCompactTable(head)) to keep table formatting consistent and reduce future maintenance when the layout needs to change.

Copilot · 2026-03-30T21:34:04Z

scopes/cloud/ripple/ripple.cmd.ts

+    const table = new Table({
+      head: [chalk.cyan('Task'), chalk.cyan('Status'), chalk.cyan('Started'), chalk.cyan('Warnings')],
+      chars: {
+        top: '',
+        'top-mid': '',
+        'top-left': '',
+        'top-right': '',
+        bottom: '',
+        'bottom-mid': '',
+        'bottom-left': '',
+        'bottom-right': '',
+        left: '',
+        'left-mid': '',
+        mid: '',
+        'mid-mid': '',
+        right: '',
+        'right-mid': '',
+        middle: ' ',
+      },
+      style: { 'padding-left': 1, 'padding-right': 1 },
+    });


This file defines another cli-table instance with the same custom chars/style config as the list output above. Extracting a shared helper for table creation would avoid format drift and reduce duplication.

Copilot AI review requested due to automatic review settings March 30, 2026 16:01

Copilot started reviewing on behalf of davidfirst March 30, 2026 16:01 View session

Merge branch 'master' into feat/ripple-cli

13e6c84

Copilot AI reviewed Mar 30, 2026

View reviewed changes

davidfirst added 2 commits March 30, 2026 12:59

refactor(ripple): extract shared utilities and remove dead code

63839d9

Extract colorPhase, stripComponentVersion, resolveJobId to ripple-utils.ts. Remove unused methods, types, and GQL queries. Fix idleTimer cleanup leak.

Copilot AI review requested due to automatic review settings March 30, 2026 18:00

Copilot started reviewing on behalf of davidfirst March 30, 2026 18:01 View session

fix(ripple): fix lint errors in ripple-log and ripple-utils

671a0bf

Copilot AI reviewed Mar 30, 2026

View reviewed changes

fix(ripple): address copilot review feedback

db32349

- Fix scope.replace('.', '/') to handle multiple dots in scope names - Improve --owner and --lane option descriptions to match actual behavior - Throw clear error for invalid --limit values instead of misleading empty results

Copilot AI review requested due to automatic review settings March 30, 2026 18:08

GiladShoham approved these changes Mar 30, 2026

View reviewed changes

davidfirst enabled auto-merge (squash) March 30, 2026 18:11

Copilot AI reviewed Mar 30, 2026

View reviewed changes

davidfirst added 2 commits March 30, 2026 14:28

fix(ripple): add missing ripple-utils.ts

3814751

fix(ripple): handle both FAILURE and FAILED phase values consistently

ef90cb5

Copilot AI review requested due to automatic review settings March 30, 2026 18:33

Copilot started reviewing on behalf of davidfirst March 30, 2026 18:34 View session

Copilot AI reviewed Mar 30, 2026

View reviewed changes

scopes/cloud/ripple/ripple.main.runtime.ts Show resolved Hide resolved

scopes/cloud/ripple/ripple.main.runtime.ts Show resolved Hide resolved

davidfirst added 2 commits March 30, 2026 16:38

fix(ripple): use core-aspect-env for lazy-loaded imports

de02c01

Switch from teambit.harmony/node to teambit.harmony/envs/core-aspect-env so that Babel's lazy require transform is applied, reducing bootstrap file reads.

perf(ripple): consolidate subcommands into single file to reduce boot…

093a5d1

…strap reads Move all subcommand classes into ripple.cmd.ts to eliminate 5 separate file reads during bootstrap, bringing the total under the 1050 threshold.

Copilot AI review requested due to automatic review settings March 30, 2026 21:28

Copilot started reviewing on behalf of davidfirst March 30, 2026 21:29 View session

Copilot AI reviewed Mar 30, 2026

View reviewed changes

davidfirst merged commit 693c624 into master Mar 30, 2026
16 checks passed

davidfirst deleted the feat/ripple-cli branch March 30, 2026 22:09

Conversation

davidfirst commented Mar 30, 2026

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!

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!

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!

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!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Mar 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 30, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 30, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants