Description

As LS APIs update and new ones are introduced, the specification should be derivable from the LS. This ensures the LS client has an accurate information of the parameters and return values for each API.

Describe your problem(s)

No response

Describe your solution(s)

The specification is generated at runtime to determine which services are active and the corresponding specifications relevant to that specific distribution version.

To generate the specification, users can execute the CLI command bal lsspec to output all specifications related to the running LS APIs. The command can be implemented and discovered in two ways:

1. Implemented in the cli module, making the command available out of the box with the distribution. This approach doesn't involve maintaining releases and is packaged with ballerina-lang build.
2. Implemented as a Ballerina tool in a separate module. Users who want to use this command would need to pull the respective command from the central.

Related area

-> Compilation

Related issue(s) (optional)

No response

Suggested label(s) (optional)

No response

Suggested assignee(s) (optional)

No response