test(integration): add end-to-end test suite for launch-cli commands

Adds test/integration/ - a harness that runs real oclif commands end to end,
plus 31 specs over launch (GitHub + FileUpload), environments, deployments,
open and rollback. Assertions are on what the CLI does: requests sent, prompts
asked, config file written, stdout and exit code. A refactor passes; a
behaviour change fails with a readable diff.

Also wires test:integration into npm test, narrows the mocha glob to
test/unit/** so mocha stops picking up the jest specs, and adds the eslint and
talisman entries the new files need.

Refs CL-7154. No production code changed.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: SakshiKoli-CS

.talismanrc

@@ -26,4 +26,16 @@ fileignoreconfig:
     - "headers\\?\\.reduce\\(\\(acc, \\{ key, value \\}\\)"
     - "\\(\\{ key, value \\}\\) => \\(\\{ key, value \\}\\)\\)"
     - "const \\{ token, apiKey \\} = configHandler\\.get"
+- filename: test/integration/specs/environments.test.ts
+  checksum: f02e76dc6f4dfac2bc21d53357d70fc2b93c6473b9e71ab08300670f2c5649c1
+- filename: test/integration/jest.setup-env.ts
+  checksum: eede2df0cdbce975a09ea96ed705db42fc9d6c3bdd36266a9be198653957b539
+- filename: test/integration/harness/launch-api.ts
+  checksum: a4549b87c896744422e71ab5395a1d6d2dfa372678d2488aecc4247ee9738f87
+- filename: test/integration/harness/session.ts
+  checksum: 74dc637304710b1df882bea6a1c52b8779f1bd416dbeeab93a9026c68edb3f9e
+- filename: test/integration/specs/launch-github.test.ts
+  checksum: 4b9a39461dc09aa405b66fd3a17b660038c8ca7e6c0446166f938dff3faf0373
+- filename: test/integration/harness/fixtures.ts
+  checksum: b3133a65f3f4b3f3a32caf0cc0bf65b0c71187f96e044a3331ddcce3adea88c1
 version: "1.0"

AGENTS.md

@@ -8,3 +8,28 @@
 - Use only jest for writing test cases and refer existing unit test under the /src folder.
 - Do not create code comments for any changes.
 
+## Integration tests
+
+- Unit tests mock the CLI's own classes, so they keep passing when behaviour changes.
+  Integration tests (`test/integration/`) exist to catch what unit tests cannot: they run a
+  real oclif command end to end and assert on what the CLI *does*.
+- Run them with `npm run test:integration` (they are also part of `npm test`).
+- Only three things are replaced: the terminal prompt (`inquirer`), the `open` package, and
+  the Contentstack management SDK, which resolves its base URL as `https://<host>:443` and so
+  cannot be pointed at a local server. Apollo, the GraphQL documents, the CLI config store,
+  flag parsing, the filesystem and `git` all run for real.
+- The Launch API is a local HTTP server (`test/integration/harness/launch-api.ts`) that the CLI
+  reaches through a temporary region config. It records every GraphQL operation, so tests assert
+  on the operations and variables the CLI actually sent rather than on internal method calls.
+- Assert on the observable contract - operation sequence, request variables, prompt sequence,
+  `.cs-launch.json` contents, stdout, exit code. Never stub a method on a command or adapter;
+  that is what makes these tests survive a refactor and fail on a behaviour change.
+- Register a response for every operation a flow needs and finish with
+  `session.api.assertNoUnhandledOperations()` and `prompts.assertScriptFullyConsumed()`, so a
+  renamed operation or an added prompt fails loudly instead of passing quietly.
+- V2 (epic CL-4867) removes the bare `csdx launch` command in favour of `projects:create`,
+  `environments:create` and `deployments:create`. `launch-github.test.ts` and
+  `launch-file-upload.test.ts` therefore describe behaviour that has to be *ported* to those
+  commands, not a command that survives — read a failure there as "the new command does something
+  different", and repoint the spec rather than deleting the assertion.
+- Tests named after a `CL-` ticket pin a bug that was already fixed once. Do not relax them.

eslint.config.mjs

@@ -40,6 +40,21 @@ export default tseslint.config(
       // test files use @ts-nocheck and scaffolding vars that aren't all referenced
       '@typescript-eslint/ban-ts-comment': 'off',
       '@typescript-eslint/no-unused-vars': 'off',
+      // harness mirrors untyped CLI payloads, and jest.mock factories must use require()
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-require-imports': 'off',
+    },
+  },
+  {
+    files: ['*.config.js'],
+    languageOptions: {
+      sourceType: 'commonjs',
+      globals: {
+        module: 'writable',
+        require: 'readonly',
+        process: 'readonly',
+        __dirname: 'readonly',
+      },
     },
   },
 );

jest.integration.config.js

@@ -0,0 +1,23 @@
+const config = {
+  testEnvironment: 'node',
+  rootDir: '.',
+  testMatch: ['<rootDir>/test/integration/specs/**/*.test.ts'],
+  transform: {
+    '^.+\\.ts$': ['ts-jest', { tsconfig: '<rootDir>/test/integration/tsconfig.json' }],
+    '^.+\\.js$': [
+      'ts-jest',
+      { tsconfig: { allowJs: true, module: 'commonjs', target: 'es2020', esModuleInterop: true } },
+    ],
+  },
+  transformIgnorePatterns: ['/node_modules/(?!uuid/)'],
+  setupFiles: ['<rootDir>/test/integration/jest.setup-env.ts'],
+  setupFilesAfterEnv: ['<rootDir>/test/integration/jest.setup.ts'],
+  maxWorkers: 1,
+  testTimeout: 30000,
+  forceExit: true,
+  coverageDirectory: 'coverage/integration',
+  coverageProvider: 'v8',
+  collectCoverageFrom: ['src/**/*.ts', '!src/test/**', '!src/**/*.test.ts'],
+};
+
+module.exports = config;

