Refactor project structure according to actual logical layers (#93)

This is not just a refactoring, but actually an enhancement in different areas of the project. With this changes we are seeing following improvements:
- The LLM has become capable of properly understanding the project, reading, and writing code. Previously, it often introduced errors by modifying OpenAPI‑generated code, which required additional iterations.
- The updated structure is simple and intuitive, especially for people more familiar to JavaScript projects.
- A similar approach is used in other popular libraries that rely on OpenAPI generators, where generated code is isolated from SDK abstractions. For example, AWS JS SDK v3 (https://github.com/aws/aws-sdk-js-v3) and the Kubernetes JavaScript Client (https://github.com/kubernetes-client/javascript).

The codebase itself remains unchanged for end users. The PR only includes file and folder renames, updated import/export statements, and moving types and helpers into separate files. It does not affect functionality, build process, or user‑facing behavior.

List of changes:
- All generated code now resides in src/open-api/generated, with manual rewrites, additions and export encapsulation control layered on top within src/open-api - a cohesive OpenAPI layer used as a single unit by the rest of the project.
- SDK abstractions formerly under orkes, core, task, and common have been moved into sdk/clients, sdk/createConductorClient, sdk/generators, and sdk/builders.
- The monolithic code was reorganized into helper modules and shared types located at appropriate levels based on reuse.
- Updated related import/export statements (no changes affecting user‑facing behavior).
- Test folder v5-only was removed and all tests were moved into their domain‑specific files without additional structural test separation. Related tests are now selected via environment variable, updated package.json test scripts according to this change.

Author: DmitryBorisov-sm

.github/workflows/pull_request.yml

@@ -23,7 +23,7 @@ jobs:
       fail-fast: false
       matrix:
         node-version: [20, 22, 24]
-        test: ["unit", "integration:v5", "integration:v4"]
+        test: ["unit", "integration:orkes-v5", "integration:orkes-v4"]
     name: Node.js v${{ matrix.node-version }} - ${{ matrix.test }} tests
     steps:
       - name: Checkout

src/common/OPEN-API-README.md OPEN-API-README.mdsrc/common/OPEN-API-README.md renamed to OPEN-API-README.md

@@ -1,13 +1,13 @@
-The client is generated using [this library](https://github.com/hey-api/openapi-ts). Generated code must not be modified directly.
+The open-api layer code is generated using [this library](https://github.com/hey-api/openapi-ts). Generated code (src/open-api/generated) must not be modified directly.
 
 ## Updating generated code
 
 1. Copy OpenApi spec data from up to date cluster `({cluster_url}/api-docs)`
-2. Paste to `open-api-spec/spec.json`
+2. Paste to `src/open-api/spec/spec.json`
 3. Prettify `spec.json`, run command: (todo: should be removed after OpenApi spec fix)
 
 ```text
-node open-api-spec/fix-additional-properties.ts
+node src/open-api/spec/fix-additional-properties.ts
 ```
 
 4. run command:

eslint.config.mjs

@@ -9,7 +9,8 @@ export default defineConfig(
   {
     ignores: [
       "dist/**",
-      "src/common/open-api/**", // OpenAPI auto-generated code
+      "src/open-api/generated/**", // OpenAPI auto-generated code
+      "src/open-api/spec/**", // OpenAPI spec and fix script
       "docs/**",
       "node_modules/**",
     ],

index.ts

@@ -1,5 +1,2 @@
-export * from "./src/task/index";
-export * from "./src/common";
-export * from "./src/core";
-export * from "./src/orkes";
-
+export * from "./src/sdk";
+export * from "./src/open-api";