cline/testing-platform/README.md

Cline Testing Platform

A CLI testing framework for the Cline Core extension, providing gRPC-based integration clients and utilities for automated scenarios.

Overview

The platform enables end-to-end validation of Cline's core functionality through:

• gRPC Adapters – clients for Cline’s gRPC services
  
• Test Harness – runner, utilities, and type definitions
  
• Spec Files – JSON instructions for automated test cases
  

Structure

testing-platform/
├── adapters/           # gRPC communication adapters
│   ├── grpcAdapter.ts     # Main gRPC adapter implementation
├── harness/            # Test execution framework
│   ├── runner.ts          # Main test runner
│   ├── types.ts           # Type definitions
│   └── utils.ts           # Utility functions

Prerequisites

• Node.js ≥ 18 and npm ≥ 8
  
• Protocol Buffers (used for gRPC)
  

Generate proto files in the root Cline project:

npm run protos

Setup

From the root of the Cline project:

npm run install:all
npm run protos

Then install and build the testing platform:

cd testing-platform
npm install
npm run build

Running Spec File Tests

Before running specs, make sure the standalone Cline Core gRPC server (that runs mocks and host gRPC as well) is running:

npm run test:sca-server

Then finally you can run the cli as:

npm run start:dev <spec-file-or-folder>

bash