package.json

@@ -91,7 +91,7 @@
     "lint-staged": "lint-staged",
     "postpack": "shx rm -f oclif.manifest.json",
     "prepack-bkp": "npm run build && oclif manifest && oclif readme",
-    "test": "mocha --forbid-only \"test/**/*.test.ts\" && npm run test:jest",
+    "test": "mocha --forbid-only \"test/unit/**/*.test.ts\" && npm run test:jest && npm run test:integration",
     "version": "oclif readme && git add README.md",
     "build": "npm run clean && npm run compile",
     "clean": "rm -rf ./dist tsconfig.build.tsbuildinfo",
@@ -101,6 +101,8 @@
     "test:unit": "mocha --forbid-only \"test/unit/**/*.test.ts\" && npm run test:jest",
     "test:unit:report": "nyc --extension .ts mocha --forbid-only \"test/unit/**/*.test.ts\" && npm run test:jest:coverage",
     "test:jest": "jest",
+    "test:integration": "jest --config jest.integration.config.js",
+    "test:integration:coverage": "jest --config jest.integration.config.js --coverage",
     "test:jest:coverage": "jest --coverage",
     "prepare": "husky"
   },

test/integration/harness/cma.ts

@@ -0,0 +1,52 @@
+export type MockOrganization = { uid: string; name: string };
+
+export type RecordedCmaCall = {
+  method: 'organization.fetch' | 'organization.fetchAll';
+  uid?: string;
+  params?: Record<string, any>;
+};
+
+class CmaMock {
+  private organizations: MockOrganization[] = [];
+  private pageSize = 100;
+  private recorded: RecordedCmaCall[] = [];
+
+  reset(): void {
+    this.organizations = [];
+    this.pageSize = 100;
+    this.recorded = [];
+  }
+
+  withOrganizations(organizations: MockOrganization[], pageSize = 100): this {
+    this.organizations = organizations;
+    this.pageSize = pageSize;
+    return this;
+  }
+
+  calls(): RecordedCmaCall[] {
+    return [...this.recorded];
+  }
+
+  client(): Record<string, any> {
+    return {
+      organization: (uid?: string) => ({
+        fetch: async () => {
+          this.recorded.push({ method: 'organization.fetch', uid });
+          const organization = this.organizations.find((candidate) => candidate.uid === uid);
+          if (!organization) throw new Error(`Organization "${uid}" not found`);
+          return organization;
+        },
+        fetchAll: async (params: Record<string, any> = {}) => {
+          this.recorded.push({ method: 'organization.fetchAll', params });
+          const skip = Number(params.skip ?? 0);
+          return {
+            items: this.organizations.slice(skip, skip + this.pageSize),
+            count: this.organizations.length,
+          };
+        },
+      }),
+    };
+  }
+}
+
+export const cma = new CmaMock();